| name | proxychains |
| description | Auto-detect network issues and force proxy usage with proxychains4. Use this skill when encountering connection timeouts, DNS failures, or blocked network access. Default proxy is http://127.0.0.1:9910 |
Proxychains Network Proxy Skill
自动使用代理解决网络问题 - 当遇到网络连接失败、超时或访问受限时，自动使用 proxychains4 强制走代理。
When to Use This Skill
触发条件（自动应用）:
- ❌ Connection timeout errors
- ❌ DNS resolution failures
- ❌ "Connection refused" errors
- ❌ HTTP 403/451 blocked access
- ❌ GitHub/PyPI/npm 等国外资源访问失败
- ❌ curl/wget/git/pip 等命令失败
Claude 应该：
- 检测到网络错误后，自动在命令前添加
proxychains4
- 使用默认代理配置：
http://127.0.0.1:9910
- 如果代理失败，提示用户检查代理服务状态
Quick Reference
基本用法模式
curl https://github.com/user/repo
proxychains4 curl https://github.com/user/repo
常见场景自动应用
场景 1: Git 操作失败
git clone https://github.com/user/repo.git
proxychains4 git clone https://github.com/user/repo.git
场景 2: Python pip 安装失败
pip install requests
proxychains4 pip install requests
场景 3: npm/yarn 安装失败
npm install package-name
proxychains4 npm install package-name
场景 4: wget/curl 下载失败
wget https://example.com/file.tar.gz
proxychains4 wget https://example.com/file.tar.gz
场景 5: Docker 拉取镜像失败
docker pull image:tag
proxychains4 docker pull image:tag
场景 6: SSH 连接失败
ssh user@remote-host
proxychains4 ssh user@remote-host
配置详情
默认代理配置
本地代理地址： http://127.0.0.1:9910
配置文件位置：
~/.proxychains/proxychains.conf (推荐)/etc/proxychains.conf (系统级)
快速配置脚本
创建用户级配置（自动使用 127.0.0.1:9910）：
mkdir -p ~/.proxychains
cat > ~/.proxychains/proxychains.conf << 'EOF'
strict_chain
proxy_dns
remote_dns_subnet 224
tcp_read_time_out 15000
tcp_connect_time_out 8000
[ProxyList]
http 127.0.0.1 9910
EOF
环境变量方式（临时使用）
export PROXYCHAINS_SOCKS5_HOST=127.0.0.1
export PROXYCHAINS_SOCKS5_PORT=9910
proxychains4 curl https://github.com
工作原理
Proxychains 通过 LD_PRELOAD 机制拦截程序的网络调用：
- 拦截系统调用：Hook socket 相关的 libc 函数
- 重定向连接：将所有 TCP 连接重定向到代理服务器
- DNS 代理：通过代理服务器解析域名
- 透明代理：应用程序无需修改
重要限制：
- 只支持动态链接的程序（statically linked 程序不支持）
- 只支持 TCP 连接（UDP 不支持）
- 部分使用特殊网络库的程序可能不兼容
Claude 自动化规则
规则 1: 网络错误自动重试
IF 命令返回网络相关错误（timeout, connection refused, DNS failure）
THEN 自动使用 proxychains4 重试该命令
规则 2: 已知慢速源强制代理
IF 访问以下域名/服务：
- github.com
- raw.githubusercontent.com
- pypi.org
- npmjs.org
- registry.npmjs.org
- docker.io
- gcr.io
THEN 直接使用 proxychains4（不等待失败）
规则 3: 失败提示
IF proxychains4 命令也失败
THEN 提示用户：
1. 检查代理服务是否运行（127.0.0.1:9910）
2. 检查 proxychains 配置文件
3. 尝试其他代理地址
故障排除
检查代理服务状态
curl -x http://127.0.0.1:9910 https://www.google.com
netstat -tunlp | grep 9910
ss -tunlp | grep 9910
验证 proxychains 配置
proxychains4 curl https://ipinfo.io/json
常见错误处理
错误 1: "proxychains: command not found"
sudo apt install proxychains4
sudo yum install proxychains-ng
错误 2: "timeout"
cat ~/.proxychains/proxychains.conf | grep -A 2 "\[ProxyList\]"
tcp_connect_time_out 15000
tcp_read_time_out 30000
错误 3: "can't read configuration file"
mkdir -p ~/.proxychains
cp /etc/proxychains.conf ~/.proxychains/proxychains.conf
高级用法
多代理链
# ~/.proxychains/proxychains.conf
strict_chain # 按顺序使用所有代理
[ProxyList]
http 127.0.0.1 9910
socks5 127.0.0.1 1080
动态代理链
dynamic_chain # 自动跳过死代理
[ProxyList]
http 127.0.0.1 9910
http 127.0.0.1 8080
socks5 127.0.0.1 1080
随机代理链
random_chain
chain_len = 2 # 随机选择 2 个代理
[ProxyList]
http 127.0.0.1 9910
socks5 127.0.0.1 1080
socks5 127.0.0.1 1081
自定义 DNS 服务器
export PROXY_DNS_SERVER=8.8.8.8
proxychains4 curl https://example.com
参考资源
总结
记住这些原则：
- ❌ 遇到网络错误 → ✅ 自动加上
proxychains4
- 🌐 访问国外资源 → ✅ 主动使用
proxychains4
- 🔧 代理也失败 → ✅ 提示用户检查代理服务
默认代理: http://127.0.0.1:9910
这个技能让 Claude 在遇到网络问题时自动使用代理，无需用户手动干预！
