tindy2013 /subconverter

Utility to convert between various subscription format

★ 17,119⑂ 3,836👁 102⑃ 185● 705▤ 38
C++GPL-3.0Created 2019-10-31
下载:v0.9.0v0.9.0 ↓0.9.02024-04-08
+1
日增长
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 %TA

Top issues

Latest release

v0.9.0 v0.9.0 2024-04-08
Bugs 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON