Support Reference
Clash Verge Rev
FAQ and
Troubleshooting
Organized by fundamentals, installation and configuration, usage tips, and troubleshooting. First confirm the active configuration, operating mode, and scope of the issue, then use logs and connection records to narrow it down step by step.
Basic Concepts
Fundamentals
Understanding how the client, core, subscription, and operating modes relate helps distinguish configuration problems from installation problems.
What does Clash Verge Rev do?
Clash Verge Rev is a desktop graphical client built on the mihomo core. It reads subscriptions or local configurations and routes connections according to rules through direct, proxy, or reject policies. The client does not provide proxy nodes itself, so you need a valid subscription or usable Clash configuration file before getting started.
How should you choose between Rule, Global, and Direct modes?
Rule mode is usually the best choice for everyday use: traffic is matched against the rules in the configuration file from top to bottom. Global mode sends most connections through the current global policy and is useful for temporarily checking whether rules are causing a problem. Direct mode bypasses the proxy, which helps when pausing proxy use or checking the local network.
How are the mihomo core and Clash Verge Rev related?
mihomo is the core program responsible for protocol connections, DNS, rule matching, and TUN forwarding. Clash Verge Rev provides the interface for configuration management, policy selection, log viewing, and system integration. When troubleshooting, distinguish interface settings, configuration content, and core behavior, since issues in all three can look similar.
What is the difference between a subscription, a configuration file, and a proxy group?
A subscription is usually a remote configuration source that can provide updated nodes, proxy groups, and rules. The configuration file is the YAML content actually loaded by the client. A proxy group organizes multiple nodes or other policies into a selectable outbound, such as URL-test, fallback, direct, or reject.
Can a Clash iOS client use desktop settings directly?
The iOS and desktop clients have different interfaces and system permissions, but they can usually import the same subscription. Full support for a configuration depends on the client core, protocol type, scripting capabilities, and rule format. If an import fails, first check whether the subscription provider explicitly supports the iOS client you are using.
Installation
Installation & Configuration
During installation, verify the system architecture, configuration source, and required permissions. For the complete workflow, continue with the Getting Started guide.
Should you choose an installer by operating system or processor architecture?
You need to match both the operating system and processor architecture. Most Windows devices use the x64 installer; Macs with Apple silicon use ARM64, while older Intel Macs use x64. On Linux, you also need to choose the correct package format. If you are unsure, check the processor and system type in your system information.
How do you import a subscription link into Clash Verge Rev?
Open the subscription or configuration page, paste the complete subscription URL, and start the import. Wait for the client to download and parse the configuration. After importing, set it as the active configuration, then open the proxy page and choose a proxy group. If the URL came from the clipboard, check for extra spaces, line breaks, or non-ASCII punctuation.
What should you do if macOS says the app cannot be opened or lacks permission after installation?
First, make sure the app has been moved to the Applications folder, then check the Privacy & Security prompts in System Settings. macOS may require administrator approval when enabling TUN or installing a service. Do not launch multiple copies repeatedly; after granting permission, quit the client and reopen it from the Applications folder.
Why does TUN mode require administrator permission?
TUN mode creates a virtual network interface and changes system routes, which normally requires more than standard user privileges. Windows may ask you to install or start a service, while macOS and Linux may request administrator authorization. If TUN still cannot be enabled afterward, check security software, old services, and leftover virtual network adapters.
Why are Windows UWP apps not going through the proxy?
Some UWP apps are restricted from accessing loopback addresses. Even with the system proxy enabled, they may be unable to connect to a port listening on the local machine. Use Windows' loopback exemption feature to allow local loopback access for the UWP apps that need network access. Fully close and restart the affected apps afterward.
Usage Techniques
Usage Tips
Stable use depends on a clear rule order, a maintainable subscription structure, and DNS settings suited to the current network environment.
Why does the order of Clash rules matter?
Rules are normally checked from top to bottom, and matching stops after a connection hits a rule. More specific domains, processes, or rule sets should come before broader rules, with the catch-all rule at the end. After making changes, check the matched rule and final policy in the connection log instead of judging only by whether a webpage opens.
Is latency testing enough when choosing a node?
A latency test only shows whether the test target was reachable at that moment and how long the round trip took. It does not fully represent download speed, stability, or the availability of the target website. Choose nodes based on sustained access, protocol compatibility, and proxy-group test results; a single timeout does not mean a node is permanently unavailable.
Will updating a subscription overwrite a manually selected node?
Whether the selection is preserved depends on the proxy-group name, node name, and the client's cache. If an update removes a node, renames a proxy group, or changes the configuration structure, the previous selection may become invalid and fall back to the default. For long-term custom rules, use override or merge features rather than editing a local copy of the remote configuration directly.
Should you use fake-ip or redir-host for DNS?
fake-ip generally provides more complete domain mapping and rule matching, making it suitable for typical desktop use. Some programs that rely on real addresses, LAN discovery, or unusual network environments may need additional exclusions. redir-host follows a more traditional resolution flow. Before switching, keep a copy of the original configuration and check both nameserver and rule settings.
How can other devices on the LAN use this computer's proxy?
Allow LAN connections in the client, make sure the bind address is not limited to localhost, and allow the relevant port through the firewall. On other devices, enter the LAN address of the computer running Clash Verge Rev and the proxy port. Enable this only on a trusted LAN, and avoid exposing the listening port to the public internet.
Troubleshooting
Troubleshooting
First identify whether the issue occurs during subscription retrieval, core startup, system forwarding, node connection, or DNS resolution, then narrow down the cause step by step.
How should you handle an expired subscription or a failed subscription download?
First, use a browser to confirm that the subscription URL is still accessible. Then check whether the link has expired, the account is in good standing, and the system clock is accurate. If the browser can access it but the client cannot, temporarily disable the system proxy and try again. Check the logs for HTTP status codes, certificate errors, or parsing errors.
What should you check if node tests keep timing out?
First, verify that the local network can access ordinary websites directly, then update the subscription and test several different nodes. Next, check whether the current core supports the node protocol, whether the device clock is accurate, and whether DNS works. If every node times out at once, investigate the network, core startup status, and configuration syntax before replacing nodes one by one.
What should you do if the system proxy is enabled but the browser still connects directly?
Confirm that the client core is running, that the system proxy port matches the current mixed port, and that the browser has not enabled a separate proxy, proxy extension, or secure DNS setting. Some apps do not read the system proxy and need separate configuration or TUN mode. Use the connection log to confirm whether requests are reaching the client.
How can you restore network access after turning off TUN?
Fully quit the client and disable the system proxy, then reconnect to the current network. If the problem persists, disable and re-enable the physical network adapter, and check for leftover proxy addresses, default routes, or virtual network adapters. A forced shutdown while TUN is active is more likely to leave the network in an unrecovered state.
What should you do if a webpage reports a DNS resolution failure but the node connects?
A connected node only shows that the proxy server is reachable; it does not confirm that the domain-resolution path is working. Check whether DNS is enabled, whether the nameserver is reachable, whether the configuration indentation is correct, and whether fake-ip exclusions affect the target domain. After making changes, clear the system DNS cache, restart the core, and test again.