All checks were successful
Build and Release / build-and-test (arm64, alpine) (push) Successful in 13s
Build and Release / build-and-test (amd64, alpine) (push) Successful in 19s
Build and Release / build-and-test (arm64, ubuntu) (push) Successful in 24s
Build and Release / build-and-test (amd64, ubuntu) (push) Successful in 34s
Build and Release / release (push) Has been skipped
254 lines
5.2 KiB
Markdown
254 lines
5.2 KiB
Markdown
# 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 |
|
|
| `--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
|
|
```
|