How to Import a Proxy Subscription Into Clash for Android

Check the app, subscription, and file format first

A proxy subscription URL is a private address that lets a client retrieve configuration data from a provider. It is not the same as a single proxy server address: a downloaded profile may contain multiple nodes, proxy groups, routing rules, DNS settings, and update information. Clash for Android can use a profile to populate its proxy list, but the result depends on both the profile format and the proxy core bundled with the particular app build.

Check which app you have before following menu instructions. The original Clash for Android project is no longer actively maintained, and similarly named Android clients or later builds may use different menus, cores, and supported configuration fields. An old guide may say to open Profiles and tap the plus button, while another build may use labels such as Config, Subscriptions, or Add from URL. Treat those labels as examples, not guarantees. Confirm the application’s publisher, release source, and core information before importing a sensitive link.

Ask the provider for the subscription format intended for Clash or a compatible Clash-based core. Some providers offer separate links for Clash, sing-box, Shadowrocket, or other clients. Those links can return different data even when they belong to the same account. A profile written for another client may use fields or proxy protocols that your installed core does not understand.

Before importing, make sure the Android device has a working internet connection and that the provider account is active. If the provider requires a separate activation step, device authorization, or an account login, complete that first. A subscription URL can be valid in appearance but still return an authorization error when the account is expired, the token has been reset, or the provider has restricted access.

Add the subscription URL and download a profile

Copy the complete subscription URL from the provider’s account page or setup instructions. Use the copy button if available rather than selecting the address manually; long URLs can wrap across lines, and missing characters or punctuation can make the request fail. Do not remove query parameters or shorten the address unless the provider specifically instructs you to do so.

  1. Open Clash for Android and go to the profile or configuration management screen.
  2. Choose the option to add a profile from a URL. Depending on the build, it may be represented by a plus button or a menu item.
  3. Paste the full subscription URL into the URL field.
  4. Enter a short local profile name, such as the provider name or “Travel profile.” The name is only a label on your device; it does not change the remote subscription.
  5. If the screen offers an update interval, leave the default unless the provider recommends another value. Save or confirm the entry, then select the new profile and start its download.

The first download requires the phone to reach the provider’s subscription server. Keep the app in the foreground until the request completes, especially on a slow or metered connection. A successful import usually creates a profile entry and makes nodes or proxy groups available in the app. It does not necessarily mean that the proxy is already active: profile download and traffic routing are separate steps.

If the app presents a message about overwriting or replacing a profile, check whether you are editing an existing entry or creating a new one. Replacing an entry may remove local changes associated with it. If you have made manual edits, export or back up the configuration first, and check whether the client provides a separate override or merge feature. Changes made directly to a provider-managed profile may be lost when it is updated.

Some Android builds can import a local configuration file as well as a URL. Use local-file import only when the provider intentionally supplies a downloadable Clash-compatible YAML file. A file that contains a webpage, an account dashboard, or a different client’s configuration is not a usable Clash profile merely because its filename ends in .yaml.

Select a node and verify the connection

After the profile downloads, open the proxy or group screen and inspect what it contains. A provider may show individual nodes, groups such as automatic selection or regional choices, and a direct option. The group names and layout are determined by the profile; they are not necessarily the names of physical servers. If the list is empty, do not assume that repeatedly tapping the VPN switch will repair it. First confirm that the profile loaded and that the core accepted its configuration.

Choose a proxy group or a specific node, then use the client’s latency test if available. A latency result is a reachability check, not proof that all applications are being routed correctly. Some tests measure a connection to a configured test address, and providers or networks may treat that address differently from the sites you intend to use.

Next, enable the client’s connection switch. Android displays a system prompt the first time an app requests VPN permission. Review the prompt and approve it if you intend to route traffic through the client. Android generally allows only one active VPN service at a time, so disconnect another VPN app before starting Clash for Android. A work profile, device-management policy, or always-on VPN setting may also affect whether the connection can start.

Test a normal webpage or application and check the client’s connection log. Look for a new connection, the matched rule, and the selected policy or proxy group. If the connection is marked DIRECT, the profile may have intentionally routed that destination directly, or a rule may have matched before a proxy rule. If the connection is assigned to a proxy but fails, inspect the node, server response, and core log instead of changing unrelated DNS settings immediately.

For diagnosis, test more than one destination and note the time of the test. A single app may use its own proxy settings, cached connections, or a network path that does not behave like a browser. If the log shows no new connection at all, check that the client is running and that Android has not stopped it in the background. If a connection does appear, use its rule and policy details to determine whether the issue is profile routing, node availability, or the destination itself.

Refresh the subscription without losing track of changes

A subscription profile is normally refreshed by requesting the URL again. In the profile list, open the entry’s context menu or use its refresh control; exact gestures vary by build. Wait for the refresh result before switching away, and check that the profile’s update time or node list has changed when you expect it to. A refresh may return the same nodes if the provider has made no changes, so an unchanged list does not by itself indicate failure.

An automatic update interval, when supported, controls how often the app checks the URL. It does not guarantee that the provider will publish new nodes, and it should not be set unnecessarily low. Frequent requests can consume mobile data, create background activity, or trigger provider-side rate limits. Use the provider’s suggested interval where one is given. If the app is restricted by Android battery management, scheduled updates may be delayed until the app is opened.

Keep a record of any local settings that are not part of the subscription, such as a selected group, a client-side override, or an app-specific exclusion. A remote profile update may replace the generated configuration, depending on how the client manages profiles. If a setting disappears after updating, check whether it belongs in a supported override area rather than editing the downloaded subscription file directly.

  • Refresh manually after the provider announces a configuration change or after correcting an expired account.
  • Check the update time and error message rather than repeatedly tapping refresh.
  • Use a stable connection during large downloads and avoid switching networks mid-request.
  • Remove an obsolete profile only after confirming that you no longer need its URL, local settings, or troubleshooting history.

Remember that an imported URL is usually a credential. If you move to another device, use the provider’s account page to retrieve or regenerate the link rather than sending an unredacted screenshot. If the URL is accidentally shared, changing the local profile name will not invalidate it; only the provider can revoke or replace the remote token.

Troubleshoot common subscription import errors

Start with the exact error shown by the app and identify whether it happened while saving the URL, downloading the response, parsing the configuration, or starting the core. These stages have different causes. A network timeout is not the same as a YAML parsing error, and a profile can download successfully but still fail to start because it contains unsupported fields.

  • Timeout or connection failure: Confirm that the phone has internet access and can reach the provider’s service. Temporarily test another available network, such as Wi-Fi instead of mobile data. A captive portal, restrictive network, DNS problem, or provider outage can prevent the download.
  • Unauthorized or forbidden response: Recheck the account status and copy a fresh URL from the provider. The token may have expired, been reset, or reached a device limit. Do not repeatedly retry a known-invalid link.
  • Not found or redirect error: Make sure the complete URL was copied and that the provider has not changed the subscription endpoint. Some clients handle redirects differently; use the provider’s current Clash-specific link rather than guessing an alternate address.
  • HTML or unexpected content: The URL may open a login page, account page, or error page instead of returning configuration data. Sign in through the provider’s official site and copy the actual subscription address. Do not paste an account password into a URL field unless the provider explicitly documents that format.
  • YAML parse or unsupported-field error: The response may be intended for another client, contain malformed YAML, or require a newer compatible core. Ask the provider for a Clash-compatible profile and check the client’s core version and supported protocol list.
  • Download succeeds but no usable nodes appear: Check whether the profile contains proxy definitions and whether the client reports a configuration warning. A provider may also return an empty profile when the account has no enabled services or has exceeded a usage limit.

Do not send the complete subscription URL or an unredacted configuration when asking for help. A configuration can reveal server addresses, UUIDs, passwords, private keys, or account identifiers. Share the error text, app version, core name and version, Android version, and the relevant non-sensitive log lines instead. Replace credentials and tokens with placeholders before sharing any snippet.

If the provider says the format is correct but the client rejects it, compare the required core with the one installed in the app. The Clash configuration family has common sections such as proxies, proxy-groups, and rules, but support for particular protocols and newer fields varies by core. Importing the same URL into a different client can help determine whether the problem is specific to one build, but it does not prove that the link is safe or that every client will interpret it identically.

Frequently asked questions

Is it safe to share a subscription URL?

No. Treat it like a password or access token. Anyone who obtains a working URL may be able to retrieve your proxy configuration or consume the service associated with your account. Redact it from screenshots and logs, and ask the provider to revoke or regenerate it if it has been exposed.

Why does Android ask for VPN permission?

Clash for Android uses Android’s VPN service interface to establish a local VPN connection and route traffic according to the active profile. The system prompt is expected when starting this type of connection. Android normally permits one active VPN service at a time, so disconnect another VPN before testing. Grant permission only to the client you chose to use.

Can I import a sing-box or other client subscription?

Only if the provider offers a format that your installed client and core support, or a documented conversion service that produces a compatible profile. A URL’s appearance does not reveal its response format. Use the provider’s client-specific instructions and do not assume that a subscription made for one application can be parsed by another.

Why does refreshing the profile show no changes?

The provider may not have changed the configuration, or the refreshed profile may still contain the same nodes and groups. Check the last-update time and the refresh result. If the refresh reports an error, troubleshoot the URL or network response; if it succeeds, unchanged content can be normal.

Download Clash