· 入門指南 · 約需閱讀 12 分鐘
首次安裝 Clash 用戶端：跨平台初始設定與常見問題排除
從安裝檔選擇、首次啟動授權，到連接埠與流量模式設定，整理五大平台的初始設定步驟，並說明權限、資安軟體攔截及連接埠占用等常見問題。
1. 安裝前：確認平台、架構與設定檔來源
首次安裝 Clash 用戶端前，先確認三件事：裝置使用的作業系統、處理器架構，以及是否已取得可用的設定檔。安裝用戶端只會提供本機代理入口，不會自動建立可連線的代理節點。若沒有設定檔，反覆切換系統代理或 TUN 模式通常也無法解決問題。
Clash 是代理核心及其相關生態系的常見稱呼；用戶端負責管理設定檔、選擇節點及調整系統設定。Clash Meta 後來更名為 mihomo，是這個生態系中的一種核心。不同用戶端可能採用不同核心，不能只因介面相似，就認定設定欄位完全通用。匯入前請查看用戶端的「關於」或核心資訊，記下用戶端與核心版本，方便排查問題時一併提供。
| 平台 | 確認位置 | 安裝檔選擇與注意事項 |
|---|---|---|
| Windows | 「設定」→「系統」→「系統資訊」→「系統類型」 | x64 處理器優先選擇 x64；ARM 裝置優先選擇支援的 ARM64 套件。系統版本需求請以用戶端的發行說明為準。 |
| macOS | 蘋果選單 →「關於這台 Mac」 | Apple 晶片選擇 arm64，Intel 處理器選擇 x64；Universal 套件是否適用，請以產品提供的發行檔案為準。 |
| Android | 系統「設定」→「關於手機」，並參考產品支援說明 | 新款裝置多採用 arm64-v8a，但處理器支援 64 位元不代表系統一定能執行 64 位元應用程式；不確定時，請選用產品提供的通用 APK。 |
| iOS | 「設定」→「一般」→「關於本機」 | 請從 App Store 取得明確支援所需設定檔格式的用戶端，並先確認所需 iOS 版本及目前是否能在商店下載。 |
| Linux | 在終端機執行 uname -m | x86_64 對應 x64，aarch64 對應 ARM64；deb、rpm、AppImage 則需依發行版選擇。 |
2. 首次啟動：依用途分開處理授權
首次啟動時，先確認介面能正常開啟，再匯入設定檔，最後視需要啟用系統代理或虛擬網卡。桌面版的系統代理、核心啟動及 TUN 服務所需權限各不相同；不要把所有權限提示都當成必須授予管理員權限。
Windows 與 macOS
- Windows：如果 TUN 功能提示要安裝服務或要求管理員權限，請先確認提示中顯示的程式路徑。一般介面操作不應靠長期使用管理員帳戶來解決。若 Windows 安全性封鎖檔案，請到「病毒與威脅防護」→「保護歷程記錄」查看項目詳情，不要一開始就關閉整套即時防護。
- macOS：若系統阻止應用程式啟動，請先確認下載來源及產品支援的系統版本。若來源明確且確實需要執行，可依系統提示檢查「系統設定」→「隱私權與安全性」。不要為了略過提示而全面關閉系統安全機制。
- 服務權限：部分用戶端會透過輔助服務設定路由。服務安裝失敗時，請查看用戶端的服務狀態與記錄；系統代理可以啟用，不代表 TUN 所需服務也已安裝。
Android、iOS 與 Linux
- Android：首次啟動代理連線時，通常會出現系統 VPN 連線要求，請確認發出要求的是剛安裝的用戶端。先中斷其他占用系統 VPN 連線名額的應用程式，包括部分本機防火牆與流量過濾工具。
- iOS：首次連線時，請依系統提示加入 VPN 設定檔並完成裝置驗證。VPN 權限與匯入訂閱是兩回事：訂閱匯入成功後，仍須啟動連線。
- Linux：圖形介面用戶端的系統代理可能依賴桌面環境；TUN 通常則需要額外權限或服務。請依產品說明設定服務，不要直接遞迴放寬整個用戶端目錄的權限，也不要預設以 root 執行整個圖形介面。
手機透過系統允許的 VPN 擴充功能或服務處理連線，不需要讓應用程式一直停留在前景。若 Android 在鎖定螢幕後中斷連線，可檢查「設定」→「應用程式」→對應用戶端→「電池」中的背景限制，實際名稱會因廠牌而異。iOS 請先檢查 VPN 狀態與用戶端連線記錄，不能用「禁止清除背景應用程式」取代連線問題排查。
3. 匯入設定檔：先確認內容，再啟動連線
- 進入用戶端的「設定檔」或「訂閱」頁面，使用「新增」、「加入」或匯入功能。不同產品的選單名稱可能不同，目標都是建立一筆設定檔記錄。
- 貼上服務提供者提供且相容的訂閱連結，或選取本機 YAML 檔案。不要把帳戶管理網頁網址當成訂閱連結。
- 等待下載與解析完成，確認更新時間、節點清單及代理群組是否出現。只看到訂閱記錄名稱，並不能證明設定檔已可使用。
- 將這筆設定檔設為目前使用項目；若用戶端將「下載」與「啟用」分開，還須另外啟用。
- 開啟「代理」頁面，在設定檔提供的選擇群組中挑選節點，再測試連線。
訂閱更新失敗時，先確認錯誤發生在哪個階段：下載逾時屬於取得階段；收到登入頁、驗證碼頁或錯誤提示頁，則是回應內容有問題；只有出現 YAML 行號或欄位型別錯誤，才需要排查設定檔解析。不要把所有失敗都歸咎於節點失效。
在本機編輯 YAML 時，請使用空格縮排，不要混用 Tab。含有 proxy-providers 或 rule-providers 的設定檔，也可能需要下載遠端資源，因此主要設定檔匯入成功後，仍須確認提供者已載入。舊版核心可能無法辨識某些新欄位；請核對設定檔需求與核心支援能力，不要為了消除錯誤提示而任意刪除欄位。
4. 初始參數：混合連接埠、規則模式與本機監聽
桌面版初次設定時，建議先建立簡單的連線流程：確認目前設定檔有效、核心正在執行、選好規則模式，並確認本機監聽連接埠，最後再啟用系統代理。Android 與 iOS 通常透過用戶端的連線按鈕啟動系統 VPN，不必照搬桌面版的系統代理開關。
| 設定項目 | 初次設定建議 | 需了解的限制 |
|---|---|---|
| 混合連接埠 | 查看用戶端顯示的實際值，本文以 7890 為例 | 同一連接埠可接收 HTTP 與 SOCKS 代理要求；7890 並非所有用戶端的固定值。 |
| 流量模式 | 選擇「規則 / Rule」 | 依規則決定直連、代理或拒絕；仍須在代理群組中選擇可用的出口節點。 |
| 系統代理 | 桌面版視需要啟用 | 只會影響遵循系統代理設定的應用程式，無法保證所有程式都會經過代理。 |
| 允許區域網路連線 | 沒有分享需求時請關閉 | 避免讓同一網路中的其他裝置連入代理入口。 |
| TUN 模式 | 確認桌面版基本連線正常後再啟用 | 需要相應權限，也可能與現有 VPN、虛擬網卡及路由設定衝突。 |
規則、全域與直連模式的差異
「規則」會依目前設定檔的比對順序選擇出口；「全域」會將交由核心處理的流量送至全域選擇群組；「直連」則由本機直接連線至目標。全域模式不會自動讓未使用系統代理的應用程式接入核心。若某個網站無法連線，可暫時切換模式以協助判斷是否為規則問題，測試完後請切回原模式，不要把全域模式當成接管所有系統流量的開關。
最小設定片段的用途
以下內容僅用來說明 mihomo 常見欄位，不是可直接連線的完整設定，也不應直接取代訂閱內容。連接埠請以本機實際設定為準；圖形介面用戶端可能會產生或覆寫這些欄位。
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info127.0.0.1 代表本機迴路位址。代理連接埠與控制器連接埠用途不同，不要把控制面板使用的控制器位址填入瀏覽器代理伺服器設定。初次安裝也不需要對區域網路裝置開放控制器。
5. 驗證順序：核心、指定代理、瀏覽器
不要只看系統匣圖示或連線開關來判斷是否成功。請依照下列順序測試，每次只變更一個條件。先確認記錄沒有載入設定檔或監聽失敗，再確認已選取節點，最後比較指定代理要求與瀏覽器的連線結果。
發出一次要求，確認本機連接埠
以下命令假設混合連接埠確實為 7890。Windows PowerShell 請使用 curl.exe，避免部分環境將 curl 解讀成其他命令。macOS、Linux 則使用 curl。命令最多等待 15 秒，不會變更系統代理。
# Windows PowerShell
curl.exe -I --proxy http://127.0.0.1:7890 --max-time 15 https://example.com
# macOS / Linux
curl -I --proxy http://127.0.0.1:7890 --max-time 15 https://example.com- 連線遭拒：優先檢查核心是否正在執行、連接埠是否輸入錯誤，以及用戶端是否只在其他位址監聽。
- 只看到 CONNECT 成功提示：HTTP 代理通道可能已建立，但仍須確認目標網站有後續回應，不能據此判定整個 HTTPS 要求已成功。
- 收到目標網站回應：表示這次透過本機代理發出的要求已完成；回傳 403 等狀態也可能是目標網站的政策所致，不代表所有網站都能存取。
- 逾時或 TLS 錯誤：請參照用戶端記錄，檢查節點、DNS、系統時間及目標網站；不要直接停用憑證驗證。
指定代理要求成功但瀏覽器失敗時，請優先檢查瀏覽器代理擴充功能、自訂代理及系統例外清單。瀏覽器能連線但終端機直接要求失敗，也不一定是用戶端故障：終端機工具通常不會讀取桌面系統代理設定。可改用命令的 --proxy 參數，或為明確支援代理環境變數的工具另外設定。
延遲測試只反映用戶端對特定測試位址的測量結果，不等於下載速度，也無法證明所有網站都能連線。確認代理群組中已選取節點後，再查看「連線」頁面或記錄中的規則與出口資訊，判斷該要求實際經過哪條路徑。
6. 初次安裝常見問題：依症狀排查
連接埠遭占用：同一位址只能由一個程序監聽
如果記錄出現 address already in use 或綁定失敗，請先關閉舊的代理用戶端、重複啟動的核心，以及占用相同連接埠的除錯工具。Windows 可執行 netstat -ano | findstr :7890，查看本機位址、狀態與 PID；不要把只出現在遠端位址中的 7890 誤認為監聽程序。macOS 可執行 lsof -nP -iTCP:7890 -sTCP:LISTEN；Linux 可執行 ss -ltnp 檢查監聽狀態，查看程序詳細資訊可能需要額外權限。
確認程序身分後再停止，不要直接結束不明系統程序。若改用 7891，必須確認新連接埠未被占用，並同步修改系統代理、瀏覽器自訂代理及測試命令。只修改用戶端連接埠，其他應用程式仍會連到舊位址。
介面能開啟，核心卻無法啟動
先查看記錄，確認問題是執行檔遺失、架構不相容、設定檔解析失敗，還是權限不足。安全工具隔離核心時，介面可能仍能正常啟動，因此還須檢查保護歷程記錄與用戶端核心路徑。確認來源、警示詳情及產品說明後，再處理對應檔案；不要將整個下載資料夾長期加入排除清單。
啟用 TUN 後斷網或無法連線內網
先關閉 TUN，恢復先前已驗證成功的系統代理連線方式。接著檢查其他 VPN 是否仍在執行、輔助服務是否正常、路由是否涵蓋公司內網，以及 DNS 設定是否與目前網路衝突。TUN 涉及路由與名稱解析，單獨複製一段 tun: 設定，無法保證適用所有平台與網路。公司裝置請先遵守管理政策，不要為了測試而強行修改受管理的路由。
關閉用戶端後，瀏覽器仍無法連線
這類情況通常需要檢查是否殘留系統代理，而不是重新安裝瀏覽器。Windows 11 可查看「設定」→「網路和網際網路」→「Proxy」中的手動 Proxy；macOS 可查看「系統設定」→「網路」→目前使用的網路→「詳細資訊」→「Proxy」。若仍指向已停止的本機連接埠，請還原安裝前的設定。由組織管理的 PAC 或代理位址，請勿自行刪除。
7. 安裝完成檢查清單與後續維護
- 確認安裝檔架構正確，用戶端與核心都能啟動，且記錄中沒有持續重複的錯誤。
- 確認目前設定檔已啟用、代理群組中有可選節點，且訂閱提供者資源已載入。
- 記下實際使用的混合連接埠與目前流量模式，避免把本文範例連接埠當成本機固定值。
- 桌面版請完成一次指定代理測試與一次瀏覽器連線測試；手機版請檢查系統 VPN 狀態，並實際開啟目標頁面。
- 重新啟動裝置後，確認用戶端是否依預期在開機時啟動，以及系統代理或 VPN 狀態是否與用戶端一致。
- 保留安裝前的代理設定記錄與設定檔副本，並確認中斷連線後可以恢復正常上網。
首次成功連線後，再決定是否啟用開機啟動、自動更新訂閱及 TUN。訂閱更新頻率依服務提供者要求設定，不需要每分鐘更新來解決連線問題。升級用戶端前，請記下版本與目前設定；升級後先確認設定檔載入、連接埠監聽及常用應用程式運作正常，再恢復複雜規則或區域網路分享。
需要求助時，請提供作業系統版本、處理器架構、用戶端版本、核心版本、操作步驟，以及錯誤發生時間前後的記錄。說明「指定代理正常，但瀏覽器失敗」比只說「無法連線」更有助於找出問題。分享記錄與截圖前，請移除訂閱憑證；若問題只發生在特定網站，也請說明是否僅在規則模式下出現。