Installing the client is only the preparation stage. Before using it, import a configuration, choose a profile, define the proxy scope and check the connection status.
STEP 01
Install and launch for the first time
Install the package that matches the system and architecture. After the first launch, confirm that the main client window opens normally. Do not change the port, DNS, routing and system proxy all at once. Handle one step at a time to make issues easier to isolate.
STEP 02
Import a subscription or configuration
Add a valid URL in the subscription group and update it, or import an individual vmess, vless or trojan configuration. After importing, check that the protocol, server address, port and transport settings were recognized correctly, then select the profile to run.
STEP 03
Start the core and set the proxy scope
After starting the core, choose a system proxy, in-app proxy or routing rules according to your needs. Direct, proxy and block rules affect the final access path. For an initial setup, use the client's standard routing mode, confirm the connection, and then add custom rules.
// SUBSCRIPTION
Importing a subscription does not connect automatically
After adding a subscription URL, update it, open the relevant group and select a profile. If the update fails, first check that the URL is complete, the device time is accurate and the current network can reach the subscription source. Do not change the client, port and protocol repeatedly during one troubleshooting session, or the real fault will be difficult to identify.
View the subscription import guide
// ROUTING
Check the system proxy and routing rules separately
The system proxy determines whether an app sends requests to the client; local routing rules determine whether the client uses a direct connection, proxy or block after receiving a request. If the client is running but the browser still cannot connect, check the selected profile, local listening port, system proxy status and routing mode separately rather than watching just one switch.
Read the protocol and core reference
// UPDATE PATH
Record key settings before updating
Before a major-version update, record the subscription groups, local listening port, routing mode, DNS options and custom rules. After installing the new version, verify each setting against your current needs. If you are only troubleshooting a connection, check the client logs and error messages first; upgrading should not be the only remedy.
View troubleshooting questions