基于clash 核心运作的、进行全量订阅测试的telegram机器人
3.5.2版本更新如下特性:
✨ 移除内置的Primevideo流媒体检测项,以Spotify代替。 ✨ 新增两个geoip的api地址,域名为 ipleak.net ipdata.co,其中ipdata.co需要配置geoip-key才能正常使用。@kogekiplay 的pr @mlmmlm的pr ✨ 支持bot重启,输入 /restart 即可重启bot。 @cpploveme的pr 🚗 /sub 指令用户可列出自己的订阅。@kogekiplay 的pr 🚗 优化bot启动提示。 历史更新请到TG频道查看:
FullTclash bot 是承载其测试任务的Telegram 机器人(以下简称bot),目前支持以clash配置文件为载体的批量联通性测试,支持以下测试条目:
- Netflix
- Youtube
- Disney Plus
- Bilibili
- Primevideo
- steam货币
- OpenAI(ChatGPT)
- 落地ip风险(IP欺诈度)
- 维基百科
以及HTTP延迟测试和链路拓扑测试(节点出入口分析)。
流媒体测试:
要成功运行该项目代码,首先需要准备以下信息:
-
Telegram 的api_id 、api_hash 获取地址 不会请Google。(部分TG账号已被拉黑,无法正常使用)
-
去 @BotFather 那里创建一个机器人,获得该机器人的bot_token,应形如:
bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
这步不会请Google。
-
一个clash 核心, 下载地址。(可选,可以用/resources里默认的)
-
字体文件。(可选,可以用默认的)
方法1:直接下载(不会有人不知道在哪下吧?)
方法2:使用git(Linux推荐,方便更新),首先安装git,然后拉取仓库。以下指令为 Ubuntu 发行版作示例,Windows自行解决。
apt install -y git && git clone https://github.com/AirportR/FullTclash.git && cd FullTclash
此方法在中国大陆可能需要代理加速,请自行解决。
-
Python 3.6 以上
-
以及各种相关包依赖
您可以用以下命令,在当前项目目录下运行以快速安装环境:
Windows:
pip install -r requirements.txt
Linux:
pip3 install -r requirements.txt
Windows系统无需此操作
chmod +x ./resources/clash-linux-amd64
-
管理员配置
新建一个名为config.yaml的文件,项目有模板例子名为./resources/config.yaml.example,在config.yaml中写入如下信息:
admin: - 12345678 # 改成自己的telegram uid
-
代理配置
如果是在中国大陆地区使用,则程序需要代理才能连接上Telegram服务器。在config.yaml中写入如下信息:
#bot通讯代理 bot: proxy: 127.0.0.1:7890 #sock5 替换成自己的代理地址和端口 # 获取订阅时使用代理(可选) proxy: 127.0.0.1:7890 #http 替换成自己的代理地址和端口,注意,此配置与上面的独立分开。
-
更改clash核心
如果您想在非Windows平台运行此程序,请在配置文件中指定对应平台的clash可执行文件:
# 以Ubuntu为例: clash: path: ./resources/clash-linux-amd64 workpath: ./clash
您需要在项目文件目录下,放置一个已经登陆好的.session后缀文件,这个文件是程序生成的,形如: my_bot.session
方法1: 您可以参阅这篇文档,以快速获得后缀为 .session 的文件
方法2: 项目根目录下有一个文件名为 login.py ,可以通过指令运行它:
python .\login.py
当程序退出后即可自动生成一个名为 my_bot.session 的文件
运行后它会尝试给你输入的用户名的目标发送消息,当接收到:嗨, 我在正常工作哦!
这句话时,即可说明该session文件有效,否则无效。
方法3:可以直接在配置文件config.yaml中配置,这样程序启动后会自动读取配置文件里面的值来生成session文件(要求一定要正确)。
#配置文件示例,注意缩进要正确
bot:
api_id: 123456
api_hash: 123456ABCDefg
bot_token: 123456:ABCDefgh123455
如果启动后无法验证,请删除生成的mybot.session文件,此时的文件是坏的,不可用,如果不删除程序会一直使用坏的文件,不会重新生成。然后重新启动。
目前有两种启动方式,一次启动和分开启动。区别在于,一次性启动会自动启动子进程clash core,而分开启动会先启动clash core,bot程序主体启动的时侯就不会再启动了。直观点的感受就是bot启动变快。
一次启动: 配置好后,在项目目录下运行以下指令 Windows(Linux系为python3):
python main.py
分开启动: 在项目目录下运行以下指令 Windows10:
python clash.py
在第二个窗口运行:
python main.py
Ubuntu:
python3 clash.py
在第二个窗口运行:
python3 main.py
等待初始化操作,出现“程序已启动!”字样就说明在运行了. 运行之后和bot私聊命令:
/testurl 订阅地址(clash配置格式) 即可开始测试
/help 可查看所有命令说明
由于Linux系统特性,关闭ssh连接后,前台程序会被关闭。您需要设置进程守护,才能在后台不间断地运行程序。具体方法Google搜索即可。
我们欢迎各方朋友提出针对性的反馈:
在项目页面提出issue