# XXXigCC 安装脚本

本目录包含 XXXigCC 的安装和卸载脚本。

## 脚本列表

### 1. install.sh - 通用安装脚本
从 Gitea Generic Package Registry 下载 tar.gz 包并安装。

**支持系统:**
- Alpine Linux (OpenRC)
- Ubuntu/Debian (systemd)

**使用方法:**
```bash
# 基本安装
sudo ./install.sh -o pool.example.com:3333 -w YOUR_WALLET_ADDRESS

# 指定版本和线程数
sudo ./install.sh -v 3.4.6-xg1 -t 4 -o pool.example.com:3333 -w YOUR_WALLET

# 启用高级功能
sudo ./install.sh -o pool.example.com:3333 -w YOUR_WALLET \
  --1gb-pages --tls --keepalive \
  --cc --cc-url http://server:3344 --cc-token YOUR_TOKEN
```

### 2. install.deb.sh - DEB 包安装脚本
通过 APT 仓库直接安装。

**支持系统:**
- Ubuntu/Debian (systemd)

**使用方法:**
```bash
# 基本安装
sudo ./install.deb.sh -o pool.example.com:3333 -w YOUR_WALLET_ADDRESS

# 指定版本
sudo ./install.deb.sh -v 3.4.6-xg1 -o pool.example.com:3333 -w YOUR_WALLET

# 查看可用版本
apt-cache policy xxxigcc
```

### 3. uninstall.sh - 卸载脚本
通用卸载脚本，自动检测安装方式。

**使用方法:**
```bash
# 交互式卸载（推荐）
sudo ./uninstall.sh

# 直接卸载，不确认
sudo ./uninstall.sh -y

# 完全清除（包括配置文件和日志）
sudo ./uninstall.sh --purge -y
```

## 命令行参数

### 通用参数（两种安装脚本都支持）

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `-v, --version` | 版本号 | latest |
| `-t, --threads` | 线程数 | 自动 (CPU 核心数) |
| `-a, --algo` | 算法 | rx/0 |
| `-o, --pool` | 矿池地址 | **必需** |
| `-w, --wallet` | 钱包地址 | 自动生成 |
| `-p, --password` | 矿池密码 | 自动生成 |
| `--1gb-pages` | 启用 1GB 大页 | false |
| `--tls` | 启用 TLS | false |
| `--keepalive` | 启用 KeepAlive | false |
| `--daemon` | 启用 SOLO 挖矿 | false |
| `--nicehash` | 启用 NiceHash 模式 | **true** |
| `--verbose` | 启用详细输出 | **true** |
| `--submit-to-origin` | 提交到原始矿池 | false |
| `--self-select` | 自选矿池地址 | - |
| `--cc` | 启用 CC | false |
| `--cc-url` | CC 服务器地址 | - |
| `--cc-work-id` | CC 工作 ID | 自动生成 |
| `--cc-token` | CC 访问令牌 | - |
| `--cc-tls` | 启用 CC TLS | false |

## 安装路径

### tar.gz 安装
```
/etc/miner/xxxigcc/
├── config.json          # 配置文件
├── xxxigDaemon          # 守护进程
├── xxxigMiner           # 挖矿程序
└── xxxigcc.log          # 日志文件
```

**服务文件:**
- Alpine: `/etc/init.d/xxxigcc`
- Ubuntu/Debian: `/etc/systemd/system/xxxigcc.service`

### DEB 包安装
```
/etc/xxxigcc/
└── config.json          # 配置文件

/var/log/xxxigcc/        # 日志目录

/opt/xxxigcc/
├── xxxigDaemon          # 守护进程
├── xxxigMiner           # 挖矿程序
└── xxxigServer          # 控制服务器
```

**服务文件:**
- `/etc/systemd/system/xxxigcc-daemon.service`
- `/etc/systemd/system/xxxigcc-server.service`

## 服务管理

### Alpine Linux
```bash
# 查看状态
rc-service xxxigcc status

# 启动/停止/重启
rc-service xxxigcc start
rc-service xxxigcc stop
rc-service xxxigcc restart

# 查看日志
tail -f /etc/miner/xxxigcc/xxxigcc.log
```

### Ubuntu/Debian

#### tar.gz 安装
```bash
# 查看状态
systemctl status xxxigcc

# 启动/停止/重启
systemctl start xxxigcc
systemctl stop xxxigcc
systemctl restart xxxigcc

# 查看日志
journalctl -u xxxigcc -f
```

#### DEB 包安装
```bash
# 查看状态
systemctl status xxxigcc-daemon

# 启动/停止/重启
systemctl start xxxigcc-daemon
systemctl stop xxxigcc-daemon
systemctl restart xxxigcc-daemon

# 查看日志
journalctl -u xxxigcc-daemon -f
```

## 配置文件

配置文件为 JSON 格式，位于：
- tar.gz: `/etc/miner/xxxigcc/config.json`
- DEB: `/etc/xxxigcc/config.json`

修改配置后需要重启服务：
```bash
# Alpine
rc-service xxxigcc restart

# Ubuntu/Debian (tar.gz)
systemctl restart xxxigcc

# Ubuntu/Debian (DEB)
systemctl restart xxxigcc-daemon
```

## 升级版本

### tar.gz 安装
重新运行安装脚本，指定新版本：
```bash
sudo ./install.sh -v 3.4.7-xg1 -o pool.example.com:3333 -w YOUR_WALLET
```

### DEB 包安装
使用 APT 升级：
```bash
sudo apt-get update
sudo apt-get install xxxigcc
```

## 故障排查

### 检查服务状态
```bash
# Alpine
rc-service xxxigcc status

# Ubuntu/Debian
systemctl status xxxigcc  # 或 xxxigcc-daemon
```

### 查看日志
```bash
# Alpine / tar.gz
tail -f /etc/miner/xxxigcc/xxxigcc.log

# Ubuntu/Debian (tar.gz)
journalctl -u xxxigcc -f

# Ubuntu/Debian (DEB)
journalctl -u xxxigcc-daemon -f
```

### 手动测试
```bash
# tar.gz 安装
/etc/miner/xxxigcc/xxxigDaemon -c /etc/miner/xxxigcc/config.json

# DEB 包安装
xxxigDaemon -c /etc/xxxigcc/config.json
```

### 常见问题

**问题: 下载失败**
```bash
# 检查网络连接
curl -I https://gitea.bcde.io

# 手动下载测试
curl -O https://gitea.bcde.io/api/packages/wangdefa/generic/xxxigcc/3.4.6-xg1/xxxigcc-amd64-ubuntu-3.4.6-xg1.tar.gz
```

**问题: 服务无法启动**
```bash
# 检查配置文件
cat /etc/miner/xxxigcc/config.json | jq .

# 检查权限
ls -la /etc/miner/xxxigcc/
```

**问题: APT 更新失败 (DEB)**
```bash
# 清理并重新添加源
sudo rm /etc/apt/sources.list.d/xxxigcc.list
sudo ./install_deb.sh -o pool.example.com:3333 -w YOUR_WALLET
```