Subscription URLs Explained: How Clash Subscriptions Work

Every Clash tutorial tells you to "import your subscription", and almost none of them explain what a subscription actually is. Here is the whole secret: a subscription is a URL that returns a proxy configuration. Your provider generates the link, keeps the content behind it up to date, and your client re-downloads it periodically. That is the entire mechanism.

Understanding that one idea demystifies most of the daily workflow — why nodes appear and disappear after an update, why an expired plan makes every server time out, and why you should guard the link itself like a password. Let's unpack what travels through a subscription URL and how clients use it.

A subscription is a URL that returns a config

When your client requests the subscription URL, the provider's server responds with a document — for the clients covered on this site, typically a complete Clash/mihomo configuration in YAML. There is no magic handshake: the same link always serves the current version of your server list, assembled for your account. Because the provider controls the content, they can add nodes, retire servers or adjust rules centrally, and every user receives the changes on their next refresh.

What's inside a subscription

• Proxies (nodes): the individual servers — address, port, protocol and the credentials your account uses.
• Proxy groups: how those nodes are organized — region groups, an auto-select group, a manual selector — so you get a tidy menu instead of a flat list.
• Routing rules: which traffic goes direct and which goes through the proxy, often maintained by the provider so things work out of the box.

Exact contents vary — some subscriptions deliver only nodes and let the client supply groups and rules. These are the same building blocks you would write by hand in a config file; our YAML basics guide explains each section.

How your client uses it

1. On import, the client fetches the URL and stores the returned configuration as a local profile.
2. It merges or adapts that profile into the effective config the mihomo core actually runs.
3. On a schedule — or when you press update — it re-fetches the URL and replaces the local copy, so new nodes arrive without you touching anything.

The practical import steps for each client are covered in the subscription import tutorial.

Common subscription formats

Two families dominate. The first is the Clash/mihomo YAML format described above — the native choice for Clash Verge Rev, FlClash and CMFA. The second is the generic share-link style used by other ecosystems: a list of individual server URIs, often base64-encoded, without groups or rules. Providers usually publish one link per format; when offered a choice, take the Clash (or "Clash Meta") variant for the clients discussed here. Conversion services and some clients can translate between formats, but starting with the right link avoids the whole problem.

Where subscriptions come from

Most people get a subscription from a commercial proxy provider — also known as "airports" in the Chinese-speaking community — which generates a personal URL per account in its user dashboard. The self-hosted crowd builds the same thing manually: if you run your own servers, your "subscription" can be a config file you maintain yourself, served from a URL or simply stored locally.

Frequently asked questions

Is it safe to share my subscription link with a friend?

Treat it as sharing your account, because that is what it is. If a link does leak, reset it from your provider's dashboard — that invalidates the old URL — and re-import the new one. More habits like this are collected in our privacy and security tips.

Why did my subscription suddenly stop working?

The usual suspects: the plan expired, the provider rotated your URL, or the link was copied incompletely. Log in to the dashboard, confirm your plan status, copy the current link fresh and update the profile in your client.

Can I use one subscription in several clients at once?

Technically yes — any Clash-compatible client can import the same URL, so your desktop and phone can share one link. Whether simultaneous use across many devices is allowed is a policy question for your provider, not a technical limit of the format.