How to use Clash to Singbox Converter

A comprehensive guide on converting Clash subscription links to Singbox format, supporting advanced templates and custom configurations.

With the growing popularity of the sing-box core, more and more users wish to experience its powerful performance and rich features. However, the barrier to writing sing-box configuration files is relatively high.

To solve this problem, we have integrated the Clash to Singbox Converter Tool, helping you easily generate standard sing-box configurations from Clash subscription links.

Accessing the Tool

You can access the Converter Tool Page directly to use this feature.

Core Features Explained

1. Basic Conversion (URL Mode)

This is the most common function, suitable for most users.

  1. Enter Subscription Link: Paste your Clash subscription address (starting with http or https) into the Subscription Link text box.
  2. Filter Nodes (Optional):
    • Include Nodes: Enter keywords (e.g., HK) to keep only nodes with matching names.
    • Exclude Nodes: Enter keywords (e.g., Expired) to filter out nodes with matching names.
  3. Select Template: No selection is needed by default; the system automatically uses the latest 1.12+ compatible template.
  4. Click Generate: Click the “Generate Subscription Link” button.
  5. Import to Use: The tool will automatically copy the result to the clipboard and attempt to launch the sing-box client for import.

2. Advanced Settings

Click Configure Advanced Settings to expand more options for customizing your configuration file:

  • Disable URL Test: Checking this removes the automatic speed test group, changing all node groups to manual select type.
  • Add Tag: Checking this adds the subscription domain tag to node names, preventing duplicate names across multiple subscriptions.
  • Outbound Control:
    • Auto: Automatic handling.
    • Block: Block undefined outbound traffic.
    • None: No special handling.

3. Template Selection

We provide various configuration templates to adapt to different sing-box core versions or personalized needs:

Template NameDescriptionUse Case
Default (1.12+)Recommended. Based on sing-box 1.12+ features.Most users on new versions
1.11+Compatible with 1.11.x kernels.Older clients
1.10-Compatible with 1.10 and below.Very old clients
Custom ContentCustom configuration JSON content.Paste your own JSON template
Custom URLCustom configuration URL.Load remote configuration template files

4. Smart Paste

This is a very convenient feature. If you already have a converted sing-box subscription link (generated by this site), you can paste it directly anywhere on the page (or into the Subscription Link box).

The tool will automatically recognize the parameters in the link and help you:

  • Restore the original Clash subscription link
  • Restore include/exclude keywords
  • Restore advanced settings
  • Restore the used template

This allows you to easily fine-tune previous configurations without resetting everything manually.

FAQ

Why did the conversion fail?
First, please check if your Clash subscription link is valid. Try opening it directly in a browser to see if you can download the config file. If the subscription link requires a specific User-Agent to return content, conversion might be affected.
Why can't the generated link update?
The conversion link generates content in real-time, depending on our backend service. If the backend is temporarily unavailable or your network cannot connect to it, updates will fail. It is recommended to update your subscription manually when the network allows.
How to import into sing-box?
After clicking "Generate", the tool tries to invoke the `sing-box://import-remote-profile` protocol. If your device has sing-box installed and associated with this protocol, it will jump automatically. Otherwise, please manually copy the generated URL and select "Import remote profile" in the client.