Proxychains Network Fallback

What it does

When your agent uses it

• Commands fail with connection timeouts or DNS errors
• Access to GitHub, PyPI or npm is blocked or very slow
• Setting up proxychains4 with a local proxy

Example prompts

• “git clone keeps timing out. Retry it through proxychains.”
• “pip install fails with a connection error. Use the proxy and retry.”
• “Set up proxychains4 to use my local proxy on port 9910.”

Requirements

• proxychains4 installed
• A local proxy service, by default at 127.0.0.1:9910

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1检测到网络错误后，自动在命令前添加 proxychains4
2. 2使用默认代理配置：http://127.0.0.1:9910
3. 3如果代理失败，提示用户检查代理服务状态

What it can do on your machine

Read from SKILL.md and the folder at commit 9b42dd1. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Shell), which the agent can run.

  Shell commands in SKILL.md call:

  • curl
  • git
  • pip
  • npm
  • wget
  • docker
  • ssh
  • apt
  • yum

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • github.com
  • google.com
  • ipinfo.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proxychains Network Fallback loads about 1.1k tokens when it runs, and up to ~9k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 178 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~53

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteRuns commands with sudoSKILL.md:207

  sudo apt install proxychains4  # Debian/Ubuntu

• NoteRuns commands with sudoSKILL.md:208

  sudo yum install proxychains-ng  # CentOS/RHEL

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from 2025Emma/vibe-coding-cn at commit 9b42dd1, republished under its MIT licence (© 2025Emma). 178 words, ~1,149 tokens.

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

# ❌ 原命令失败
curl https://github.com/user/repo

# ✅ 使用代理重试
proxychains4 curl https://github.com/user/repo

# 原命令
git clone https://github.com/user/repo.git

# 自动改为
proxychains4 git clone https://github.com/user/repo.git

# 原命令
pip install requests

# 自动改为
proxychains4 pip install requests

# 原命令
npm install package-name

# 自动改为
proxychains4 npm install package-name

# 原命令
wget https://example.com/file.tar.gz

# 自动改为
proxychains4 wget https://example.com/file.tar.gz

# 原命令
docker pull image:tag

# 自动改为
proxychains4 docker pull image:tag

# 原命令
ssh user@remote-host

# 自动改为
proxychains4 ssh user@remote-host

mkdir -p ~/.proxychains
cat > ~/.proxychains/proxychains.conf << 'EOF'
# Proxychains configuration
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

IF 命令返回网络相关错误（timeout, connection refused, DNS failure）
THEN 自动使用 proxychains4 重试该命令

IF 访问以下域名/服务：
  - github.com
  - raw.githubusercontent.com
  - pypi.org
  - npmjs.org
  - registry.npmjs.org
  - docker.io
  - gcr.io
THEN 直接使用 proxychains4（不等待失败）

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

# 测试配置是否正确
proxychains4 curl https://ipinfo.io/json
# 应该显示代理服务器的 IP，而不是本机 IP

# 安装 proxychains4
sudo apt install proxychains4  # Debian/Ubuntu
sudo yum install proxychains-ng  # CentOS/RHEL

# 检查代理地址配置是否正确
cat ~/.proxychains/proxychains.conf | grep -A 2 "\[ProxyList\]"

# 修改超时时间（在配置文件中）
tcp_connect_time_out 15000
tcp_read_time_out 30000

# 创建配置文件
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

© 2025Emma, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in i18n/zh/skills/proxychains of 2025Emma/vibe-coding-cn.

• SKILL.md
• references/index.md
• references/proxychains.conf
• references/quick-reference.md
• references/setup-guide.md
• references/troubleshooting.md
• scripts/setup-proxy.sh

Open the folder on GitHubat commit 9b42dd1

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in 2025Emma/vibe-coding-cn, which our catalogue first saw on October 7, 2026.

• aiskillstore/marketplaceskills/2025emma/proxychains