Clash 首次安裝與初始設定：跨平台通用重點與常見問題

首次設定順序：先讓設定檔運作，再接管流量

安裝完成只代表用戶端檔案已存放在裝置上，不表示代理連線已可使用。桌面用戶端通常由圖形介面和代理核心組成：介面用來管理訂閱、策略群組與開關，核心則負責解析設定檔、監聽連接埠及轉送連線。Clash Meta 後續以 mihomo 名稱維護，不同核心支援的通訊協定和欄位並不完全相同。

初次使用時請依照以下順序操作。每完成一個步驟再繼續，遇到問題時就能找出具體環節，不必同時修改 DNS、連接埠和節點。

1. 確認裝置架構，安裝相符的用戶端，並記下用戶端版本、核心名稱與核心版本。
2. 退出其他正在接管網路的代理程式，並確認裝置能正常瀏覽一般網頁。
3. 匯入訂閱或本機 YAML，選取設定檔，確認核心能否啟動。
4. 使用規則模式，並在實際承接流量的策略群組中選擇節點。
5. 桌面版先啟用系統代理；Android 則授權用戶端建立 VPN 連線。
6. 確認瀏覽器能正常連線並檢查連線記錄，最後再設定 TUN、背景執行與開機啟動。

安裝檔與權限：依平台確認必要條件

Windows：別把所有問題都歸咎於權限不足

安裝後先以一般使用者身分啟動。如果只開啟系統代理就出現本機連接埠繫結失敗，應先檢查連接埠是否被占用，而不是反覆選擇「以系統管理員身分執行」。系統代理只會變更代理入口，不會讓所有程式自動使用代理；部分遊戲、命令列工具和獨立網路元件會略過這項設定。

macOS：分辨安全性提示與檔案損毀

如果系統封鎖了 App，先確認下載來源和安裝檔架構。確認來源可信後，可前往「系統設定」→「隱私權與安全性」查看是否有允許開啟的選項。不要只為了啟動用戶端就全面關閉系統安全防護，也不要直接執行來源不明的終端機修復指令。

Android：分別處理連線權限與背景執行權限

VPN 授權負責建立流量入口，電池最佳化則會影響背景執行。如果前景使用正常，但鎖定螢幕後經常中斷，請前往「設定」→「應用程式」→選取用戶端→「電池」檢查背景限制；各廠牌系統的選項名稱可能不同。初次測試先保留預設值，確認連線穩定後再視需要放寬限制。

匯入訂閱與 YAML：確認內容、相容性及套用狀態

用戶端不會自動提供可用節點。訂閱網址通常來自既有服務的帳戶頁面，連結中可能含有存取權杖，應視同密碼妥善保管。請勿將完整網址貼到公開論壇、截圖或共用記錄中；分享截圖前也要遮蔽節點憑證。

1. 開啟用戶端的「設定檔」或「訂閱」頁面，選擇透過 URL 匯入或匯入本機檔案。頁面名稱依實際用戶端而異。
2. 等待下載完成，確認清單中出現設定檔。若下載失敗，先檢查 HTTP 狀態碼、憑證或網路錯誤，不要馬上修改規則。
3. 選取剛匯入的設定檔，將它設為目前使用的設定。成功匯入不代表已經啟用。
4. 檢查執行記錄。如果有 YAML 縮排錯誤、不支援的通訊協定或缺少策略群組，請先修正，再啟用系統代理。

常見的「設定檔格式錯誤」不一定是 YAML 本身有問題：過期的訂閱可能回傳登入頁面，某些網址提供的是其他用戶端格式，也可能只有節點清單而非完整設定檔。如果檔案開頭是 <html>，應檢查訂閱入口和帳戶狀態，而不是在檔案中多加幾行規則。

欄位不相容時，先確認目前執行的核心

能在 mihomo 中使用的通訊協定或擴充欄位，不一定能在舊版 Clash 核心中運作。請在用戶端的「關於」或核心資訊頁查看實際版本，再參照相應版本的文件。不要只根據安裝檔名稱判斷核心支援哪些功能，也不要為了通過檢查而刪除不認識的欄位。

連接埠占用：以 7890 為例檢查本機監聽狀態

以下是本機入口設定片段，7890 是本文的示範連接埠，並非所有用戶端都使用此固定值。mixed-port 可同時接受 HTTP 代理和 SOCKS 代理連線。請先在介面或目前生效的設定檔中確認實際連接埠，測試指令也必須使用相同數值。

# 僅示範本機入口欄位，並非完整訂閱設定檔
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

不要直接用這段內容取代整份訂閱檔案，否則原有節點、策略群組和規則都會遺失。若只供本機使用，請保持關閉區域網路存取；也不必為了本機測試開啟路由器連接埠或關閉整台裝置的防火牆。

Windows：先找出監聽連接埠的程序

netstat -ano | findstr :7890
tasklist /FI "PID eq 1234"

第一個指令會列出包含該連接埠的連線記錄。請找出本機位址以 :7890 結尾且狀態為 LISTENING 的列，最後一欄就是 PID。第二個指令中的 1234 僅為範例，請替換成實際 PID；確認程式身分後再正常結束，不要貿然終止系統程序。

macOS 與 Linux：檢查相同連接埠

# macOS；Linux 安裝 lsof 後也可使用
lsof -nP -iTCP:7890 -sTCP:LISTEN

# Linux
ss -ltnp 'sport = :7890'

查看其他使用者程序的資訊可能需要額外權限。如果舊版用戶端仍在背景執行，請先結束舊程序，再重新啟動目前的核心。若確實需要更換連接埠，例如改用 7892，也要同步更新手動代理設定、瀏覽器擴充功能和終端機環境變數；只修改設定檔會讓應用程式繼續連線到舊連接埠。

代理模式與 TUN：先確認規則連線正常

初次使用建議選擇規則模式。此模式會依設定檔中的規則順序，將連線交由直連、拒絕或相應的策略群組處理。全域模式會將流量交給全域策略，不會自動挑選可用節點；直連模式也不等於「中斷用戶端」，只是改變流量的處理方式。

前往策略群組查看目前的選擇。假設規則最後指向名為 Proxy 的群組，就應確認該群組最終使用的是可用節點，而不只是查看其他測試群組的延遲。介面顯示延遲數值，只代表當下可以連到特定測試目標，不表示所有網站、通訊協定和地區服務都能正常使用。

• 桌面瀏覽器測試：啟用系統代理，暫時停用會自行指定代理的瀏覽器擴充功能，再開啟需要測試的網站。
• 終端機測試：明確指定代理參數，避免將終端機未讀取系統代理誤判為用戶端故障。
• 連線記錄：在用戶端查看目標網域、符合的規則、策略群組和最終節點，確認要求確實經過預期路徑。

# Windows PowerShell，明確呼叫 curl.exe
curl.exe -I --proxy http://127.0.0.1:7890 https://example.com/

# macOS / Linux
curl -I --proxy http://127.0.0.1:7890 https://example.com/

此指令只會測試指定目標的一次 HTTP 要求。收到網站回應表示該連線路徑有結果；若連線遭拒，通常應先檢查監聽連接埠；若長時間逾時，則搭配記錄檢查節點和目標。範例網址能連線，不代表其他網址也能使用，仍須測試實際需求。

最後再啟用 TUN 模式

TUN 會透過虛擬網路介面接管路由至該介面的流量，適合處理不讀取系統代理的應用程式。實際涵蓋範圍也會受到路由、排除項目和 DNS 設定影響，不能視為必定接管所有流量。Windows、macOS 和 Linux 通常需要服務、驅動程式或系統網路權限；Android 的 VPN 介面則由系統授權管理。

只有在基本連線正常，而且確實需要接管其他應用程式時才啟用 TUN。如果啟用後無法正常存取內部網域、公司 VPN 或區域網路裝置，請先關閉 TUN 進行對照測試，再逐項檢查路由和 DNS。不要同時更換 DNS、啟用 Fake-IP 並修改多項路由設定；相關欄位請參閱YAML 手冊的 DNS 設定與Fake-IP 說明。

開機啟動與重新啟動檢查：確認介面、核心和代理狀態

開機啟動介面、啟動代理核心、啟用系統代理，通常是三種不同狀態。確認手動啟動運作穩定後，再到用戶端設定啟用相應選項。Windows 可前往「設定」→「應用程式」→「啟動」確認啟動項目；macOS 可前往「系統設定」→「一般」→「登入項目與延伸功能」查看登入項目和背景項目，名稱可能因系統版本而異。

Android 的開機啟動和背景執行限制，取決於用戶端與系統的實作方式。若需要長時間維持連線，請先確認鎖定螢幕後仍能正常存取，再考慮調整電池限制。系統提供的「永遠開啟 VPN」和「封鎖未使用 VPN 的連線」是不同選項；後者會在 VPN 無法使用時限制網路連線，啟用前請先了解影響。

首次重新啟動後逐項確認

1. 確認用戶端和核心已執行，且目前使用的設定檔仍是預期的訂閱。
2. 確認監聽連接埠未變更，規則模式和策略群組選擇仍正確。
3. 桌面版確認系統代理或 TUN 是否如預期恢復；Android 則檢查 VPN 連線狀態。
4. 分別測試一般網頁、目標服務和區域網路資源，不要只看系統匣圖示。
5. 透過用戶端正常結束程式，並確認桌面系統代理已關閉；若結束後無法上網，請檢查是否留有代理設定。

Windows 可前往「設定」→「網路和網際網路」→「Proxy」確認是否仍指向本機連接埠；macOS 可前往「系統設定」→「網路」→目前的連線→「詳細資訊」→「代理伺服器」查看。修改前請記錄原設定；尤其是由公司或組織管理的裝置，切勿覆蓋既有的組織代理設定。

完成上述確認後，再新增分流規則或調整 DNS。訂閱相關問題請參閱訂閱常見問題，模式差異請參閱代理模式教學。每次只變更一項設定，並保留可還原的正常設定檔。