USAGE.md

使用指南

基本用法

# 启动代理
socks5-proxy config.toml

# 生成默认配置
socks5-proxy --generate-config

配合 proxychains 使用

安装 proxychains

brew install proxychains-ng     # macOS
sudo apt install proxychains4   # Debian/Ubuntu

配置 proxychains

编辑 /etc/proxychains4.conf:

strict_chain
proxy_dns

[ProxyList]
socks5 127.0.0.1 1080

连接数据库

proxychains4 mysql -h db.local -u root -p
proxychains4 redis-cli -h redis.local
proxychains4 psql -h pg.local -U postgres
proxychains4 mongo mongo.local:27017

配合 SSH 隧道使用

在堡垒机场景下：

# 1. 堡垒机上运行代理
socks5-proxy /etc/socks5-proxy/config.toml

# 2. 本地建立 SSH 动态转发
ssh -D 1080 -N -f user@bastion

# 3. 通过代理连接
proxychains4 mysql -h prod-db.local -u root -p

常用别名

添加到 ~/.bashrc 或 ~/.zshrc:

alias prod='ssh -D 1080 -N -f user@bastion'
alias pxy='proxychains4 -q'
alias mysql-prod='pxy mysql -h prod-db.local -u root -p'
alias redis-prod='pxy redis-cli -h prod-redis.local'

故障排查

连接失败:

# 检查代理是否运行
netstat -an | grep 1080

# 检查 SSH 隧道
ps aux | grep "ssh -D"

域名解析失败:

# 确保 proxychains 启用了 proxy_dns
grep proxy_dns /etc/proxychains4.conf

超时:

# 增加超时时间
[proxy]
timeout = 60