The command client of Shadowsocksr based Python3

在命令行下使用的一款Shadowsocksr客户端

特性

• 全新2.0版本，在1.0基础上进行使用面向对象重构，并预留接口
• 支持Linux + Windows双平台
• 支持Shadowsocksr链接解析
• 支持Shadowsocksr订阅链接解析(支持添加多个订阅地址)
• 支持制定本地端口启动代理
• 支持测试Shadowsocksr节点真连接延迟(多线程)
• 支持测试Shadowsocksr节点是否被tcp阻断(多线程)
• 支持Shadowsocksr节点测速(上传+下载)
• 支持打印Shadowsocksr节点Json和二维码
• 整合Shadowsocksr源码到项目中
• 支持生成基础版clash配置文件
• 支持开启本地http pac代理服务
• 暂时不支持ipv6Shadowsocksr节点，解析时会默认屏蔽

安装方式

• 源码安装

git clone https://github.com/TyrantLucifer/ssr-command-client.git
cd ssr-command-client
python(python3) setup.py install

• pip安装

pip(pip3) install shadowsocksr-cli

使用方法

usage: shadowsocksr-cli [-h] [-l] [-p local_port] [-s ssr_id] [-S [ssr_id]]
                        [-u] [-v] [--generate-clash] [--display-json ssr_id]
                        [--test-speed ssr_id] [--fast-node]
                        [--setting-url ssr_subscribe_url]
                        [--setting-address ssr_local_address] [--list-url]
                        [--add-url ssr_subscribe_url]
                        [--remove-url ssr_subscribe_url] [--list-address]
                        [--parse-url ssr_url] [--add-ssr ssr_url]
                        [--test-again ssr_node_id]
                        [--http action[start stop status]] [--http-port port]
                        [--print-qrcode ssr_node_id] [--setting-global-proxy]
                        [--setting-pac-proxy] [--close-system-proxy]
Shadowsocksr 命令行客户端

optional arguments:
  -v, --version         版本信息
  -h, --help            帮助信息

通用参数:

-l --list "show ssr list" 打印当前节点列表

-p --port PORT 指定端口，通常与 -s --start 一起使用

-s SSR_NODE_ID 启动Shadowsocks代理，SSR_NODE_ID为节点ID，可从打印列表中获得；
               如果不指定 -p 参数，那么默认代理启动在本地1080端口

-S [SSR_NODE_ID] 停止Shadowsocks代理，只在Unix环境下生效

-u --update 更新SSR订阅列表

--generate-clash 生成clash基础版配置文件

--fast-node 根据节点真连接延迟自动选择最优节点，并在本地启动代理

--test-speed SSR_NODE_ID 根据节点id测试节点上传下载速度

--setting-url SUBSCRIBE_URL 重置ssr订阅链接，SUBSCRIBE_URL为订阅链接地址
                            注：如果订阅链接中有&符号，请用""将链接括起来

--setting-address LOCAL_ADDRESS 重置本地代理监听地址，默认监听地址为127.0.0.1
                                一般在想要分享代理给局域网设备的时候使用

--add-url SUBSCRIBE_URL 增加ssr订阅链接，SUBSCRIBE_URL为订阅链接地址
                        注：如果订阅链接中有&符号，请用""将链接括起来

--remove-url SUBSCRIBE_URL 移除ssr订阅链接，SUBSCRIBE_URL为订阅链接地址
                           注：如果订阅链接中有&符号，请用""将链接括起来

--list-address 打印当前本地监听地址

--list-url 打印当前已有订阅链接

--parse-url SSR_URL 解析ssr链接，SSR_URL为ssr链接地址，例如：ssr://xxxxxxxxxxxxxxxx

--add-ssr SSR_URL 手动添加ssr节点到当前列表中，SSR_URL为ssr链接地址，例如：ssr://xxxxxxxxxxxxxxxx

--test-again SSR_NODE_ID 重新测试ssr节点连接状态，SSR_NODE_ID为节点ID，可从打印列表中获得

--print-qrcode SSR_NODE_ID 打印ssr节点二维码，SSR_NODE_ID为节点ID，可从打印列表中获得

--setting-global-proxy 设置全局代理为本地socks5代理，注：只支持Ubuntu Desktop

--setting-pac-proxy 设置pac代理，注：只支持Ubuntu Desktop

--close-system-proxy 关闭系统代理选项，注：只支持Ubuntu Desktop

--http ACTION[start stop status] 开启本地http服务器，自动生成pac文件，为系统提供http pac代理

--http-port PORT 指定本地http服务器端口号，默认为80

简单示例

假设你的订阅链接节点列表为如下：
+----+----------------------------+-----------+---------+----------------+------+-------------+
| id |            name            | delay(ms) | connect |     server     | port |    method   |
+----+----------------------------+-----------+---------+----------------+------+-------------+
| 0  |    SSRTOOL_Node:新加坡-    |     100     |    √    | 172.104.161.54 | 8099 | aes-256-cfb |
| 1  | SSRTOOL_Node:美国-密苏里州  |     200     |    √    |  69.30.201.82  | 8099 | aes-256-cfb |
+----+----------------------------+-----------+---------+----------------+------+-------------+

• 开启美国节点代理shadowsocksr-cli -s 1
• 打印节点列表shadowsocksr-cli -l
• 更新订阅列表shadowsocksr-cli -u
• 重置订阅链接shadowsocksr-cli --setting-url https://tyrantlucifer.com/ssr/ssr.txt
• 查看订阅链接列表shadowsocksr-cli --list-url
• 查看本地监听地址shadowsocksr-cli --list-address

API

• 通过shadowsocksr链接解析节点信息

import json
from shadowsocksr_cli.parse_utils import *

ssr_url = "ssr://NjkuMzAuMjAxLjgyOjgwOTk6b3JpZ2luOmFlcy0yNTYtY2ZiOnBsYWluOlpVbFhNRVJ1YXpZNU5EVTBaVFp1VTNkMWMzQjJPVVJ0VXpJd01YUlJNRVEvP3JlbWFya3M9VTFOU1ZFOVBURjlPYjJSbE91ZS1qdVdidlMzbHI0Ym9pNF9waDR6bHQ1NCZncm91cD1WMWRYTGxOVFVsUlBUMHd1UTA5Tg"
ssr_dict = ParseShadowsocksr.parse_shadowsocksr(ssr_url)
print(json.dumps(ssr_dict,
                 ensure_ascii=False,
                 indent=4))

• 通过shadowsocksr链接测试节点服务器和端口是否连通

from shadowsocksr_cli.parse_utils import *
from shadowsocksr_cli.network_test_utils import *

ssr_url = "ssr://NjkuMzAuMjAxLjgyOjgwOTk6b3JpZ2luOmFlcy0yNTYtY2ZiOnBsYWluOlpVbFhNRVJ1YXpZNU5EVTBaVFp1VTNkMWMzQjJPVVJ0VXpJd01YUlJNRVEvP3JlbWFya3M9VTFOU1ZFOVBURjlPYjJSbE91ZS1qdVdidlMzbHI0Ym9pNF9waDR6bHQ1NCZncm91cD1WMWRYTGxOVFVsUlBUMHd1UTA5Tg"
ssr_dict = ParseShadowsocksr.parse_shadowsocksr(ssr_url)
ssr_dict = ShadowsocksrTest.test_shadowsocksr_connect(ssr_dict)
print(ssr_dict['connect'],
      ssr_dict['ping'])

• 通过shadowsocksr链接测试节点上传+下载速度

from shadowsocksr_cli.parse_utils import *
from shadowsocksr_cli.network_test_utils import *

ssr_url = "ssr://NjkuMzAuMjAxLjgyOjgwOTk6b3JpZ2luOmFlcy0yNTYtY2ZiOnBsYWluOlpVbFhNRVJ1YXpZNU5EVTBaVFp1VTNkMWMzQjJPVVJ0VXpJd01YUlJNRVEvP3JlbWFya3M9VTFOU1ZFOVBURjlPYjJSbE91ZS1qdVdidlMzbHI0Ym9pNF9waDR6bHQ1NCZncm91cD1WMWRYTGxOVFVsUlBUMHd1UTA5Tg"
ssr_dict = ParseShadowsocksr.parse_shadowsocksr(ssr_url)
ssr_dict = ShadowsocksrTest.test_shadowsocksr_connect(ssr_dict)
ShadowsocksrTest.test_shadowsocksr_speed(ssr_dict)

Linux终端设置代理方法

• 终端设置代理export ALL_PROXY=socks5://127.0.0.1:1080
• 查看代理是否设置成功curl http://ip-api.com/json/?lang=zh-CN
• 取消终端代理unset ALL_PROXY
• 如果想要更加方便的使用快捷命令，将以下内容添加到你家目录中的.bashrc中，然后执行source ~/.bashrc

alias setproxy="export ALL_PROXY=socks5://127.0.0.1:1080"
alias unsetproxy="unset ALL_PROXY"
alias ip="curl http://ip-api.com/json/?lang=zh-CN"

这样以下几个命令就会实现如下功能：

setproxy 开启代理
unsetproxy 关闭代理
ip 查看ip归属地

常见问题

• 我的代理打开了，为什么还是翻不出去？

ssr-command-client的实质是使用Python版本的ssr开启了一个本地socks5代理，并没有实现自动分流和开启代理的功能，要想知道自己有没有开启成功，看上面使用方法章节，Linux学习如何命令行设置socks5代理，Windows学习如何在浏览器设置socks5代理

• 我的按照那几条命令查看了我的ip和设置了代理，都成功了，可是我执行wget www.google.com怎么还是不行？

命令行虽然设置好代理了，但是默认用的是我们本地的dns，没有用socks5代理的dns，国内早把google给污染了，google被解析到一个鬼一样的ip上，你说它咋能成功呢？你要是非要想用这种方法测试，使用curl --proxy socks5h://127.0.0.1:1080 www.google.com去查看是否有输出内容

• 针对Ubuntu Desktop用户的一些通知：

目前项目已经支持设置网络全局代理和pac代理，但是pac代理使用的file://协议指向的文件，新版chrome已经不支持这种协议的pac文件了，所以在设置完pac代理之后，chrome无法扶墙出去，但是火狐可以，如果chrome也想扶墙出去，建议使用SwitchyOmega插件进行分流，或者本地搭建一个http服务器，然后将~/.ssr-command-client下自动生成的autoproxy.pac扔到网站目录里去，在系统设置里把file://协议设置成http://协议即可

作者的几句话

1. ok，我开发这个东西是为了让自己服务器访问github的速度更加快一点而开发的，目的单纯是为了让coding更加顺畅一些。
2. 本客户端不适合小白用，需要有一些Linux基础或者有命令行终端使用经验的人来用，小白就不要来找我了好吗？
3. 我曾经写过几篇关于telegram的脚本和教程，但是不代表我会替人搭建或者买卖代理，小白也不要关注我公众号然后丢给我一句telegram代理、求telegram代理，我不是逗比，我没那个时间照顾小白情绪，不懂请绕路。
4. 因为最近工作和学习原因，公众号很少更新，流失了很多粉丝，但也无可奈何，希望大家能多多理解，不要取关，以后会更新更多精品内容。
5. fork的大哥们能否在fork之前给个star

支持开源❤️, 请作者喝杯星巴克

有意愿献爱心的小伙伴，务必将github账号写入捐款备注哦，谢谢大家

wechat	alipay

Tips

如果有好的建议，欢迎发邮件给我，或者关注下方我的个人微信公众号在后台留言，或者加qq群764374820反馈

• Email:[email protected]
• Blog:https://tyrantlucifer.com
• Telegram:https://t.me/ssr_command_client
• Personal Wechat

微信公众号

致谢

感谢Jetbrains给予开发本项目的正版工具支持，如果有商业需求，推荐购买正版Jetbrains

Jetbrains

Stargazers over time