⚠️ 安全声明
本 Skill 安全透明,代码全部可审计:
- ✅ 只追加内容到
/etc/hosts(追加,不覆盖原有内容) - ✅ 不安装任何系统包或服务
- ✅ 不修改任何系统配置
- ✅ 不运行后台守护进程
- ✅ 不访问用户数据
- ✅ 每次更新自动备份 hosts(
/etc/hosts.backup_*) - ✅ 一键回滚:
python3 scripts/rollback.py - ✅ 纯 Python,无外部依赖(仅需系统自带工具)
- ✅ 所有变更记录在
/tmp/github-hosts-optimizer.log
关于 /etc/hosts 修改: 这是 Linux/Unix 标准操作,用于 DNS 解析,覆盖面积极小(仅影响 GitHub CDN 域名),完全可逆。
GitHub Hosts Optimizer
自动优化中国大陆服务器访问 GitHub 的 DNS 解析,破解限流/超时。
一键优化
sudo python3 /root/.openclaw/workspace/skills/github-hosts-optimizer/scripts/update_hosts.py
工作原理
- 从多个可信源获取 GitHub CDN 当前最优 IP(DNS 探测 + 测速)
- 备份当前 hosts 文件
- 追加/更新 GitHub 相关条目到
/etc/hosts - 验证连通性
IP 来源
- GitHub 官方公告 IP
- CDNNS / IPAddress.com 等 DNS 探测服务
- Cloudflare / Fastly 官方 IP 段
脚本使用
# 完整更新(测速选最优)
python3 scripts/update_hosts.py
# 仅添加静态条目(不测速)
python3 scripts/update_hosts.py --static-only
# 回滚到上次备份
python3 scripts/rollback.py
# 检查当前连通性
python3 scripts/check_connectivity.py
自动更新 Cron
默认每2小时自动运行一次,确保持续有效:
cron add github-hosts-optimizer
已知最优 IP(静态备用)
140.82.113.3 github.com
185.199.108.153 assets-cdn.github.com
199.232.69.194 github.global.ssl.fastly.net
140.82.112.0/22 github.works
注意:IP 地址会变动,
--static-only模式可能失效,建议使用完整测速模式。
详细说明
- 测速原理:对多个候选 IP 并发 curl 测速,选择延迟最低的
- 备份位置:
/etc/hosts.backup.{timestamp} - 回滚命令:
scripts/rollback.py - 日志:
/tmp/github-hosts-optimizer.log
