tindy2013 /subconverter
Utility to convert between various subscription format
★ 17,119⑂ 3,836👁 102⑃ 185● 705▤ 38
+1
Daily
17,119
stars
3,836
forks
102
watchers
185
prs
705
issues
38
releases
README
subconverter
Utility to convert between various proxy subscription formats.
Docker README
中文文档
- subconverter
- Supported Types
- Quick Usage
- Access Interface
- Description
- Advanced Usage
- Auto Upload
Supported Types
| Type | As Source | As Target | Target Name |
| ------------ | :--------: | :----------: | ----------- |
| Clash | ✓ | ✓ | clash |
| ClashR | ✓ | ✓ | clashr |
| Quantumult | ✓ | ✓ | quan |
| Quantumult X | ✓ | ✓ | quanx |
| Loon | ✓ | ✓ | loon |
| SS (SIP002) | ✓ | ✓ | ss |
| SS Android | ✓ | ✓ | sssub |
| SSD | ✓ | ✓ | ssd |
| SSR | ✓ | ✓ | ssr |
| Surfboard | ✓ | ✓ | surfboard |
| Surge 2 | ✓ | ✓ | surge&ver=2 |
| Surge 3 | ✓ | ✓ | surge&ver=3 |
| Surge 4 | ✓ | ✓ | surge&ver=4 |
| V2Ray | ✓ | ✓ | v2ray |
| Telegram-liked HTTP/Socks 5 links | ✓ | × | Only as source |
Notice:
1. Shadowrocket users should use ss, ssr or v2ray as target.
2. You can add &remark= to Telegram-liked HTTP/Socks 5 links to set a remark for this node. For example:
- tg://http?server=1.2.3.4&port=233&user=user&pass=pass&remark=Example
- https://t.me/http?server=1.2.3.4&port=233&user=user&pass=pass&remark=Example
---
Quick Usage
Using default groups and rulesets configuration directly, without changing any settings
Access Interface
txt
http://127.0.0.1:25500/sub?target=%TARGET%&url=%URL%&config=%CONFIG%
Description
| Argument | Required | Example | Description |
| -------- | :------: | :------ | ----------- |
| target | Yes | clash | Target subscription type. Acquire from Target Name in Supported Types. |
| url | Yes | https%3A%2F%2Fwww.xxx.com | Subscription to convert. Supports URLs and file paths. Process with URLEncode first. |
| config | No | https%3A%2F%2Fwww.xxx.com | External configuration file path. Supports URLs and file paths. Process with URLEncode first. More examples can be found in this repository. |
If you need to merge two or more subscription, you should join them with '|' before the URLEncode process.
Example:
txt
You have 2 subscriptions and you want to merge them and generate a Clash subscription:
1. https://dler.cloud/subscribe/ABCDE?clash=vmess
2. https://rich.cloud/subscribe/ABCDE?clash=vmess
First use '|' to separate 2 subscriptions:
https://dler.cloud/subscribe/ABCDE?clash=vmess|https://rich.cloud/subscribe/ABCDE?clash=vmess
Then process it with URLEncode to get %URL%:
https%3A%2F%2Fdler.cloud%2Fsubscribe%2FABCDE%3Fclash%3Dvmess%7Chttps%3A%2F%2Frich.cloud%2Fsubscribe%2FABCDE%3Fclash%3Dvmess
Then fill %TATop issues
#611[Feature] 请问能不能支持VLESS-WS-TLS?19 comments · 2023-06-02#750[Feature] 能否支持 mihomo 内核格式转换17 comments · 2024-04-29#579[BUG] <title>同样一个订阅地址,用sub.id9.cc可以转换,用subconverter提示 No nodes were found!12 comments · 2023-02-24#475[Feature] 希望支持rule-provider12 comments · 2022-04-10#655[Feature] 建议增加sing-box作为转换目标11 comments · 2023-11-03#867[Feature] 建议支持vless等新协议10 comments · 2025-10-03#473[BUG] <QuanX启动aead似乎不需要aead=true参数>10 comments · 2022-04-08#673[Feature] 希望增加sing-box配置转Clash配置的功能9 comments · 2023-11-21
Latest release
v0.9.0 v0.9.0 2024-04-08Bugs fixed: Fix wrong flag identification When converting Nigeria node (654) Fix request arguments not properly handled (661) Fix a typo which cause the server to hang Fix bad conversion of DOMAIN-SUFFIX rules when generating Surge DOMAIN-SET (667) Fix proxy type missing when append_proxy_type is enabled for Quantumult X configs Fix crash if name argument is missing in getProfile interface Fix bad webGet retry logic Fix implementation of str_icase_map for HTTP headers Fix missing classical rulesets when exporting Clash configs with expand=false (715) Fix implementation of g