Why can't ClashX connect?

Common reasons ClashX cannot connect include: 1) nodes have failed or the server is unavailable; 2) the subscription link has expired or been blocked; 3) DNS resolution failed; 4) local network issues; 5) proxy configuration errors; 6) the firewall is blocking the connection; 7) certificate verification failed; 8) the port is already in use. Follow the diagnostic process to check each item one by one.

How can I tell whether the issue is with the node or the configuration?

You can tell by: 1) testing latency for all nodes; if all time out it is probably a configuration issue; 2) switching between different nodes; if some work, it is a node issue; 3) opening the proxy server address directly in a browser to see if it is reachable; 4) checking ClashX logs for the exact error.

How do I fix DNS resolution failures?

To fix DNS resolution failures: 1) change the DNS servers in your configuration file; recommended options include 223.5.5.5 (AliDNS), 119.29.29.29 (Tencent DNS), or 1.1.1.1 (Cloudflare); 2) clear the system DNS cache with sudo dscacheutil -flushcache; 3) restart ClashX; 4) enable Fake-IP mode to improve resolution speed; 5) check whether DNS traffic is being hijacked or polluted.

What should I do if certificate errors prevent websites from loading?

To fix certificate errors: 1) click ClashX menu -> Certificate -> Install Certificate; 2) open Keychain Access and find the ClashX CA certificate; 3) double-click the certificate and expand Trust; 4) set 'When using this certificate' to 'Always Trust'; 5) restart the browser. If a specific site still has problems, add a rule to send that domain DIRECT.

How do I handle subscription update failures?

To handle subscription update failures: 1) verify the subscription link is still valid and confirm with your provider; 2) make sure your local network is working normally; 3) try updating the subscription through another node; 4) disable the system proxy before updating; 5) manually download and import the config file; 6) if the subscription has expired, renew it or switch providers.

What if the firewall is blocking ClashX?

To allow ClashX through the firewall: 1) open System Preferences -> Security & Privacy -> Firewall; 2) click Firewall Options; 3) make sure ClashX is in the allowed list; 4) if it is not, click + to add ClashX.app; 5) set it to Allow incoming connections; 6) click OK to save. Restart ClashX afterward.

How do I detect and fix port conflicts?

To handle port conflicts: 1) check port usage with lsof -i :7890 (HTTP) and lsof -i :7891 (SOCKS5); 2) if the ports are occupied, identify and stop the conflicting process; 3) or change the port numbers in the ClashX config file to avoid the conflict; 4) common conflicts come from other proxy tools or local development servers. It is best to close other proxy tools before using ClashX.

What if I still can't connect after trying everything?

Final steps: 1) fully reset ClashX by deleting ~/.config/clash; 2) reinstall the latest version of ClashX; 3) try Enhanced Mode (TUN mode); 4) check macOS version compatibility; 5) search GitHub Issues for similar cases; 6) contact your proxy provider to confirm the account status; 7) submit a detailed bug report to the ClashX GitHub repository and attach the log files.

ClashXが接続できない？10の一般的な問題の完全修正ガイド

問題診断プロセス

ClashXが接続できない場合、体系的な診断プロセスにより問題を迅速に特定できます。正しいトラブルシューティング順序に従うことで、間違った方向に時間を無駄にすることを避けられます。

クイック診断チェックリスト

まず以下の基本チェックを行ってください：

ネットワーク接続

他のWebサイトにアクセスできるか

ClashXステータス

アプリが正常に動作しているか

プロキシ設定

システムプロキシが有効か

ノードステータス

選択したノードが有効か

エラーメッセージの確認

ClashXのエラーメッセージは重要な手がかりを提供します：

ログ確認手順

1. メニューバーのClashXアイコンをクリック

2. 「ヘルプ」＞「ログを表示」を選択

3. 「error」「failed」「timeout」を含む行を探す

4. エラーコードとタイムスタンプを記録

🔍

診断のヒント

消去法を使ってください：すべてのノードが接続できないか、特定のノードだけかをテストします。これにより、ノードの問題かローカル設定の問題かを判断できます。

接続障害のトラブルシューティング

一般的な接続エラータイプ

異なるエラーメッセージに基づいて適切な対策を取ってください：

エラータイプ	症状	考えられる原因	Solution
Connection timeout	長時間待機して応答なし	ノード障害またはネットワーク遮断	ノードを切り替え
Connection refused	即座に拒否される	ポートが間違っているかサービスが実行されていない	ポート設定を確認
Authentication failed	認証失敗プロンプト	パスワードまたはキーが間違っている	サブスクリプションを更新または設定を変更
ネットワーク到達不能	ネットワーク到達不能	ローカルネットワークの問題	ネットワーク接続を確認

Node Connection Testing

Systematically test node availability:

Click "Proxy" > "Benchmark"
Wait for all nodes to complete testing
Select node with lowest latency
If all nodes fail, update subscription

Subscription Update Issues

If connection issues are caused by subscription:

🔄

Subscription Refresh Steps

1. Check if subscription link is valid
2. Manually update subscription config
3. If update fails, contact service provider
4. Backup plan: use backup config file

🛡️ おすすめ：NordVPN

ClashXはプロキシサービスと組み合わせて使用します。NordVPNは60カ国以上の高速・安定した接続を提供し、最も人気のある選択肢の一つです。

NordVPNの特典を見る →

アフィリエイトリンク · 広告開示

DNS問題の解決

DNS障害の症状

DNS問題は通常以下の症状を示します：

Webページに「ドメイン名を解決できません」と表示
IPはpingできるがドメインにアクセスできない
一部のWebサイトは動作し、一部は動作しない
接続速度が異常に遅い

DNS設定の変更

ClashXのDNS設定を最適化してください：

推奨DNS設定

dns:
  enable: true
  ipv6: false
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16

  # Primary DNS for mainland China
  nameserver:
    - 119.29.29.29
    - 223.5.5.5
    - 114.114.114.114

  # Encrypted international DNS
  fallback:
    - tls://1.1.1.1:853
    - tls://8.8.8.8:853
    - https://dns.google/dns-query

  # Traffic routing rules
  fallback-filter:
    geoip: true
    geoip-code: CN
    ipcidr:
      - 240.0.0.0/4
      - 0.0.0.0/32

DNSキャッシュのクリア

システムとClashXのDNSキャッシュをフラッシュしてください：

キャッシュクリアコマンド

# Clear macOS system DNS cache
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

# Restart ClashX to clear the app cache

DNSリークテスト

DNSが正しく動作しているか確認してください：

🧪

DNSテスト方法

dnsleaktest.comにアクセスして、DNSクエリが適切にプロキシされているか確認してください。表示されるDNSサーバーが設定と一致しない場合、DNSリークが発生しています。

Certificate Error Handling

Certificate Error Types

Certificate issues you may encounter when accessing HTTPS websites:

🔐

Common Certificate Errors

• Certificate expired
• Certificate not trusted
• Certificate domain mismatch
• Man-in-the-middle attack warning

Install ClashX Certificate

Steps to resolve certificate trust issues:

Click ClashX menu > "Certificate" > "Install CA Certificate to System"
Enter administrator password to confirm installation
Open "Keychain Access" app
Find ClashX CA certificate
Double-click certificate, expand "Trust" option
Set "When using this certificate" to "Always Trust"

Certificate Issue Troubleshooting

If problems persist after installing certificate:

Check if system time is correct (certificates are time-sensitive)
Regenerate and reinstall certificate
Check if other security software is interfering
Try disabling HTTPS decryption feature

Special Website Certificate Issues

Some banking or payment websites may be incompatible with HTTPS decryption. You can add DOMAIN rules to let these websites go DIRECT, bypassing proxy.

🏄 台数無制限：Surfshark

1つのアカウントですべてのデバイスをカバー。Mac、スマートフォン、ルーターで同時に使いたい方に最適です。

Surfsharkの特典を見る →

アフィリエイトリンク · 広告開示

Network Configuration Issues

System Proxy Settings Check

Verify macOS system proxy configuration:

HTTP Proxy

127.0.0.1:7890

HTTPS Proxy

127.0.0.1:7890

SOCKS5 Proxy

127.0.0.1:7891

Firewall Configuration

Ensure firewall doesn't block ClashX:

Firewall Settings Steps

1. Open "System Preferences" > "Security & Privacy"

2. Click "Firewall" tab

3. Click "Firewall Options"

4. Ensure ClashX is allowed to accept incoming connections

Port Conflict Check

Check if ClashX ports are occupied:

Check Port Commands

# Check port usage
sudo lsof -i :7890
sudo lsof -i :7891
sudo lsof -i :9090

# If a port is occupied, change it in the ClashX configuration

VPN Conflict Issues

Running multiple proxy tools simultaneously may cause conflicts:

⚠️

Avoid VPN Conflicts

When using ClashX, it's recommended to close other VPN or proxy tools (like ShadowsocksX, V2RayU, Surge, etc.). If you must use them simultaneously, ensure they use different ports.

Advanced Troubleshooting

Complete ClashX Reset

When other methods don't work, try complete reset:

Reset Steps

# 1. Completely quit ClashX
# 2. Delete the configuration files
rm -rf ~/.config/clash

# 3. Delete the log files
rm -rf ~/Library/Logs/ClashX

# 4. Restart ClashX
# 5. Add the subscription or configuration again

💾

Important Reminder

Be sure to backup your configuration files and subscription links before resetting! You can copy ~/.config/clash directory to a safe location.

Reinstall ClashX

If the app itself has problems:

Completely quit ClashX
Move ClashX.app to Trash
Empty Trash
Download latest version from official GitHub
Install and reconfigure

Use Enhanced Mode

If system proxy mode doesn't work, try enhanced mode:

⚡

Enhanced Mode Benefits

Enhanced mode can capture traffic from apps that don't follow system proxy settings. Check "Enhanced Mode" in ClashX menu to enable.

Seek Help

If above methods don't solve the problem:

Search GitHub Issues for similar problems
Join Telegram community for help
Contact your proxy service provider technical support
Provide detailed log information for diagnosis

Resource	Purpose	Link
GitHub Issues	Report bugs and issues	github.com/ClashX-Pro/ClashX
Official Documentation	View detailed documentation	clash.wiki
Community Forum	共有 experiences	Various tech forums

この記事は役に立ちましたか？

✓ ✓ フィードバックありがとうございます！

タグ： ClashX トラブルシューティング接続 DNS 証明書