Adding an airport subscription to ClashX on a Mac is usually a short process: copy the subscription URL from your provider, add it as a remote profile in ClashX, download the profile, and select it from the menu bar. The details can vary slightly between ClashX versions, but the important distinction stays the same: importing a profile does not necessarily activate it. This guide walks through both steps, explains how to refresh the profile, and shows what to check if the URL is expired, the format is unsupported, or no nodes appear.
Before You Start
Make sure ClashX is installed and running on your Mac. You should see its icon in the macOS menu bar. If the icon is missing, open ClashX from Applications first; some versions may also need permission to run or to manage network settings. Resolve any first-launch prompts before troubleshooting a subscription.
You will also need a subscription URL from your provider. It may be labeled Subscription, Clash subscription, Subscribe URL, or Import configuration in the provider’s dashboard. Copy the complete URL, including its protocol and any characters after a question mark. A single missing character can make the address invalid.
A subscription URL is not the same as a website address or a single-node link. It typically contains a private token that allows the client to retrieve your configuration and node information. Treat it like a password: do not post it in a public forum, screenshot it, or send it to someone who does not need access.
Before importing, check that the provider offers a format compatible with your version of ClashX. A subscription may provide a complete Clash-compatible YAML profile, a converted Clash link, or links intended for another client. The word “subscription” alone does not guarantee that every client can read the returned data.
Add the Subscription URL in ClashX
In most classic ClashX releases, remote profiles are managed from the menu bar. The exact wording can differ by release, so if a label below is not present, look for an equivalent item such as Remote Config, Profiles, or Manage Configurations.
- Click the ClashX icon in the macOS menu bar.
- Open Config, then look for Remote Config or the profile-management option.
- Choose the command to manage or add a remote configuration. Some versions open a small management window; others show an add-profile dialog directly.
- Enter a recognizable name, such as the provider name or “Personal subscription.” The name is only a local label and does not change the subscription itself.
- Paste the full subscription URL into the URL field. Avoid adding quotation marks, spaces, or line breaks before or after it.
- Confirm the entry, then use the available download, update, or refresh command to fetch the profile.
Wait for the download to finish before closing the window. If ClashX reports success, return to the menu bar and check the configuration list. The profile may appear by the name you entered, by a name supplied in the downloaded file, or by a shortened form of the URL. If the first attempt fails, do not repeatedly create duplicate entries; inspect the existing profile and correct its URL instead.
Some versions do not expose a dedicated subscription manager. If your menu only offers local configuration files, consult the documentation for that exact ClashX build before attempting a manual import. A local YAML file can be opened as a profile, but that is a different workflow from configuring an automatically refreshable remote subscription.
Download and Select the Imported Profile
After adding the address, make sure ClashX has actually downloaded the remote configuration. An entry in the manager can simply mean that the URL was saved; it does not prove that the contents were fetched or accepted. Look for a successful update status, a timestamp, or a populated list of proxies, depending on the version.
Next, select the imported profile from the ClashX menu bar. The active profile is usually indicated with a check mark or another selection marker. If ClashX asks whether to replace the current configuration, verify that you are selecting the intended profile before confirming. Keep a known-good local profile, if you have one, until the new subscription has loaded and you have tested it.
Profile selection and proxy selection are separate actions. The profile supplies the configuration, groups, rules, and available proxies. Within that profile, you may still need to choose a node or proxy group. Open the menu bar controls and inspect the available groups, often shown under a Proxy or similarly named submenu. Choose an appropriate node or automatic group if the profile does not already make that choice for you.
Finally, confirm that the ClashX system proxy is enabled if you want supported Mac applications to use it. Selecting a profile alone may not route traffic. When testing, use a browser or application that follows the macOS system proxy settings. Apps with their own proxy configuration, VPN, or network stack may behave differently, so test with a second application if the first one does not connect.
| What you see | What it usually means | Next action |
|---|---|---|
| Profile listed, but no nodes | The URL may have returned an empty or unsupported configuration | Check the provider’s Clash format and refresh the profile |
| Nodes listed, but no traffic works | The profile may not be selected, or the system proxy may be off | Select a node or group and enable the system proxy |
| Update succeeds but the list is unchanged | The provider may have made no changes, or the client may be showing a cached profile | Check the update timestamp and request a fresh download |
| Subscription entry cannot be added | The address may be incomplete, invalid, or rejected by that build | Copy the URL again and verify client compatibility with the provider |
Refresh Nodes and Keep the Profile Current
Subscription profiles can change over time. A provider may add or remove nodes, update server details, change group membership, or adjust routing rules. Refreshing asks ClashX to retrieve the current version from the same URL; it does not usually require you to paste the address again.
To refresh, open the profile or remote-configuration manager from the menu bar and select the saved entry. Use its update or download command. Wait for the result, then check whether the node list or update time changed. If your ClashX version has a refresh command directly beside the profile name, use that command rather than creating a second profile with the same URL.
Refresh frequency depends on your provider and how often its configuration changes. Updating repeatedly within a short period is rarely useful and may be subject to provider-side request limits. If the provider recommends an interval, follow it. Otherwise, refresh when nodes stop working, when the provider announces a change, or when you need the latest profile—not after every connection problem.
A successful refresh may replace the existing remote configuration. If you have edited a downloaded file locally, those manual edits may be lost or may not apply to a managed remote profile at all. Keep personal changes separate, and avoid editing a provider-managed profile unless the client and provider documentation explicitly describe that workflow. When a change is necessary, ask whether the provider supports custom rules or a compatible override method.
If the refreshed profile loads but a particular node fails, test another node before assuming the subscription is broken. A single server can be temporarily unavailable even while the rest of the profile is valid. You can also verify that the Mac’s date and time are correct; significant clock errors can interfere with connections that depend on certificate validation or time-sensitive authentication.
Troubleshoot Import and Connection Problems
When an import fails, identify which stage failed: saving the URL, downloading its response, parsing the response, or using a node. This keeps troubleshooting focused. A parsing error is not fixed by repeatedly switching nodes, while an unreachable node does not necessarily mean the URL is wrong.
- “Invalid URL” or an immediate download error: Copy the link again from the provider’s dashboard. Check for a missing character, an accidental space, a truncated query string, or a link that requires you to sign in before it can be accessed. If the URL has expired, generate a new one through the provider’s official account page.
- Download works, but the profile cannot be parsed: The response may be HTML from a login page, a plain-text list intended for another client, or a format unsupported by that ClashX release. Confirm that the provider offers a Clash-compatible profile. If it provides a client-specific conversion option, use the option intended for ClashX rather than guessing at a format.
- The profile loads, but there are no nodes: Confirm that the account is active and that the provider has assigned nodes to it. Check whether the imported file contains proxy definitions or only rules and groups. A profile with no usable proxy entries cannot provide nodes for selection.
- Nodes appear, but connections time out: Try another node, verify that the profile is selected, and confirm that the system proxy is enabled. Check whether another VPN, proxy app, or network filter is competing for control. Temporarily disconnecting an overlapping tool can help isolate the cause.
- Refresh keeps failing on one network: Test the provider’s account page and subscription URL from a trusted browser connection. A captive Wi-Fi login, local firewall, or DNS problem may block the request. Do not paste the private URL into an online checker; test it only in ClashX or in a browser session you control.
- The menu options differ from this guide: ClashX releases and forks do not all use the same profile-management interface. Check the application’s version and its own documentation. Do not install an unrelated configuration tool just because its menus look similar.
When asking a provider or support channel for help, share the error message, ClashX version, macOS version, and the time of the failed update. Redact the full subscription URL, account identifier, passwords, and any authentication tokens from screenshots or logs. A useful report explains the failure stage without exposing the credential that grants access to the profile.
Protect Your Subscription URL
Because a subscription link can grant access to account resources, handle it as a credential rather than ordinary configuration text. Store it in ClashX or another trusted password-protected location. Avoid placing it in public repositories, shared documents, support screenshots, shell history, or chat messages. If you need to share a diagnostic, describe the link as “configured” and redact its hostname path or token-bearing query string where appropriate.
Be cautious with third-party URL converters and subscription-checking websites. Such services may receive and retain the complete link, even if the page claims only to test whether it works. Prefer the provider’s own conversion tool or a client-supported method. If a provider offers device-specific links, use the least-privileged option that fits your needs and revoke links for devices you no longer use.
Also distinguish between a subscription URL and an individual node configuration. A node link may contain its own credentials, while a subscription URL can expose a whole collection of nodes or repeatedly fetch updated configuration. Both deserve protection. If you believe either has leaked, contact the provider promptly, rotate or revoke the affected credential where possible, and update the saved profile in ClashX.
Frequently Asked Questions
Is a subscription URL the same as a proxy node link?
No. A node link typically describes one proxy endpoint, while a subscription URL is a provider-managed address that can return a profile containing multiple nodes, groups, and rules. Use the URL in the subscription or remote-profile manager when available. Do not paste it into a field intended for a single node.
Will ClashX refresh the subscription automatically?
That depends on the ClashX version and how the remote profile is configured. Some builds provide scheduled updates; others require you to refresh manually. Check the profile manager for an interval or automatic-update setting, and follow the provider’s guidance. If there is no such control, use the manual update command when the profile needs to be renewed.
Why does the profile load while the internet still does not work?
Loading confirms that ClashX accepted the configuration; it does not guarantee that a usable node is selected or reachable. Select a node or proxy group, enable the system proxy if needed, and test more than one node. If the issue continues, check for another VPN or network tool and confirm that the provider account is active.
Can I use a subscription made for another client?
Only if the provider’s response is compatible with the ClashX version you have. Some services offer multiple output formats, and another client’s format may not be understood by ClashX. Ask the provider for its Clash-compatible option instead of manually changing the URL or trying to convert private subscription data on an untrusted website.
Once the remote profile has downloaded, been selected, and produced a working node, everyday use is straightforward: choose the profile, select a suitable node or group, and refresh it when the provider updates its configuration. If you are setting up ClashX on a new Mac, start with a compatible client build and keep the subscription URL private from the first import.
Take Full Control of Your Traffic with Clash
Available on Windows, macOS, Linux, Android, and iOS. Flexible rules, simple setup, ready to use.