Frequently Asked Questions FAQ

Installation & Startup

Q: Cannot open after installation, showing "from an unidentified developer"?

A: This is a macOS security mechanism. Solutions:

1. Open "System Preferences" → "Security & Privacy"
2. Under "General" tab, click "Open Anyway"
3. Or execute in Terminal: sudo xattr -r -d com.apple.quarantine /Applications/ClashX.app

Q: Which macOS versions are supported?

A: ClashX supports macOS 10.15 Catalina and higher. Both Intel and Apple Silicon (M1/M2/M3) chips are supported.

Q: How to uninstall ClashX?

A: Drag ClashX.app from Applications folder to Trash, then clean up config files: ~/.config/clash/

Configuration & Connection

Q: How to import subscription links?

A:

1. Click ClashX icon in menu bar
2. Select "Config" → "Remote Config" → "Manage"
3. Click "Add", paste subscription link
4. Give the subscription a name, click "OK"

Q: Cannot connect, showing "Proxy server connection failed"?

A: Possible causes and solutions:

• Subscription link expired: Try updating subscription config
• Node info outdated: Contact service provider for latest config
• Network issue: Check local network connection
• Firewall blocking: Check firewall settings
• System proxy not set: Make sure "Set as system proxy" is checked

Q: Some websites cannot be accessed or load slowly?

A:

• Try switching to different nodes
• Check if rule configuration is correct
• Try switching proxy mode (Global/Rule/Direct)
• Check if website blocked the proxy IP

TUN Mode

Q: What is TUN mode? Why is it needed?

A: TUN mode can proxy traffic from all applications, including those that don't respect system proxy settings. Suitable for scenarios requiring global proxy.

Q: Cannot enable TUN mode?

A: TUN mode requires administrator privileges. Solutions:

1. Click ClashX icon in menu bar
2. Select "Enhanced Mode"
3. Enter administrator password to authorize
4. If still failing, try restarting ClashX

Q: Network issues after enabling TUN mode?

A: Some applications may be incompatible with TUN mode. You can:

• Try adding exception rules in config
• Temporarily disable TUN mode
• Check DNS configuration

Performance & Optimization

Q: ClashX using too much memory?

A: Normally ClashX uses 50-200MB memory. If abnormally high:

• Check number of rules, too many rules increase memory usage
• Check number of subscription nodes
• Try restarting ClashX
• Update to latest version

Q: How to improve connection speed?

A:

• Use latency test to select fastest node
• Configure url-test auto-select group
• Select geographically closer nodes
• Avoid using crowded nodes during peak hours
• Consider using dedicated line nodes

Q: Cannot access Dashboard?

A: Make sure:

• ClashX is running
• Access correct address: http://127.0.0.1:9090/ui
• Check external-controller setting in config file
• If secret is set, need to enter it in Dashboard

Rules & Traffic Splitting

Q: How to add custom rules?

A: Edit config file (~/.config/clash/config.yaml), add rules in the rules section. For example:

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - DOMAIN-KEYWORD,google,🚀 Proxy
  - GEOIP,CN,DIRECT

Q: Some websites using wrong policy?

A:

• Check rule order, rules match from top to bottom
• Add more specific rules to the front
• Use Dashboard to view actually matched rules
• Clear DNS cache and retry

Q: How to block ads?

A: Add REJECT rules in config file:

rules:
  - DOMAIN-KEYWORD,adservice,REJECT
  - DOMAIN-SUFFIX,doubleclick.net,REJECT
  - DOMAIN-KEYWORD,analytics,REJECT

Or use ready-made ad blocking rule sets.

Troubleshooting

Q: "Port already in use" error?

A: Other applications are using the proxy port. Solutions:

1. Find process using the port: lsof -i :7890
2. Stop that process or change ClashX port
3. Modify port and socks-port in config file

Q: DNS resolution failed?

A:

• Check if DNS configuration is correct
• Try changing DNS servers
• Check enhanced-mode setting
• Temporarily disable fake-ip mode

Q: ClashX not working after macOS update?

A:

• Check if there's a new version of ClashX
• Re-grant necessary permissions
• If using TUN mode, re-grant administrator privileges
• Check GitHub Issues for known issues

Getting Help

If the above answers cannot solve your problem: