sc

shadowsocksr-cli

✈️The commend client of ssr based Python3

Showing:

Popularity

Downloads/wk

0

GitHub Stars

379

Maintenance

Last Commit

6d ago

Contributors

6

Package

Dependencies

0

License

Categories

Readme

The command client of Shadowsocksr based Python3

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

特性

  • 全新2.0版本,在1.0基础上进行使用面向对象重构,并预留接口
  • 支持Linux + Windows双平台,mac因为没机器(家境贫寒)未做测试,后期会适配mac
  • 支持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账号写入捐款备注哦,谢谢大家

wechatalipay
序号支持者RMB时间
1lfp1024202021-09-12

Tips

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

微信公众号

致谢

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

Jetbrains

Stargazers over time

Stargazers over time

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100