v2sing
is a tool designed to seamlessly convert subscription links from the v2 or clash subscription formats to the sing-box format, ensuring compatibility and simplifying migration.
v2sing
is compatible with sing-box >=1.11.0
. For best results, use the latest stable release.
Protocol | Conversion (v2/clash → sing-box) |
---|---|
VMess | ✅ |
VLESS | ✅ |
Shadowsocks | ✅ |
Trojan | ✅ |
Hysteria2 | ✅ |
You can self-host this project or deploy it to Cloudflare Workers. To deploy the project to Cloudflare Workers, download the latest release of v2sing
from the Releases page and deploy it directly to the Cloudflare Workers instance you created.
Use the v2sing
tool by providing specific parameters. Below are the currently available parameters:
sub
(required) - The subscription URL to convert.- Example:
?sub=https://example.com/sub
- Example:
config
(optional) - The configuration template URL for advanced output customization. See Creating a Configuration Template section for more details.- Example:
?sub=https://example.com/sub&config=https://example.com/config_template.json
- Example:
You can create a configuration template just like a regular sing-box configuration file, but with placeholders to dynamically insert information from the subscription.
To get started, refer to the sample template provided here, which you can customize to suit your requirements.
Placeholders are written in the format {{ placeholder_name }}
and are replaced with actual values at runtime.
Here are the currently available placeholders:
{{ outbounds_tags }}
- This placeholder is replaced with an array of outbound tags.{{ outbounds }}
- This placeholder is replaced with a list of outbound configurations.
This project requires Deno version 2.0 or higher.
To start a development server, run:
deno task serve
To build the project, run:
deno task build
The build artifacts will be located in the dist
directory.
Use deno task
to explore additional available commands.
See the CHANGELOG.md file for more information.
This project is licensed under the AGPLv3 License. See the LICENSE file for more information.
Copyright © 2024-2025 Printfer