初始化 XXXig 打包部署脚本与 CI 流水线

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

script/README.md

@@ -0,0 +1,255 @@
+# XXXig 安装脚本
+
+本目录包含 XXXig 的安装和卸载脚本。
+
+## 脚本列表
+
+### 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 6.26.0 -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 6.26.0 -o pool.example.com:3333 -w YOUR_WALLET
+
+# 查看可用版本
+apt-cache policy xxxig
+```
+
+### 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/xxxig/
+├── config.json          # 配置文件
+├── xxxigDaemon          # 守护进程
+├── xxxig               # 挖矿程序
+└── xxxig.log          # 日志文件
+```
+
+**服务文件:**
+- Alpine: `/etc/init.d/xxxig`
+- Ubuntu/Debian: `/etc/systemd/system/xxxig.service`
+
+### DEB 包安装
+```
+/etc/xxxig/
+└── config.json          # 配置文件
+
+/var/log/xxxig/        # 日志目录
+
+/opt/xxxig/
+├── xxxigDaemon          # 守护进程
+├── xxxig                # 挖矿程序
+└── xxxigServer          # 控制服务器
+```
+
+**服务文件:**
+- `/etc/systemd/system/xxxig-daemon.service`
+- `/etc/systemd/system/xxxig-server.service`
+
+## 服务管理
+
+### Alpine Linux
+```bash
+# 查看状态
+rc-service xxxig status
+
+# 启动/停止/重启
+rc-service xxxig start
+rc-service xxxig stop
+rc-service xxxig restart
+
+# 查看日志
+tail -f /etc/miner/xxxig/xxxig.log
+```
+
+### Ubuntu/Debian
+
+#### tar.gz 安装
+```bash
+# 查看状态
+systemctl status xxxig
+
+# 启动/停止/重启
+systemctl start xxxig
+systemctl stop xxxig
+systemctl restart xxxig
+
+# 查看日志
+journalctl -u xxxig -f
+```
+
+#### DEB 包安装
+```bash
+# 查看状态
+systemctl status xxxig-daemon
+
+# 启动/停止/重启
+systemctl start xxxig-daemon
+systemctl stop xxxig-daemon
+systemctl restart xxxig-daemon
+
+# 查看日志
+journalctl -u xxxig-daemon -f
+```
+
+## 配置文件
+
+配置文件为 JSON 格式，位于：
+- tar.gz: `/etc/miner/xxxig/config.json`
+- DEB: `/etc/xxxig/config.json`
+
+修改配置后需要重启服务：
+```bash
+# Alpine
+rc-service xxxig restart
+
+# Ubuntu/Debian (tar.gz)
+systemctl restart xxxig
+
+# Ubuntu/Debian (DEB)
+systemctl restart xxxig-daemon
+```
+
+## 升级版本
+
+### tar.gz 安装
+重新运行安装脚本，指定新版本：
+```bash
+sudo ./install.sh -v 6.26.0 -o pool.example.com:3333 -w YOUR_WALLET
+```
+
+### DEB 包安装
+使用 APT 升级：
+```bash
+sudo apt-get update
+sudo apt-get install xxxig
+```
+
+## 故障排查
+
+### 检查服务状态
+```bash
+# Alpine
+rc-service xxxig status
+
+# Ubuntu/Debian
+systemctl status xxxig  # 或 xxxig-daemon
+```
+
+### 查看日志
+```bash
+# Alpine / tar.gz
+tail -f /etc/miner/xxxig/xxxig.log
+
+# Ubuntu/Debian (tar.gz)
+journalctl -u xxxig -f
+
+# Ubuntu/Debian (DEB)
+journalctl -u xxxig-daemon -f
+```
+
+### 手动测试
+```bash
+# tar.gz 安装
+/etc/miner/xxxig/xxxigDaemon -c /etc/miner/xxxig/config.json
+
+# DEB 包安装
+xxxigDaemon -c /etc/xxxig/config.json
+```
+
+### 常见问题
+
+**问题: 下载失败**
+```bash
+# 检查网络连接
+curl -I https://gitea.bcde.io
+
+# 手动下载测试
+curl -O https://gitea.bcde.io/api/packages/wangdefa/generic/xxxig/6.26.0/xxxig-amd64-ubuntu-6.26.0.tar.gz
+```
+
+**问题: 服务无法启动**
+```bash
+# 检查配置文件
+cat /etc/miner/xxxig/config.json | jq .
+
+# 检查权限
+ls -la /etc/miner/xxxig/
+```
+
+**问题: APT 更新失败 (DEB)**
+```bash
+# 清理并重新添加源
+sudo rm /etc/apt/sources.list.d/xxxig.list
+sudo ./install_deb.sh -o pool.example.com:3333 -w YOUR_WALLET
+```