How to Use Airport Subscriptions in Clash: Refresh Guide

What an Airport Subscription Actually Does Demystified

A single-node URI such as vmess://, vless://, ss://, or trojan:// is not the same thing as a subscription and may have to be imported through a different menu. Copying a single-node link into a subscription manager can produce an empty profile or an apparently successful bring in with no selectable proxies.

Buying an airport proxy plan gives you access to a service, but it does not on its own configure every device or application. The provider typically gives you an airport subscription URL: a long HTTPS address containing an account identifier, an access token, or both.

When Clash downloads that address, the server returns a profile containing proxy nodes, proxy groups, routing rules, DNS settings, and sometimes provider-specific metadata. Clash then turns that profile into the configuration used by your browser, terminal, games, and other applications.

One more angle:This distinction explains why an account can be active while Clash still shows no usable nodes. The plan may be valid, but the URL may have been copied incorrectly, the provider may have returned a format that your selected core does not understand, or the client may still be using an old local profile.

A subscription is therefore better understood as a remote configuration feed, not as a one-time license file. The remote content can change whenever the provider adds nodes, removes an expired server, changes a certificate, adjusts traffic limits, or reorganises proxy groups.

Modern clients such as Clash Verge Rev, Mihomo Party, and other Mihomo-based applications normally separate three things: the subscription source, the downloaded profile, and the currently active profile. The source is the private URL. The profile is the local YAML or database representation downloaded from that source.

Security rule: Treat an airport subscription URL like a password. Do not paste it into a public issue, send it in a screenshot, or place it in a world-readable configuration repository.

Anyone who obtains the URL may be able to consume your traffic quota or download your full node list.

A detail worth adding:The active profile is the configuration currently loaded by the Mihomo core. If you refresh the source but do not activate the updated profile, the client may continue routing through yesterday’s node list. If you activate a profile but never refresh it, the client may keep displaying nodes that the provider has already removed.

Before troubleshooting, identify which type of link your provider gave you. A normal subscription URL often launchs with https:// and returns a full Clash-compatible profile. A conversion service URL may include parameters for a target format, rule provider, or client type.

Prepare the Client and Bring in the Subscription at a Glance

Applications that ignore system proxy settings may require TUN mode, but TUN ought to not be enabled merely because a subscription was imported. It adds a system-level routing layer and may require administrator permission, a helper service, or an approved network extension.

The the majority of dependable Clash subscription setup launchs with a clean client state. Choose one primary Clash-compatible application on the device and temporarily disable other clients that may be running a system proxy, mixed port, service helper, or TUN adapter.

Said differently:Two clients can both appear connected while competing for port 7890, rewriting the operating system proxy, or installing different virtual UIs. That creates misleading symptoms: the subscription looks correct in one UI, but applications are actually talking to another core.

Also check the device clock before importing. HTTPS certificate validation and provider-side access policies depend on reasonably accurate time. A computer several minutes behind can report a TLS failure even when the link is valid.

  1. Choose a maintained client and core. Use a current Clash Verge Rev, Mihomo Party, or another client that matches the provider’s documented format. If the provider requires Mihomo features such as Hysteria2, TUIC, rule providers, or modern DNS settings, confirm that the Mihomo core is selected somewhat than an obsolete legacy core.
  2. Copy the full URL. Copy straight away from the provider dashboard or password manager. Make sure the address begins with the expected protocol, includes all query parameters, and does not contain spaces, quotation marks, or line breaks introduced by a messaging application.
  3. Open the Profiles or Subscriptions page. Look for a control named Bring in, New Profile, Add Remote, or Subscribe. The exact label varies by client, but the correct area normally distinguishes remote URLs from local YAML files.
  4. Paste and save the address. Give the entry a recognisable name such as the provider name and plan tier. Avoid naming every profile “config.yaml”; plain names make it easier to identify an old test link when several profiles exist.
  5. Download the profile and inspect the result. A successful download ought to show a recent refresh time, a non-zero proxy count, and visible proxy groups. If the client offers a preview, check that it contains sections such as proxies, proxy-groups, or rules instead of an HTML failure page.
  6. Activate the downloaded profile. Select the new profile and use Set Active, Use, or the equivalent action. Importing a profile and activating it are separate operations in numerous Clash clients.

Corporate Wi-Fi, hotel networks, and captive portals deserve special attention as well. If a network first requires you to accept a login page, Clash may receive HTML instead of YAML. The bring in button can still report a generic download failure because it expected configuration text but received a portal page.

In practice that means:After activation, open the Proxies page and choose a proxy group. Numerous providers include a group named Proxy, 节点选择, Auto, or Fallback. The group may initially be set to DIRECT, which means Clash is working but deliberately sending traffic outside the proxy.

Select a real node or an automatic group, then test a straightforward website before testing a demanding application. A successful profile download does not prove that every node is reachable; it only proves that the provider endpoint returned data.

System proxy mode is typically sufficient for browsers and applications that respect operating-system proxy settings. The mixed port, commonly shown as 7890 or another configured value, accepts HTTP and SOCKS-style traffic through one local listener. Terminal tools can use that listener through environment variables such as HTTP_PROXY and HTTPS_PROXY.

Use a controlled test: First test the active node with a browser and the client’s built-in connectivity check.

Then test the exact application that failed. This separates subscription problems from capture problems, DNS problems, and application-specific proxy behaviour.

Refresh Profiles Without Creating Duplicates Broken Down

The wrong endpoint may still return text, but it may contain unsupported fields or a completely different configuration model. If you are unsure, download the response once and ask the provider which target format matches your client.

Worth noting:A good Clash subscription refresh workflow keeps the private URL steady while replacing the downloaded content on a predictable schedule. Do not add the same URL again every time the provider publishes a change.

Repeated bring ins create duplicate profiles with similar names, and eventually you may activate an old copy by mistake. Keep one remote entry per plan unless you intentionally maintain separate provider formats for different clients.

The majority of clients expose a manual refresh action beside the remote profile. Use it after the provider announces a node change, after a plan renewal, or when the client shows stale traffic information. A number of applications also support an automatic refresh interval.

One more angle:A daily interval is typically reasonable for a normal personal plan; a shorter interval may waste requests or trigger provider rate limits, while a highly long interval leaves expired nodes in the local profile. Follow the provider’s recommended interval instead of assuming that more frequent refreshs are always better.

Automatic refresh requires more than an open Clash window. If the client is fully closed, its background service must be enabled for scheduled downloads to execute. Sleep mode, battery optimisation, firewall rules, and a disconnected network can all postpone the refresh.

What you observe Likely explanation First action
Refresh time never changes Scheduled task is disabled, the client is closed, or the URL request failed Execute a manual refresh and read the result message
Refresh succeeds but nodes remain unchanged The provider returned the same list, or an old profile is still active Compare the profile timestamp and activate the refreshed copy
Nodes disappear after refresh The provider removed expired nodes or the response is filtered by a target format Check the provider dashboard and inspect the downloaded profile
Traffic quota looks wrong A duplicate client or profile is using the same subscription Disable unused clients and review active devices in the provider portal

On Windows, a service-mode client may continue working in the background. On macOS, a login item or helper may be needed. On Android, battery restrictions can stop background work even though the profile refreshs correctly when you open the application by hand.

A detail worth adding:Do not edit the downloaded profile casually if it is managed by a remote subscription. Manual changes may be overwritten during the next refresh, and editing a generated YAML file can break anchors, indentation, proxy groups, or rule providers.

If you need a persistent customisation, use the client’s override, mixer, or patch feature when available. A small override can select a preferred group or change a local DNS setting without modifying the provider’s source. Keep local changes documented so you are able to remove them when diagnosing a provider-side issue.

When a provider gives separate URLs for different clients, choose the endpoint intended for Mihomo or Clash Meta somewhat than blindly using the first link on the page. A number of dashboards provide a universal link, a Surge link, a sing-box link, and a legacy Clash link next to one another.

Diagnose Missing Nodes, Expired Links, and Empty Profiles From the Ground Up

If system proxy mode works but a terminal or game does not, the subscription is probably healthy and the missing piece is application capture. In that case, configure the application’s proxy variables or evaluate TUN mode separately.

Said differently:When a Clash subscription fails, begin with the smallest useful question: did the client reach the provider URL, and what did the server return? An failure such as timeout, connection refused, DNS failure, HTTP 403, or HTTP 410 points to different causes. A timeout often indicates network reachability or DNS trouble.

A 403 may indicate that the URL was revoked, the account is not authorised, or the provider blocks the current network. A 404 or 410 commonly means the endpoint expired. A successful HTTP response containing a login page means a captive portal or reverse proxy intercepted the request.

Copy the URL into a private browser window only if you understand the security implications and the browser is not going to sync its history or URL to a shared account.

In practice that means:A safer method is to use the client’s built-in response preview or a local command that does not print the full URL to a shared terminal history. Do not post the full address when asking for help. Redact the hostname path and every token-like query value before sharing logs.

If the profile downloads but the node count is zero, inspect the raw response format. A valid YAML profile generally has a recognisable top-level structure. If the content begins with <html>, <!DOCTYPE html>, or a human-readable account message, the provider did not return a Clash configuration.

If it is a base64-encoded list of node URIs, the endpoint may be intended for a different client or may require a conversion step. If the YAML contains nodes but no groups, the profile may be a node-only export that needs local groups or a provider-side conversion template.

Worth noting:Missing nodes can also be intentional. Providers often use region filters, device limits, expiry dates, or traffic tiers to decide which nodes appear. A plan that previously included a large list may show fewer entries after renewal because the account moved to another product.

Compare the provider dashboard with the profile returned to Clash. If the dashboard shows the nodes but the downloaded profile does not, confirm that no country, keyword, or “exclude unavailable nodes” filter is active in the subscription URL.

Expired links require account-side action somewhat than repeated clicking in Clash. Renewing a plan may extend the same URL, or the provider may issue a new token for security reasons. After renewal, check whether the dashboard displays a “reset subscription,” “refresh token,” or “copy new link” control.

Do not confuse a dead node with a dead subscription. A profile can download normally even when several individual servers are offline.

Test multiple nodes, check the client connection log, and verify the selected proxy group before replacing a private URL or buying another plan.

One more angle:Replace the remote URL only when the provider confirms that the old one is no longer valid. Repeatedly retrying a revoked endpoint cannot restore access and may cause temporary rate limiting.

For a profile that refreshs successfully but cannot connect to whichever node, check the core log and the device clock, then test DNS resolution and local port availability. A port conflict may prevent the core from listening even though the graphical UI says “running.” Another VPN, antivirus web shield, Docker service, or previous Clash installation may already occupy the configured mixed port.

Protect the URL and Maintain a Recoverable Setup Demystified

This is much faster than debugging a configuration that combines an old profile, an old override, a new core, and several competing network services.

The subscription link controls access to a valuable account resource, so handle it with the same care as an API key. Store it in a password manager or an encrypted note, and avoid leaving it in plain text inside cloud documents, screenshots, shell history, bug reports, or shared team chat.

A detail worth adding:Browser extensions and clipboard managers can also retain copied URLs. After importing the link, plain the clipboard if your operating system or security policy requires it.

Use the provider’s account panel to monitor traffic and active devices. Unexpected consumption may mean that the URL leaked, a family member imported it elsewhere, or an old client is still running in the background.

If you suspect exposure, revoke or rotate the subscription token instead of merely changing the active node. After rotation, remove the old remote profile from every device and confirm that the new URL works before deleting your backup notes.

Said differently:Keep a small recovery record that does not expose the token itself. Record the provider name, plan type, supported client format, preferred refresh interval, and whichever local override files. Export custom rules separately from the provider profile.

This makes migration easier when moving from Clash for Windows to a maintained Mihomo client, reinstalling an operating system, or setting up a second device. Never assume that a copied local YAML file can replace the private subscription forever: it may contain old credentials, expired nodes, and no future refreshs.

Review the setup after a major client upgrade. A new core may change the handling of DNS, TUN mode, rule providers, or transport settings. Launch with the provider’s unmodified profile, confirm that a normal browser request works, and then reapply local overrides one at a time.

Frequently Asked Questions at a Glance

Is it safe to share a Clash subscription URL with support? at a Glance

Do not share the full URL unless you have explicitly revoked it and the provider confirms that it is no longer usable. The address may function as a bearer credential and can expose your node list, account quota, or renewal status.

In practice that means:For troubleshooting, share the client name, core version, HTTP status, redacted hostname, and a short failure message. Replace the path and query token with placeholders such as https://example.invalid/subscription/REDACTED.

Why does Clash still show old nodes after I click Refresh? in Short

The refresh may have refreshed a remote entry that is not currently active, or the provider may have returned an unchanged profile.

Check the remote profile’s timestamp, compare the proxy count, and explicitly activate the refreshed profile. Also verify that another Clash client is not running in the background and presenting a separate node list.

What ought to I do when the subscription downloads but contains zero nodes? Decoded

Check the raw response for an HTML failure, account message, or a format intended for another application. Then review provider-side expiry, traffic limits, region filters, and client-format settings.

If the dashboard shows a valid plan but the endpoint still returns an empty profile, ask the provider for a fresh Mihomo or Clash-compatible link somewhat than repeatedly importing the same response.

Do I need TUN mode to use an airport subscription? in Practice

No. System proxy mode is sufficient for browsers and numerous applications that honour operating-system proxy settings. TUN mode is useful when an application ignores those settings, but it requires more permissions and can introduce DNS or routing interactions.

Worth noting:Confirm that the subscription and normal proxy mode work first, then enable TUN only for a specific coverage requirement.

Numerous lean proxy managers and legacy Clash forks make subscription handling look simpler than it really is: they may hide whether a profile was refreshed, whether the active core changed, or whether a private URL was stored securely. Generic VPN dashboards can be easier for one-click use, but they often expose less detail when a node disappears or an application bypasses the proxy. Clash keeps the workflow transparent with plain profile management, practical Mihomo compatibility guidance, and troubleshooting steps that distinguish an expired link from a local port or capture problem. If you want a maintained Clash setup where importing, refreshing, and checking an airport subscription remain understandable, download Clash and apply the workflow above.