本地订阅转换脚本 – Subscription Converter

分享一个本地的订阅转换脚本 – Subscription Converter,只需要一个命令行执行就行了,只有一个py,非常简单,也不需要部署和配置,python运行就行。

仓库地址:GitHub – l-ning/Subscription-Converter: 一个功能强大的订阅链接转换工具,支持多种协议和输出格式。

:sparkles:最简单的使用方法,执行后生成的yaml文件,拖到你的clash配置目录下就行了,切换节点就能看到了

:sparkles: 功能特点

  • :link: 多协议支持:VMess、VLESS、Shadowsocks、Trojan、Hysteria2
  • :file_folder: 多种输入方式:订阅链接、本地文件(支持混合协议)
  • :bullseye: 多种输出格式:Clash YAML、V2Ray JSON
  • :wrench: 兼容模式:自动转换不支持的协议(Hysteria2 → VMess)
  • :bar_chart: 智能过滤:自动过滤流量、到期时间等信息节点
  • :artist_palette: 多种模板:minimal、standard、advanced三种配置模板
  • :1234: 节点限制:支持限制节点数量,避免配置文件过大
  • :shield: UUID修复:自动验证和修复不标准的UUID格式
  • :chart_increasing: 详细统计:显示节点数量、协议分布等详细信息

:rocket: 安装

# 安装依赖
pip3 install PyYAML

# 下载脚本
# 脚本已经准备好,可以直接使用

基本用法

# 转换订阅链接为Clash配置(默认启用兼容模式)
python3 subscription_converter.py "你的订阅链接"

# 从本地文件转换节点(支持包含多种协议的文本文件)
python3 subscription_converter.py nodes.txt --file -o config.yaml

# 指定输出文件
python3 subscription_converter.py "你的订阅链接" -o my_config.yaml

# 使用高级模板
python3 subscription_converter.py "你的订阅链接" -t advanced

# 禁用兼容模式,保持原始协议(需要支持Hysteria2的客户端)
python3 subscription_converter.py "你的订阅链接" --no-compatible -o original.yaml

# 限制节点数量(适用于大型订阅)
python3 subscription_converter.py "你的订阅链接" --limit 100 -o limited_config.yaml

# 转换为V2Ray配置
python3 subscription_converter.py "你的订阅链接" -f v2ray -o v2ray_config.json

命令行参数

参数说明默认值
url订阅链接URL或本地文件路径必需
-f, --format输出格式 (clash/v2ray)clash
-t, --template配置模板 (minimal/standard/advanced)standard
-o, --output输出文件名自动生成
--test测试模式,使用内置示例
--no-filter不过滤信息节点(流量、到期时间等)
--compatible兼容模式,转换不支持的协议为兼容格式默认启用
--no-compatible禁用兼容模式,保持原始协议
--limit限制节点数量(避免配置文件过大)无限制
--file从本地文件读取节点内容
滚动至顶部