DOCS // 使用教程

Clash 使用教程

從安裝到進階設定，全平台完整指引。無論你是初次接觸 Clash 的新手，還是需要深入定制規則分流的進階用戶，本頁均提供對應的操作步驟與設定範例。

適用版本：Clash v3.0.0+ 更新日期：2025-03-15

三步極速上手 [QUICKSTART]

Clash 是一個基於規則的網路代理用戶端，核心依賴 YAML 設定檔驅動。以下三個步驟幫助你在 5 分鐘內完成基本設定，開始使用代理。

01
下載用戶端

前往下載頁，根據作業系統選擇 Clash 用戶端。Windows 推薦 Clash for Windows 或 Clash Verge Rev，macOS 推薦 ClashX Meta，Android 推薦 Clash Meta。

02
匯入訂閱設定

在用戶端的 Profiles / 設定面板中貼上服務商提供的 YAML 訂閱連結，點擊下載，用戶端將自動解析節點、規則集與策略組，零手動操作。

03
啟動系統代理

點擊用戶端中的「系統代理」開關，立即開始享受規則分流的低延遲網路體驗。如需接管所有流量（含遊戲、終端），請參考 TUN 模式設定章節。

提示 如果你沒有節點資源，需要先從代理服務商（通常稱為「機場」）購買訂閱，獲取一個 https://... 格式的訂閱連結，才能正常使用 Clash。Clash 本身僅是免費開源用戶端，不提供任何節點或服務。

平台安裝教程 [PLATFORM]

選擇你的作業系統，查看對應的完整安裝與初始設定步驟。

Windows Clash 用戶端安裝教程

Windows 平台推薦使用經典的 Clash for Windows 或現代化的 Clash Verge Rev。兩者均完美支援 Windows 10/11，並相容所有 YAML 訂閱連結。

  1. 下載與安裝
    前往下載頁，下載 Clash for Windows 或 Clash Verge Rev 的 .exe 安裝包。執行安裝程式時，若彈出 SmartScreen 提示，請點擊「更多資訊」→「仍要執行」。
  2. 匯入訂閱設定
    Clash for Windows：點擊左側 Profiles，在頂部貼上訂閱連結，點擊 Download。下載後點擊生成的設定檔名稱啟用。
    Clash Verge Rev：點擊左側 訂閱，在頂部貼上連結並儲存，隨後點擊該訂閱條目進行啟用。
  3. 開啟代理
    Clash for Windows：在 General 頁面開啟 System Proxy 開關。
    Clash Verge Rev：在 設定 中開啟 系統代理 開關。此時狀態列圖示變色即代表代理已生效。
  4. （進階）開啟 TUN 模式
    若需代理遊戲或終端流量，請開啟 TUN 模式。 Clash for Windows 需先點擊 General → Service Mode → Install 安裝服務；Clash Verge Rev 可在設定中直接啟用 TUN 模式並授權。
系統要求 支援 Windows 10 / 11 (64-bit)。推薦系統版本 1903 以上，並確保已內建 WebView2 Runtime 環境。

macOS Clash 用戶端教程

macOS 推薦使用 Clash Verge Rev 或 ClashX Meta。兩者均支援 Mihomo 內核，適配 Apple Silicon (M1/M2/M3) 及 Intel 晶片。

  1. 下載與安裝
    前往下載頁，根據晶片類型下載 Clash Verge Rev (.dmg) 或 ClashX Meta (.zip)。拖入 Applications 資料夾完成安裝。
  2. 匯入訂閱設定
    Clash Verge Rev：在「訂閱」頁面點擊右上角「+」，貼上 URL 並儲存。
    ClashX Meta：點擊選單列圖示 → Config → Remote config → Manage，點擊 Add 貼上連結。
  3. 開啟系統代理
    點擊選單列圖示，選擇 Set as System Proxy（設置系統代理）。圖示變色即代表設定成功。
  4. （進階）開啟增強模式
    點擊選單列圖示 → Enhanced Mode（增強模式），按系統提示安裝網路擴充功能。該模式等同於 TUN，可代理全域流量。
提示 若啟動時提示「無法驗證開發者」，請前往 系統設定 → 隱私權與安全性，在頁面底部點擊「仍要打開」。

Clash Meta for Android 安裝教程

Android 平台推薦使用 Clash Meta for Android。它基於開源的 Mihomo 內核，提供比原版更強大的功能支援（如更多的加密協定）。

  1. 下載並安裝 APK
    前往下載頁，推薦下載 Universal APK（自動適配架構）。下載後執行 APK 完成安裝（需在系統設定中允許「安裝來源不明的應用程式」）。
  2. 匯入訂閱設定
    打開 Clash Meta for Android，點擊 配置 → 右上角 + → 選擇「從 URL 匯入」。貼上訂閱連結後點擊右上角儲存圖示，然後點擊啟用該設定。
  3. 啟動代理
    回到首頁，點擊右下角灰色 已停止 按鈕。在系統彈出 VPN 授權請求時點擊「確定」，按鈕變為 執行中 即可。
  4. （進階）開啟 TUN 模式
    在 設定 → 網路 中勾選 自動路由（即開啟 TUN 模式）。該模式無需系統 VPN 授權即可接管全流量（部分版本可能仍需授權）。
注意 若安裝時提示「剖析安裝包時出現問題」，請確保下載的是 Universal 版本，且 Android 版本高於 5.0。

iOS / iPadOS Clash 系用戶端教程

重要提示 由於 Apple 平台政策，iOS 上沒有名為「Clash」的官方 App，需使用相容 Clash 設定格式的第三方用戶端。以下以 Stash、Shadowrocket 和 Surge 5 為例進行說明。應用程式均需從非中國區 App Store 購買。

Stash 使用教程

  1. 在 App Store 購買並下載 Stash
    使用美區 / 港區 Apple ID，在 App Store 搜尋 Stash 並購買（約 ¥30）。
  2. 新增訂閱設定
    打開 Stash → 配置 標籤 → 右上角 + → 選擇「從 URL 匯入」，貼上訂閱連結，輸入設定名稱後點擊「完成」。
  3. 啟動代理
    切換至 主頁 標籤，點擊「連接」按鈕，iOS 系統將彈出 VPN 授權請求，點擊「允許」即開始代理。

Shadowrocket 使用教程

  1. 購買並下載 Shadowrocket
    使用美區 Apple ID，在 App Store 搜尋 Shadowrocket 並購買（$2.99）。
  2. 匯入訂閱連結
    打開 Shadowrocket → 點擊右上角 + → 類型選擇「Subscribe」→ 貼上訂閱 URL → 點擊「完成」。訂閱節點將自動解析並顯示在清單中。
  3. 啟動連接
    在節點清單中選擇一個節點，然後打開頂部 Connected 開關，點擊「Allow」授權 VPN，即開始代理。

Surge 5 使用教程

  1. 下載 Surge 5
    在 App Store 搜尋並下載 Surge 5。該應用提供 14 天免費試用，之後需購買授權。
  2. 匯入設定檔
    在首頁點擊「首選配置」→「從 URL 下載」，貼上訂閱連結並下載。
  3. 啟動代理
    點擊右上角的「啟動」按鈕並授權。Surge 5 能夠自動識別大多數 Clash 訂閱格式。

Linux Clash 用戶端教程 (GUI)

對於桌面端 Linux 用戶，推薦使用 Clash Verge Rev。它提供現代化儀表板介面與完整 TUN 模式支援，適配 Ubuntu、Debian、Fedora 等主流發行版。

  1. 下載與安裝
    前往下載頁，下載適合您發行版的安裝包（Ubuntu/Debian 選 .deb，Fedora/CentOS 選 .rpm）。使用套件管理器完成安裝。
  2. 匯入訂閱
    啟動 Clash Verge，進入「訂閱」標籤頁，點擊右上角「+」，貼上 URL 並儲存。
  3. 開啟代理
    在主介面開啟「系統代理」開關。如需全流量接管，請在設定中開啟 TUN 模式（可能需要 sudo 權限）。

Clash Core for Linux (進階/伺服器)

適合無圖形介面的伺服器環境或進階用戶手動部署。

  1. 下載並解壓內核
    下載適合架構的 .gz 壓縮包，解壓並賦予執行權限：
    $wget https://clashconf.com/assets/clients/core/mihomo-linux-amd64.gz
    $gunzip mihomo-linux-amd64.gz
    $chmod +x mihomo-linux-amd64
    $sudo mv mihomo-linux-amd64 /usr/local/bin/clash
  2. 放置設定檔
    將 config.yaml（從服務商下載，或手動編寫）放置到 Clash 設定目錄：
    $mkdir -p ~/.config/clash
    $cp config.yaml ~/.config/clash/config.yaml
  3. 啟動 Clash
    執行以下命令啟動 Clash，預設會在 127.0.0.1:9090 開啟 RESTful API：
    $clash -d ~/.config/clash
  4. 設定系統代理
    Clash 預設監聽 HTTP 連接埠 7890 和 SOCKS5 連接埠 7891。在系統網路設定或終端機環境變數中設定：
    $export http_proxy=http://127.0.0.1:7890
    $export https_proxy=http://127.0.0.1:7890
提示 如需開機自啟，可參考 Wiki 中使用 systemd 服務單元檔案註冊 Clash 為系統服務的說明。

匯入訂閱設定 [SUBSCRIPTION]

訂閱連結（Subscription URL）是服務商提供的 YAML 格式設定檔線上地址，通常以 https:// 開頭。Clash 用戶端透過此連結自動下載並解析節點列表、規則集與策略組。

什麼是訂閱連結

訂閱連結本質上是一個指向 YAML 設定檔的 URL。每次在用戶端更新訂閱時，Clash 會重新請求該 URL 獲取最新的節點資訊和規則，確保設定始終為最新狀態。

訂閱更新頻率建議

最佳實踐 建議在用戶端中設置自動更新訂閱間隔為 24h（每天一次），以保持節點資訊最新。在節點列表異常或出現大量逾時時，可手動點擊「更新」強制重新整理訂閱。

匯入步驟對照表

平台 / 用戶端 匯入路徑 啟動方式
Clash for Windows Profiles → 頂部 URL 輸入框 → Download 點擊設定檔名稱
Clash Verge Rev 訂閱 → 頂部貼上連結 → 儲存 點擊訂閱條目
Clash Meta for Android 配置 → + → 從 URL 匯入 點擊設定旁圓形按鈕
Stash / Shadowrocket 配置/首頁 → + → 貼上連結 完成後自動啟動
Clash Core (Linux) wget <URL> -O ~/.config/clash/config.yaml 重啟 Clash 進程

YAML 設定詳解 [CONFIG.YAML]

Clash 所有的行為均由 config.yaml 驅動。瞭解核心欄位含義，能幫助您精準調整代理行為、新增自定義節點並編寫高階分流規則。

基礎連接埠與執行模式

~/.config/clash/config.yaml
# HTTP proxy port
port: 7890
# SOCKS5 proxy port
socks-port: 7891
# Allow LAN devices to use proxy (true/false)
allow-lan: false
# Proxy mode: rule | global | direct
mode: rule
# Log level: info | warning | error | debug | silent
log-level: info
# RESTful API port
external-controller: 127.0.0.1:9090

代理節點（proxies）

proxies 欄位定義所有可用出站節點，支援 Shadowsocks、VMess、Trojan、VLESS、Hysteria2、WireGuard 等協定：

proxies section
proxies:
  - name: "🇭🇰 香港-01" # node display name
    type: ss # protocol: ss / vmess / trojan / vless / hy2 / wireguard
    server: hk01.example.com
    port: 8388
    cipher: aes-256-gcm
    password: "your_password"
  - name: "🇯🇵 日本-VMess"
    type: vmess
    server: jp01.example.com
    port: 443
    uuid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    alterId: 0
    cipher: auto
    tls: true

支援的協定類型

Shadowsocks (ss) ShadowsocksR (ssr) VMess VLESS Trojan Hysteria2 (hy2) TUIC WireGuard SOCKS5 / HTTP(S) Snell

策略組（proxy-groups）

策略組將多個節點按指定選擇策略進行分組，支援 select（手動選擇）、url-test（自動延遲優選）、fallback（故障轉移）、load-balance（負載平衡）四種模式：

proxy-groups section
proxy-groups:
  - name: "PROXY" # main outbound group
    type: select # manual selection
    proxies:
      - Auto-Select
      - 🇭🇰 香港-01
      - 🇯🇵 日本-VMess
  - name: "Auto-Select"
    type: url-test # auto select lowest latency
    proxies:
      - 🇭🇰 香港-01
      - 🇯🇵 日本-VMess
    url: "http://www.gstatic.com/generate_204"
    interval: 300 # test every 300 seconds

TUN 模式設定 [TUN MODE]

TUN 模式透過在作業系統中建立虛擬網卡（TUN/TAP），在內核層攔截所有 TCP/UDP 流量，包括不遵循系統代理設定的應用程式（如遊戲用戶端、命令列工具、UWP 應用程式等），實現真正意義上的全域透明代理。

何時需要開啟 TUN 模式

場景 是否需要 TUN 說明
外服遊戲加速（UDP） ✅ 需要 遊戲使用 UDP 協定，不走系統 HTTP 代理
終端機 / curl / git 代理 ⚠️ 可選 可透過環境變數 http_proxy 替代
Windows UWP 應用程式代理 ✅ 需要 UWP 應用程式沙箱機制隔離系統代理
普通瀏覽器上網 ❌ 不需要 瀏覽器自動遵循系統 HTTP 代理設定
路由器 / NAS 全域透明代理 ✅ 需要 需要接管所有裝置流量

YAML 中啟用 TUN 設定

tun config block
tun:
  enable: true
  stack: system # system | gvisor | mixed
  auto-route: true # auto add routes for TUN
  auto-detect-interface: true # auto detect outbound interface
  dns-hijack:
    - any:53 # hijack all DNS queries
dns:
  enable: true
  enhanced-mode: fake-ip # fake-ip prevents DNS leaks
  nameserver:
    - 223.5.5.5 # Alibaba DNS (domestic)
    - 119.29.29.29 # DNSPod (domestic)
  fallback:
    - tls://8.8.8.8:853 # Google DoT (for overseas)
    - https://1.1.1.1/dns-query # Cloudflare DoH
注意 在 Windows 上開啟 TUN 模式需要先在用戶端中安裝 Service Mode（以管理員權限執行 Clash for Windows 後在 General 頁面點擊 Install）。macOS 上需要在系統設定中允許安裝網路擴充功能（內核擴充功能）。

規則分流進階 [RULES]

Clash 的規則引擎是其核心優勢：透過在 rules 欄位中按優先權從高到低排列規則，精確決定每個請求走 PROXY、DIRECT 還是 REJECT。

規則類型速查

規則類型 範例 說明
DOMAIN DOMAIN,google.com,PROXY 精確匹配完整網域名稱
DOMAIN-SUFFIX DOMAIN-SUFFIX,youtube.com,PROXY 匹配網域名稱及所有子網域名稱
DOMAIN-KEYWORD DOMAIN-KEYWORD,openai,PROXY 網域名稱中包含指定關鍵字
IP-CIDR IP-CIDR,192.168.0.0/16,DIRECT 按 IP 位址段匹配
GEOIP GEOIP,CN,DIRECT 按 GeoIP 地理位置匹配，CN 為中國大陸 IP
PROCESS-NAME PROCESS-NAME,steam.exe,PROXY 按程序名稱匹配（僅桌面端）
RULE-SET RULE-SET,gfw,PROXY 引用外部規則集檔案（rule-providers）
MATCH MATCH,DIRECT 兜底規則，匹配所有未命中請求，必須放在最後

推薦規則結構範例

rules section (recommended order)
rules:
  # 1. LAN addresses - direct
  - IP-CIDR,192.168.0.0/16,DIRECT
  - IP-CIDR,10.0.0.0/8,DIRECT
  - IP-CIDR,127.0.0.0/8,DIRECT
  # 2. Block ad domains
  - RULE-SET,reject,REJECT
  # 3. Domestic sites - direct
  - RULE-SET,direct,DIRECT
  - GEOIP,CN,DIRECT
  # 4. Overseas sites - proxy
  - RULE-SET,proxy,PROXY
  # 5. Fallback rule (must be last)
  - MATCH,DIRECT
最佳實踐 推薦使用 Loyalsoldier/clash-rules 等社群維護的規則集，透過 rule-providers 欄位自動提取並按計劃更新，避免手動維護大量規則。

策略組設定 [PROXY-GROUPS]

策略組（proxy-groups）決定規則命中後實際使用哪個節點出站。合理設計策略組結構，可以實現自動選優、故障轉移、負載平衡等高階用法。

策略組類型說明

類型 說明 推薦場景
select 手動從清單中選擇節點或子組 主出站組，便於手動切換節點
url-test 定期 ping 測試 URL，自動選擇延遲最低的節點 自動選優（推薦日常使用）
fallback 順序檢測節點可用性，自動跳過失敗節點 節點穩定性保障
load-balance 在多個節點間進行負載平衡分發連線 多節點高並發下載場景

DNS 防洩漏設定 [DNS]

DNS 洩漏是指在使用代理時，DNS 查詢請求繞過代理通道，直接由 ISP 的 DNS 伺服器解析，導致存取記錄暴露。Clash 透過內建 DNS 模組與 fake-ip 模式從根本上解決此問題。

DNS 模組推薦設定

dns section
dns:
  enable: true
  listen: 0.0.0.0:53 # DNS listen port
  enhanced-mode: fake-ip # recommended: fake-ip or redir-host
  fake-ip-range: 198.18.0.0/16
  # Domestic DNS servers (queried for CN domains)
  nameserver:
    - 223.5.5.5 # Alibaba DNS
    - 114.114.114.114
  # Encrypted overseas DNS (for non-CN domains)
  fallback:
    - tls://8.8.8.8:853 # Google DNS over TLS
    - https://1.1.1.1/dns-query
  fallback-filter:
    geoip: true # use fallback DNS for non-CN IPs
    geoip-code: CN
原理說明 fake-ip 模式下，Clash 對所有 DNS 請求立即返回一個虛假 IP（來自 198.18.0.0/16 段），實際 DNS 解析在流量到達代理節點時於遠端進行，徹底防止本地 DNS 洩漏，同時大幅降低首次連線延遲。

常見問題 [FAQ]

Clash 是一個純粹的代理用戶端，本身不包含任何節點資源。它的作用是解析 YAML 設定檔、匹配分流規則，並將流量透過設定中指定的節點進行轉發。節點通常由代理服務商（俗稱「機場」）以 YAML 訂閱連結的形式提供。本站不提供、不販售任何節點或訂閱服務。
瀏覽器預設遵循系統 HTTP 代理設定，而遊戲用戶端使用 UDP 協定、終端工具不讀取系統代理，因此無法走普通系統代理。解決方案：開啟 TUN 模式（參見上方 TUN 模式章節），透過虛擬網卡在內核層接管所有 TCP/UDP 流量。
通常是規則設定問題，導致國內流量被錯誤地路由到代理節點，增加了延遲。解決方法：

1. 在規則中加入 GEOIP,CN,DIRECT 確保國內 IP 直連；
2. 引入 rule-providers，使用社群維護的 direct（國內網域名稱白名單）規則集；
3. 確保 DNS 設定中國內網域名稱走國內 DNS 伺服器解析（如阿里 DNS 223.5.5.5）。
預設設定檔路徑：

macOS / Linux：~/.config/clash/config.yaml
Windows：%USERPROFILE%\.config\clash\config.yaml

在 Clash for Windows 中，可點擊 General 頁面的「Open Clash Home Folder」按鈕直接打開所在目錄。建議使用支援 YAML 語法高亮的編輯器（如 VS Code）進行編輯，編輯後在用戶端中點擊「Reload Config」重載設定。
fake-ip：對所有 DNS 請求立即返回一個虛假 IP（198.18.x.x），實際網域名稱解析推遲到遠端代理節點進行。優點是連線建立極快、防 DNS 洩漏，推薦 TUN 模式下使用。

redir-host：在本地真實解析 DNS 後再進行規則匹配，相容性更好，但存在 DNS 洩漏風險，且首次連線有額外延遲。適合對 IP 位址有特殊需求的場景。
排查步驟：

1. 檢查訂閱連結是否完整，可直接在瀏覽器中打開驗證可存取性；
2. 確認訂閱連結未過期（部分機場訂閱有時效限制）；
3. 若網路本身需要代理才能存取訂閱地址，可在用戶端設定中啟用「透過代理更新訂閱」選項；
4. 檢查日誌（Log 頁面）中的錯誤資訊，根據報錯類型進一步處理。