subconverter-rs

A more powerful utility to convert between proxy subscription formats, transformed from the C++ version subconverter! This Rust implementation offers improved performance and reliability while maintaining compatibility with the original.

⚠️ BETA VERSION AVAILABLE ⚠️ - This project is now in beta. Core features are implemented but may still have some rough edges. 🎉 wasm版本白嫖一键部署：

Demo部署，测试时请注意隐私风险： https://subconverter-rs.netlify.app/

📋 Table of Contents

• Features
• Implementation Status
• Protocol Support Matrix
• Installation
• Basic Usage
• Advanced Usage
• Configuration
• Development
• License

✨ Features

• High-performance subscription conversion with Rust's speed and safety
• Support for various proxy formats and protocols
• Flexible node filtering, renaming, and emoji addition
• Customizable templates and rule sets
• HTTP server with RESTful API endpoints
• Compatible with original subconverter configuration

📊 Protocol Support Matrix

The following table shows the support status of different proxy protocols in various rule types:

Legend:

• ✅ Fully supported (both input and output)
• ⚠️ Partially supported (untested)
• ⬇️ Supported as input source only
• ⬆️ Supported as output target only
• ❌ Not supported

Notes:

1. Shadowrocket users can use the ss, ssr, v2ray, and mixed parameters
2. For HTTP/Socks links without naming (TG-like), you can append &remarks= for naming and &group= for group naming. These parameters need to be URLEncoded
3. When the target type is mixed, all supported nodes will be output as a normal subscription (Base64 encoded)
4. When the target type is auto, the output target type will be automatically determined based on the request's User-Agent

📥 Installation

From GitHub Releases

# Download the latest release
DOWNLOAD_URL=$(curl -s https://api.github.com/repos/lonelam/subconverter-rs/releases/latest | \
               jq -r '.assets[] | select(.name == "$subconverter_zip_name").browser_download_url')
curl -L -O "$DOWNLOAD_URL"
tar -zxf $subconverter_zip_name

# Navigate to the extracted directory
cd subconverter

From Crates.io

cargo install subconverter

From Source

git clone https://github.com/lonelam/subconverter-rs.git
cd subconverter-rs
cargo build --release

The binary will be available at target/release/subconverter-rs.

Docker (Coming Soon)

docker pull lonelam/subconverter-rs
docker run -d -p 25500:25500 lonelam/subconverter-rs

🔰 Basic Usage

API Endpoint

http://127.0.0.1:25500/sub?target=%TARGET%&url=%URL%&config=%CONFIG%

Parameters

Simple Conversion Examples

Original subscription: https://example.com/subscribe/ABCDE?surge=ss

URLEncoded: https%3A%2F%2Fexample.com%2Fsubscribe%2FABCDE%3Fsurge%3Dss

API call: http://127.0.0.1:25500/sub?target=clash&url=https%3A%2F%2Fexample.com%2Fsubscribe%2FABCDE%3Fsurge%3Dss

Original subscriptions:
1. https://example1.com/subscribe/ABCDE?clash=vmess
2. https://example2.com/subscribe/ABCDE?clash=vmess

Combined with pipe: https://example1.com/subscribe/ABCDE?clash=vmess|https://example2.com/subscribe/ABCDE?clash=vmess

URLEncoded: https%3A%2F%2Fexample1.com%2Fsubscribe%2FABCDE%3Fclash%3Dvmess%7Chttps%3A%2F%2Fexample2.com%2Fsubscribe%2FABCDE%3Fclash%3Dvmess

API call: http://127.0.0.1:25500/sub?target=clash&url=https%3A%2F%2Fexample1.com%2Fsubscribe%2FABCDE%3Fclash%3Dvmess%7Chttps%3A%2F%2Fexample2.com%2Fsubscribe%2FABCDE%3Fclash%3Dvmess

Original node: ss://YWVzLTEyOC1nY206dGVzdA==@192.168.100.1:8888#Example1

URLEncoded: ss%3A%2F%2FYWVzLTEyOC1nY206dGVzdA%3D%3D%40192%2E168%2E100%2E1%3A8888%23Example1

API call: http://127.0.0.1:25500/sub?target=clash&url=ss%3A%2F%2FYWVzLTEyOC1nY206dGVzdA%3D%3D%40192%2E168%2E100%2E1%3A8888%23Example1

Quick Surge to Clash Conversion

For quick conversion from Surge to Clash without additional configuration:

http://127.0.0.1:25500/surge2clash?link=SurgeSubscriptionLink

Note: The Surge subscription link does NOT need to be URLEncoded.

🔧 Advanced Usage

Advanced API Parameters

⚙️ Configuration

subconverter-rs supports multiple configuration file formats. It will load configuration in the following priority order: pref.toml, pref.yml, pref.ini.

Key Configuration Sections

External Configuration

You can host configuration files on GitHub Gist or other accessible network locations. URL-encode the configuration URL and add it to the &config= parameter.

Local Generation

For generating configurations locally, create a generate.ini file:

[test]
path=output.conf
target=surge
ver=4
url=ss://Y2hhY2hhMjAtaWV0Zi1wb2x5MTMwNTpwYXNzd29yZA@www.example.com:1080#Example

Then run: subconverter -g

👩‍💻 Development

Contributions are welcome! Please feel free to submit a Pull Request.

How to Contribute

1. Pick an issue: Check our issue tracker for tasks labeled good first issue or help wanted
2. Implement new proxy types: Help expand support for additional proxy protocols
3. Improve parsing: Enhance the robustness of the various format parsers
4. Add tests: Increase test coverage to ensure stability
5. Documentation: Improve docs or add examples to help others use the project
6. Performance optimizations: Help make the converter even faster

📄 License

This project is licensed under the GPL-3.0+ License - see the LICENSE file for details.