添加 XXXigCC Pool URL 更新功能和完整文档系统

This commit is contained in:
2025-12-16 13:24:15 +08:00
parent 167fad20eb
commit dc518995f3
8 changed files with 557 additions and 58 deletions

View File

@@ -0,0 +1,43 @@
# 如何更新 XXXigCC 的 Pool URL
## 1. 准备工作
在更新 XXXigCC 的 Pool URL 之前,请确保:
- 已安装 Ansible
- 已安装 `jq` 工具
- 有权限修改 `/etc/xxxigcc/config.json`
- 有权限重启 `xxxigcc-daemon.service`
## 2. 更新步骤
1. **准备变量文件**
创建一个 `xxxigcc_update_vars.yml` 文件,包含以下关键变量:
```yaml
new_pool_url: "https://new-pool.example.com"
# 可选:验证旧 URL如需
old_pool_url: "https://old-pool.example.com"
```
2. **执行 Playbook**
```bash
ansible-playbook xxxigcc_update_pool_url.yaml -e @xxxigcc_update_vars.yml
```
## 3. 操作说明
- Playbook 将自动备份原始配置文件
- 更新 `pools[0].url` 字段
- 清理 `/var/log/xxxigcc` 目录下的日志文件
- 重启 `xxxigcc-daemon.service`
## 4. 故障排除
- 如果更新失败,检查:
1. 变量文件格式
2. URL 地址正确性
3. 系统权限
## 5. 安全注意事项
- 仅在可信环境中执行此 Playbook
- 谨慎使用 `old_pool_url` 参数