FullTclash

基于clash 核心运作的、进行全量订阅测试的telegram机器人

最近更新(3.4.2)

• 新增Viu流媒体测试项

• 新增节点落地IP风险测试

• 新增节点过滤器。可以选择性地测试一个订阅里地部分节点。 注意⚠️，由于是基于subconvertor实现，那么想要使用此功能，必须得在配置文件中将subconvertor启用。

  使用方法: /test <订阅名> <包含过滤器> <排除过滤器>

  例子: /test dingyue 香港 IPLC 意思是对 "dingyue" 进行测试，并且仅包含 "香港" ,且排除名字含有"IPLC"的节点。/analyze /speed 指令同理。具体使用 /help 查看说明。

• 移动配置文件 config.yaml 。在3.4.2的版本之前，配置文件位置默认要求是在项目根目录下。 现如今已更改为 ./resources/config.yaml ，如果您更新后配置文件依旧在旧的位置，那么程序启动会发出警告，提醒您更换配置文件位置，当然不更换位置仍然能使用，只是一直会有警告提示。

• 移动了一系列测试脚本到 ./addons/unlockTest

历史更新请到TG频道查看:

https://t.me/FullTClash

基本介绍

FullTclash bot 是承载其测试任务的Telegram 机器人（以下简称bot）,目前支持以clash配置文件为载体的批量联通性测试,支持以下测试条目:

• Netflix

• Youtube

• Disney Plus

• Bilibili

• Dazn

• Hbomax

• Bahamut

• 落地IP风险检测

以及clash 延迟测试和链路拓扑测试（节点出入口分析）。

效果预览

流媒体测试:

如何开始

基础准备

要成功运行该项目代码，首先需要准备以下信息：

• Telegram 的api_id 、api_hash 获取地址 不会请Google。

• 去 @BotFather 那里创建一个机器人，获得该机器人的bot_token，应形如：

  bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

  这步不会请Google。

• 一个clash 核心， 下载地址。（可选，可以用/resources里默认的）

• 字体文件。（可选，可以用默认的）

环境准备

• Python 3.6 以上

• 以及各种相关包依赖

您可以用以下命令，在当前项目目录下运行以快速安装环境：

Windows:

pip install -r requirements.txt

Linux:

pip3 install -r requirements.txt

拉取源码

方法1：直接下载（不会有人不知道在哪下吧？）

方法2：使用git（Linux推荐，方便更新），首先安装git，然后拉取仓库。以下指令为 Ubuntu 发行版作示例，Windows自行解决。

apt install -y git && git clone https://github.com/AirportR/FullTclash.git && cd FullTclash

此方法在中国大陆可能需要代理加速，请自行解决。

获取session文件

您需要在项目文件目录下，放置一个已经登陆好的.session后缀文件，这个文件是程序生成的，形如： my_bot.session

方法1： 您可以参阅这篇文档，以快速获得后缀为 .session 的文件

方法2： 项目根目录下有一个文件名为 login.py ，可以通过指令运行它：

python .\login.py

当程序退出后即可自动生成一个名为 my_bot.session 的文件

运行后它会尝试给你输入的用户名的目标发送消息，当接收到：嗨, 我在正常工作哦！

这句话时，即可说明该session文件有效，否则无效。

赋予clash核心执行权限 (Linux)

Windows系统无需此操作

chmod +x ./resources/clash-linux-amd64

为bot进行相关配置

• 管理员配置

  新建一个名为config.yaml的文件，项目有模板例子名为config.yaml.example,在config.yaml中写入如下信息：

  admin:
  - 12345678 # 改成自己的telegram uid
  

• 代理配置

  如果是在中国大陆地区使用，则程序需要代理才能连接上Telegram服务器。在config.yaml中写入如下信息：

  #bot通讯代理
  bot:
  proxy: 127.0.0.1:7890 #替换成自己的代理地址和端口
  # 获取订阅时使用代理（可选）
  proxy: 127.0.0.1:7890 #替换成自己的代理地址和端口,注意，此配置与上面的独立分开。
  

开始启动

在项目目录下运行以下指令

python main.py

等待初始化操作，出现“程序已启动!”字样就说明在运行了. 运行之后和bot私聊命令：

/testurl 订阅地址(clash配置格式) 即可开始测试

/help 可查看所有命令说明

为程序设置进程守护(Linux)

由于Linux系统特性，关闭ssh连接后，前台程序会被关闭。您需要设置进程守护，才能在后台不间断地运行程序。具体方法Google搜索即可。

交流探讨

我们欢迎各方朋友提出针对性的反馈：

TG更新发布频道

在项目页面提出issue

致谢

• SSRSpeedN部分代码灵感

• 流媒体解锁思路

• 以下这些上游项目:

  • Clash

  • aiohttp

  • pyrogram

  • async-timeout

  • BeautifulSoup

  • Pillow

  • pilmoji

  • pyyaml

  • requests