v2sing

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.

Supported Versions

v2sing is compatible with sing-box >=1.11.0. For best results, use the latest stable release.

Supported Protocols

Protocol	Conversion (v2/clash → sing-box)
VMess	✅
VLESS	✅
Shadowsocks	✅
Trojan	✅
Hysteria2	✅

Installation

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.

Usage

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
• 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

Creating a Configuration Template

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.

Development

This project requires Deno version 2.0 or higher.

Serving the Project

To start a development server, run:

deno task serve

Building the Project

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.

Changlog

See the CHANGELOG.md file for more information.

License

This project is licensed under the AGPLv3 License. See the LICENSE file for more information.

Credits

Copyright © 2024-2025 Printfer