Node HandbookNODE HANDBOOK中文
Subscription · trust boundary

Subscription conversion: what it does, and what it costs you

Conversion does not make nodes faster. It reads an upstream subscription and re-emits it in another format. The question that matters is not whether a converter works, but who has to hold your subscription for it to work.

Node Handbook editorial team ·

The short version

  • When a conversion request takes your original subscription URL as input, the converter touches that input. Project documentation also supports file-path input, so not every conversion method means submitting a URL to a public site.
  • A conversion request produces a target subscription format. It is not a general repair for plan state, route state or client faults.
  • The shortest path is usually the provider's native format into the matching client. Consider conversion only when a format genuinely does not fit.
  • If node count, rules or update behaviour changes after conversion, record the difference. Current public material does not provide a complete compatibility matrix, so do not assign a specific technical cause.
  • Mask subscriptions, conversion addresses, QR codes, logs and screenshots. If you suspect exposure, rotate the token in the provider panel — deleting a message is not rotation.

What a conversion request actually carries

In the open-source subconverter documentation, a request names a target format and supplies the subscription to convert through a url parameter. Merging several subscriptions means several URLs are handed to the program as input. That describes what the program needs in order to read upstream content. It says nothing about whether any particular public deployment is trustworthy.

Input or actionWhat the converter may doWhat that does not prove
Original subscription URLFetch nodes and configuration contentThat the service keeps no URL or logs
Target typeRequest output for a supported target valueThat every protocol or field converts without loss
Multiple subscriptions mergedAggregate several upstream payloadsThat nothing duplicates, conflicts, or leaks more tokens than before

Mihomo's proxy-providers documentation is often cited here, and it is worth reading for what it actually solves: remote providers, save paths, filtering and health checks. It is a way to organise and refresh configuration. It is not an argument that a third-party online converter is required.

Decide whether you need conversion at all

  1. Check whether the provider panel already offers a subscription adapted to your client.
  2. Import the native address once and record what happened: an HTTP error, a parse error, or an empty node list.
  3. Identify what the address returned: a complete configuration, a node list, a login page, or an error page.
  4. Only after establishing “the upstream is valid but this client cannot parse this format” does conversion become a reasonable step.
  5. If your goal is only to change rules or rename nodes, check first whether the client supports overrides, providers or a local configuration file.

Native format, local conversion, self-hosted, public site

The table lists the main checkpoints in the decision. It is not a complete inventory of who can access data on any specific deployment — the actual parties depend on that deployment's configuration, logging and permissions.

MethodWho can touch the original subscriptionAdvantageCost or main risk
Provider's native formatProvider and the local clientShortest path, clear responsibility for formatProvider may not offer every client format
Client reads it directlyProvider and the local clientNo extra processing stepSome fields or protocols still unsupported
Local conversionYour machine and the program you choseThe original subscription never goes to a public siteYou install, update and verify the tool yourself
Self-hosted conversionProvider, your server, your clientYou control deployment and logging policyServer security, updates and logs are your responsibility
Public online conversionProvider, the conversion site, your clientConvenientPage promises cannot establish logging, caching or access control

“Local” and “self-hosted” are not automatically safe either. Verify the project source, the version, the listening address, access control, logging, update path, and whether the output URL is publicly reachable.

When the output differs from the input

Record the input format, target format, converter and version, whether an external configuration was applied, and the exact observed difference — then consult the documentation for that version. Public material does not supply a full format compatibility matrix, so “it changed after conversion” is not a diagnosis, and a missing node is not automatically a dead node.

Change one variable at a time: validate the original address, then the conversion request, then the client import. Do not swap client, rules, DNS and system proxy together.

Symptom after conversionFirst thing to recordWhat remains unproven
Fewer nodesProtocols supported by the target core, the filter rules, count before and afterWhether the missing nodes are dead, filtered, or unsupported
Rules behave differentlyWhether an external rule set or template was appliedWhether the converter or your template caused it
Client refuses the outputThe first line the client rejects and its parser versionWhether the upstream was valid in the first place
Still no trafficOne real HTTPS request after importAnything about the plan or the server

A record you can actually check later

Keep the date, client and version, upstream format, target format, conversion method, converter and version, node count before and after, skipped protocols, the first error text, and whether external configuration was used. For the subscription URL, record only the domain and a masked identifier; never write the token, UUID, password, QR code or full query string into a public record.

If you suspect the subscription leaked

The conversion input, the output address, the QR code and any public log all fall inside the exposure scope. The full handling sequence — remove public content, rotate the token, update clients, check for anomalies and validate the old address — belongs to the subscription-leak procedure rather than being repeated here.

Scope and limits

This page provides a framework for deciding whether conversion is needed and where the trust boundary sits. It does not assess whether any specific public converter logs data, and it does not promise that any protocol converts without loss. Project documentation describes functionality; it is not an endorsement of a third-party deployment, its operator, or its logging policy.

Sources: the subconverter README for target, subscription URL and multi-subscription inputs; the Mihomo proxy-providers documentation for provider paths, filtering and health checks.