ss-tproxy 脚本运行于 Linux 系统(网关、软路由、虚拟机、普通 PC),用于实现 SS/SSR/V2Ray/Socks5 全局透明代理功能。普遍用法是将 ss-tproxy 部署在 Linux 软路由(或位于桥接模式下的 Linux 虚拟机),透明代理内网主机的 TCP、UDP 数据流(具体玩法可参考 ss-tproxy 常见问题)。脚本目前实现了 4 种分流模式:global(全局模式,不分流)、gfwlist(仅代理 gfwlist 域名)、chnonly(仅代理大陆域名,国外翻回国内)、chnroute(绕过大陆地址段,其余均走代理)。脚本目前定义了 15 种代理模式,如下(下文中的“本机”指运行 ss-tproxy 的主机):
mode='v2ray_global' # v2ray global 模式
mode='v2ray_gfwlist' # v2ray gfwlist 模式
mode='v2ray_chnroute' # v2ray chnroute 模式
mode='tproxy_global' # ss/ssr global 模式
mode='tproxy_gfwlist' # ss/ssr gfwlist 模式
mode='tproxy_chnroute' # ss/ssr chnroute 模式
mode='tproxy_global_tcp' # ss/ssr global 模式 (tcponly)
mode='tproxy_gfwlist_tcp' # ss/ssr gfwlist 模式 (tcponly)
mode='tproxy_chnroute_tcp' # ss/ssr chnroute 模式 (tcponly)
mode='tun2socks_global' # socks5 global 模式
mode='tun2socks_gfwlist' # socks5 gfwlist 模式
mode='tun2socks_chnroute' # socks5 chnroute 模式
mode='tun2socks_global_tcp' # socks5 global 模式 (tcponly)
mode='tun2socks_gfwlist_tcp' # socks5 gfwlist 模式 (tcponly)
mode='tun2socks_chnroute_tcp' # socks5 chnroute 模式 (tcponly)
标识了 tcponly
的 mode 表示只代理 tcp 流量(dns 通过 tcp 方式解析),udp 不会被处理,主要用于不支持 udp relay 的 ss/ssr/socks5 代理。除了 tun2socks
mode 外,其它的 mode 均不能代理 ss-tproxy 本机的 udp 流量(dns 会另外处理),tun2socks
mode 之所以能代理本机 udp 是因为它不是依靠 iptables-DNAT/TPROXY 实现的,而是通过策略路由 + tun 虚拟网卡。还有,chnonly
模式并未单独分出来,因为它本质上与 gfwlist
模式完全相同,只不过域名列表不一样而已,所以如果要使用 chnonly
分流模式,请选择对应的 gfwlist
mode(当然还需要几个步骤,后面会说明)。
- ss-tproxy 脚本相关依赖的安装参考
v2ray_global
: v2ray-core, xt_TPROXY, iproute2, dnsmasqv2ray_gfwlist
: v2ray-core, xt_TPROXY, iproute2, ipset, perl, dnsmasqv2ray_chnroute
: v2ray-core, xt_TPROXY, iproute2, ipset, chinadns, dnsmasqtproxy_global
: ss/ssr-libev, haveged, xt_TPROXY, iproute2, dnsmasqtproxy_gfwlist
: ss/ssr-libev, haveged, xt_TPROXY, iproute2, ipset, perl, dnsmasqtproxy_chnroute
: ss/ssr-libev, haveged, xt_TPROXY, iproute2, ipset, chinadns, dnsmasqtproxy_global_tcp
: ss/ssr-libev, haveged, dnsforwardertproxy_gfwlist_tcp
: ss/ssr-libev, haveged, ipset, perl, dnsmasq, dnsforwardertproxy_chnroute_tcp
: ss/ssr-libev, haveged, ipset, chinadns, dnsforwardertun2socks_global
: socks5 代理, tun2socks, iproute2, dnsmasqtun2socks_gfwlist
: socks5 代理, tun2socks, iproute2, ipset, perl, dnsmasqtun2socks_chnroute
: socks5 代理, tun2socks, iproute2, ipset, chinadns, dnsmasqtun2socks_global_tcp
: socks5 代理, tun2socks, iproute2, dnsforwardertun2socks_gfwlist_tcp
: socks5 代理, tun2socks, iproute2, ipset, perl, dnsmasq, dnsforwardertun2socks_chnroute_tcp
: socks5 代理, tun2socks, iproute2, ipset, chinadns, dnsforwarder- haveged 依赖项是可选的,主要用于防止系统的熵过低,从而导致 ss-redir、ss-tunnel、ss-local 启动失败等问题
*gfwlist*
模式更新列表时依赖 curl、base64;*chnroute*
模式更新列表时依赖 curl;建议安装,以备不时之需*gfwlist*
模式中的 perl 其实可以使用 sed 替代,但由于更新 gfwlist 列表依赖 perl5 v5.10.0+,所以直接用了 perl- tun2socks 依赖
net-tools
包中的ifconfig
命令,如果启动 tun2socks 失败,可能是没有安装net-tools
的原因
- 请确保相关端口未被其它进程占用,如果有请自行解决
v2ray_global
: dnsmasq=53/udpv2ray_gfwlist
: dnsmasq=53/udpv2ray_chnroute
: chinadns=65353/udp, dnsmasq=53/udptproxy_global
: ss-redir=60080/tcp+udp, ss-tunnel=60053/udp, dnsmasq=53/udptproxy_gfwlist
: ss-redir=60080/tcp+udp, ss-tunnel=60053/udp, dnsmasq=53/udptproxy_chnroute
: ss-redir=60080/tcp+udp, ss-tunnel=60053/udp, chinadns=65353/udp, dnsmasq=53/udptproxy_global_tcp
: ss-redir=60080/tcp, dnsforwarder=53/udptproxy_gfwlist_tcp
: ss-redir=60080/tcp, dnsforwarder=60053/udp, dnsmasq=53/udptproxy_chnroute_tcp
: ss-redir=60080/tcp, dnsforwarder=60053/udp, chinadns=65353/udp, dnsforwarder=53/udptun2socks_global
: dnsmasq=53/udptun2socks_gfwlist
: dnsmasq=53/udptun2socks_chnroute
: chinadns=60053/udp, dnsmasq=53/udptun2socks_global_tcp
: dnsforwarder=53/udptun2socks_gfwlist_tcp
: dnsforwarder=60053/udp, dnsmasq=53/udptun2socks_chnroute_tcp
: dnsforwarder=60053/udp, chinadns=65353/udp, dnsforwarder=53/udp
安装
git clone https://github.com/zfl9/ss-tproxy.git
cd ss-tproxy
cp -af ss-tproxy /usr/local/bin
chmod 0755 /usr/local/bin/ss-tproxy
chown root:root /usr/local/bin/ss-tproxy
mkdir -m 0755 -p /etc/tproxy
cp -af ss-tproxy.conf gfwlist.* chnroute.* /etc/tproxy
chmod 0644 /etc/tproxy/* && chown -R root:root /etc/tproxy
卸载
ss-tproxy stop
rm -fr /etc/tproxy /usr/local/bin/ss-tproxy
简介
ss-tproxy
:脚本文件ss-tproxy.conf
:配置文件ss-tproxy.service
:服务文件gfwlist.txt
:gfwlist 域名文件,不可配置gfwlist.ext
:gfwlsit 黑名单文件,可配置chnroute.set
:chnroute for ipset,不可配置chnroute.txt
:chnroute for chinadns,不可配置
配置
- 脚本的配置文件为
/etc/tproxy/ss-tproxy.conf
,修改后重启脚本才能生效 - 默认模式为
tproxy_chnroute
,这也是 v1 版本中的模式,根据你的需要更改 - 如果使用
v2ray*
模式,则修改v2ray 配置
段中的相关 V2Ray 客户端的信息 - 如果使用
tproxy*
模式,则修改ss/ssr 配置
段中的相关 SS/SSR 服务器信息 - 如果使用
tun2socks*
模式,则修改socks5 配置
段中的相关 socks5 代理信息 dns_remote
为远程 DNS 服务器(走代理),默认为 Google DNS,根据需要修改dns_direct
为直连 DNS 服务器(走直连),默认为 114 公共DNS,根据需要修改iptables_intranet
指定要代理的内网网段,默认为 192.168.0.0/16,根据需要修改- 如需配置 gfwlist 黑名单,请编辑
/etc/tproxy/gfwlist.ext
,修改后需重启脚本生效
如果你需要使用 chnonly 模式(国外翻进国内),请选择 *gfwlist*
代理模式,比如 tproxy_gfwlist
。chnonly 模式下,你必须修改 ss-tproxy.conf 中的 dns_remote
为国内的 DNS,如 dns_remote='114.114.114.114:53'
,并将 dns_direct
改为本地 DNS(国外的),如 dns_direct='8.8.8.8'
;因为 chnonly 模式与 gfwlist 模式共享 gfwlist.txt、gfwlist.ext 文件,所以在第一次使用时你必须先运行 ss-tproxy update-chnonly
将默认的 gfwlist.txt 内容替换为大陆域名(更新列表时,也应使用 ss-tproxy update-chnonly
),并且注释掉 gfwlist.ext 中的 Telegram IP 段,因为这是为正常翻墙设置的,反之亦然。
如果使用 v2ray 模式,你必须配置 v2ray 客户端的 dokodemo-door
传入协议,并且需要两个 dokodemo-door
配置,一个用于实现类似 ss-redir 的透明代理,另一个用于实现类似 ss-tunnel 的端口转发(解析 DNS)。具体配置可参考(原有的 inbound 可以不动,通常该 inbound 是一个 socks5 传入协议,你只要保证不同的 inbound 的监听端口不冲突就行):
{
"inbound": { ... },
"inboundDetour": [
// as ss-redir
{
"port": 60080,
"protocol": "dokodemo-door",
"settings": {
"network": "tcp,udp",
"followRedirect": true,
"domainOverride": ["quic"]
}
},
// as ss-tunnel
{
"port": 60053,
"protocol": "dokodemo-door",
"settings": {
"address": "8.8.8.8",
"port": 53,
"network": "udp",
"followRedirect": false
}
},
...
],
"outbound": { ... },
"outboundDetour": [ ... ],
"routing": { ... }
}
自启(Systemd)
mv -f ss-tproxy.service /etc/systemd/system
systemctl daemon-reload
systemctl enable ss-tproxy.service
自启(SysVinit)
touch /etc/rc.d/rc.local
chmod +x /etc/rc.d/rc.local
echo '/usr/local/bin/ss-tproxy start' >>/etc/rc.d/rc.local
如果 ss-tproxy 主机使用 PPPoE 拨号上网(或其它耗时较长的方式),配置自启后,可能导致 ss-tproxy 在网络还未完全准备好的情况下先运行。此时如果 ss-tproxy.conf 中的 v2ray_server
、socks5_remote
、server_addr
为域名,则会导致 ss-tproxy 启动失败(甚至卡一段时间,因为它一直在尝试解析这些域名,直到超时为止)。要恢复正常的代理,只能在启动完成后手动进行 ss-tproxy restart
。如果你想避免这种情况,请尽量将 ss-tproxy.conf 中的 v2ray_server
、socks5_remote
、server_addr
替换为 IP 形式,或者将这些域名添加到 ss-tproxy 主机的 /etc/hosts 文件,如果你和我一样使用的 ArchLinux,那么最好的解决方式就是利用 netctl 的 hook 启动 ss-tproxy(如拨号成功后再启动 ss-tproxy),具体配置可参考 Arch 官方文档。
用法
ss-tproxy help
:查看帮助ss-tproxy start
:启动代理ss-tproxy stop
:关闭代理ss-tproxy restart
:重启代理ss-tproxy status
:代理状态ss-tproxy check-depend
:检查依赖ss-tproxy flush-cache
:清空 DNS 缓存ss-tproxy flush-gfwlist
:清空 ipset-gfwlist IP 列表ss-tproxy update-gfwlist
:更新 gfwlist(restart 生效)ss-tproxy update-chnonly
:更新 chnonly(restart 生效)ss-tproxy update-chnroute
:更新 chnroute(restart 生效)ss-tproxy dump-ipts
:显示 iptables 的 mangle、nat 表规则ss-tproxy flush-ipts
:清空 raw、mangle、nat、filter 表规则
ss-tproxy flush-gfwlist
的作用:因为 *gfwlist*
模式下 ss-tproxy restart
、ss-tproxy stop; ss-tproxy start
不会清空 ipset-gfwlist
列表,如果你进行了 ss-tproxy update-gfwlist
、ss-tproxy update-chnonly
操作,或修改了 /etc/tproxy/gfwlist.ext
文件,建议在 start 前执行一下此步骤,防止因为之前遗留的 ipset-gfwlist 列表导致稀奇古怪的问题。注意,如果执行了 ss-tproxy flush-gfwlist
那么你可能需要清空内网主机的 dns 缓存,并重启浏览器等被代理的应用。
日志
脚本默认关闭了日志输出,如果需要,请修改 ss-tproxy.conf,打开相应的 log/verbose 选项
- ss-redir:
/var/log/ss-redir.log
- ss-tunnel:
/var/log/ss-tunnel.log
- tun2socks:
/var/log/tun2socks.log
- dnsmasq:
/var/log/dnsmasq.log
- chinadns:
/var/log/chinadns.log
- dnsforwarder:
/var/log/dnsforwarder.log
- v2ray 模式下,在 Android 中访问部分 Google 网站不是很稳定,其根本原因是因为 v2ray 的
dokodemo-door
传入协议对 Google 开发的 QUIC(Quick UDP Internet Connections)协议支持不好导致的,虽然我已经在dokodemo-door
中配置了"domainOverride": ["quic"]
(讨论此问题的 Issue:v2ray/v2ray-core#819),但是测试后还是发现domainOverride
效果不是很好,一会可以一会又不可以,并且 Google Play 的加载速度明显比其它类型的代理慢了许多。目前的解决方案有两个:一是使用 redsocks 对 v2ray 的 socks5 inbound 进行透明转发;二是使用脚本自带的 tun2socks 模式对 v2ray 的 socks5 inbound 进行透明转发(推荐此方式)。当然最好的解决方式还是希望 v2ray 官方能够解决此问题,虽然目前只有部分 Google 的网站启用了 QUIC,但是随着时间的推移,启用 QUIC 的网站肯定会更多,这个问题也会越严重!
- 内网主机黑名单(全走代理)、白名单(全走直连)支持,方便部分游戏用户
- 精简 ss-tproxy 脚本,特别是
check_depend
、start_dns
、status
这几个函数