1. 安裝順序：先啟動核心，再接管流量
桌面版首次設定請依序進行：「選擇安裝檔 → 啟動客戶端 → 匯入設定檔 → 檢查本機連接埠 → 開啟系統代理 → 驗證連線」。先確認瀏覽器透過系統代理成功連線，再決定是否啟用 TUN。Android 通常透過系統 VPN 介面接管流量，設定方式與桌面版的系統代理不同。
Clash 是設定與代理生態系中常見的名稱；客戶端介面和實際處理連線的核心分屬不同層次。mihomo 是從 Clash Meta 延續發展而來的核心；不同客戶端對設定欄位、服務模式和權限的支援可能有所不同。遇到匯入錯誤時，請一併記錄客戶端名稱、版本與核心版本，不要只說「安裝了 Clash」。
- 保留原有網路設定。記下目前使用的 VPN、系統代理和手動 DNS，以免修改後無法還原。
- 一次只執行一個代理客戶端。先退出舊客戶端；首次測試時，不要同時啟用其他 TUN 或 VPN。
- 準備可用的設定檔。客戶端安裝檔通常不含可用的代理節點，訂閱需另外準備。
- 一次只修改一項設定。每次修改後查看記錄與連線資訊，避免同時變更連接埠、DNS 和規則而難以找出問題。
2. 選擇安裝檔：確認系統、處理器架構與核心支援
| 平台 | 先確認的位置 | 選擇重點 |
|---|---|---|
| macOS | 蘋果選單 → 關於這台 Mac | Apple 晶片選 arm64；Intel 處理器選 x64；通用安裝檔請依發行說明使用。 |
| Windows | 設定 → 系統 → 系統資訊 → 系統類型 | 依裝置架構選擇 x64 或 ARM64，並確認客戶端的最低系統需求。 |
| Android | 設定 → 關於手機；架構資訊請以裝置規格為準 | 多數裝置使用 arm64-v8a；舊款裝置可能需要 armeabi-v7a。不確定時請查看通用安裝檔的說明。 |
在 macOS 上，Apple 晶片裝置有時可透過 Rosetta 執行 Intel 應用程式，但首次安裝建議優先選擇原生架構，減少額外的相容性問題。Windows ARM 裝置也應先確認專案是否提供原生安裝檔，不要只憑檔名中的「64」判斷。
前往客戶端下載頁選擇對應平台，再確認專案發行說明中的系統需求。舊版 Clash 客戶端與目前的 mihomo 客戶端，對新協定和欄位的支援可能不同；檔案能匯入，不代表兩者相容。安裝前若想比較客戶端差異，可先參考選擇指南。
3. macOS：應用程式授權、系統代理與輔助服務
先移至「應用程式」，再啟動
- 開啟下載的磁碟映像，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動，避免長期直接從安裝映像執行。
- 如果系統提示無法驗證開發者，請先確認檔案來源與發行說明，再前往「系統設定 → 隱私權與安全性」查看是否出現「仍要打開」。此選項是否顯示，會因系統版本和攔截原因而異。
- 匯入設定檔並確認核心已執行後，開啟客戶端的「系統代理」功能。
- 前往「系統設定 → 網路 → 目前的網路連線 → 詳細資訊 → 代理伺服器」，檢查 HTTP、HTTPS 或 SOCKS 項目。位址通常是
127.0.0.1，連接埠應與客戶端設定一致。
如果出現「應用程式已損毀」的提示，請重新下載適用於目前系統的安裝檔，並查看專案說明。不要直接複製來源不明的終端機指令，也不要為了啟動單一應用程式而關閉整套系統安全機制。由公司管理的 Mac 可能因裝置政策而限制應用程式或網路擴充功能，請聯絡管理員處理。
TUN 授權與一般系統代理應分開處理
設定系統代理通常不需要與建立 TUN 相同等級的權限。啟用 TUN 時，客戶端可能會要求安裝輔助服務、輸入管理員密碼，或核准網路相關元件；實際方式取決於客戶端的實作。請先確認授權視窗中的應用程式身分，再依專案文件操作。服務安裝完成後仍須檢查核心記錄，不要只因密碼視窗關閉，就認定 TUN 已接管流量。
4. Windows 與 Android：代理設定和 VPN 授權
Windows：確認回送位址，不要放寬整體防火牆設定
安裝並匯入設定檔後，先開啟客戶端的系統代理，再前往 Windows 11「設定 → 網路和網際網路 → Proxy」確認手動代理是否指向目前的監聽連接埠。Windows 10 的入口通常是「設定 → 網路和網際網路 → Proxy」。部分客戶端使用自動設定指令碼，請依實際接管方式檢查，不要一律改成手動代理。
- 回送代理位址為
127.0.0.1。監聽在0.0.0.0表示繫結至所有 IPv4 介面，不應將它設為瀏覽器的連線目標。 - 出現防火牆提示時，請依用途選擇網路範圍。若僅供本機使用，就不必開放代理入口給區域網路。
- 若需要 TUN 或服務模式，請依客戶端說明安裝服務或提升權限；使用一般系統代理不代表必須一直以管理員身分執行。
Android：核准 VPN 連線，並留意背景執行情況
首次啟動代理時，Android 通常會顯示系統 VPN 連線要求。確認來源後再允許，狀態列通常會出現 VPN 圖示。這只表示 VPN 介面已建立，不能證明訂閱節點可用、規則正確或目標服務已連通。
如果其他 VPN、使用本機 VPN 的防火牆或過濾工具正在執行，請先停止它們再測試；同一使用者環境通常只能有一個作用中的 VPN 服務。若鎖定螢幕後連線中斷，請前往「設定 → 應用程式 → 對應客戶端 → 電池」檢查背景執行限制，實際路徑依手機系統而異。視需要允許背景執行，並確認客戶端是否設定了應用程式分流，以免目標瀏覽器被排除在代理範圍外。
5. 匯入設定檔與連接埠：確認核心確實啟動
在客戶端的「設定檔」或「訂閱」頁面新增遠端設定檔，貼上服務商提供的 Clash/mihomo 訂閱 URL，下載後選取並啟用。清單中出現設定檔名稱還不夠，請確認它目前已啟用，並查看記錄是否有設定檔解析失敗、協定不支援或連接埠繫結失敗等訊息。
訂閱 URL 通常包含存取憑證，請勿放進公開截圖、支援工單內容或命令歷史記錄。匯入本機 YAML 時，請優先使用客戶端的檔案匯入功能，不要直接編輯應用程式安裝目錄。訂閱更新可能會覆寫遠端設定檔，本機修改應放在客戶端支援的覆寫或合併設定中。
認識最基本的通用設定片段
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info這只是說明欄位的片段，缺少節點、策略群組和規則，不能當作完整訂閱使用。mixed-port 讓 HTTP 與 SOCKS 代理請求共用同一個連接埠；allow-lan: false 用來限制區域網路存取；mode: rule 表示依規則選擇出站方式。客戶端可能會覆寫這些欄位，最終請以執行時設定和監聽狀態為準。
遇到連接埠遭占用，先查是哪個程序
如果記錄出現 address already in use 或繫結失敗，請先退出其他代理工具。在 macOS 終端機中可執行以下唯讀查詢：
lsof -nP -iTCP:7890 -sTCP:LISTEN在 Windows 命令提示字元中查詢監聽資訊，再用輸出中的 PID 到工作管理員確認程序。下列篩選結果也可能包含其他相關連線，請進一步確認本機位址與監聽狀態：
netstat -ano | findstr ":7890"確認占用連接埠的應用程式後，請正常退出，或將新客戶端的混合連接埠改為其他未使用的值，例如 7891。修改後重新啟用系統代理，讓作業系統改用新連接埠。不要只看到 PID 就直接結束不明的系統程序。
6. 系統代理與 TUN：先用一種接管方式測試
系統代理會將代理位址提供給遵循該設定的應用程式，通常較容易用瀏覽器測試；部分命令列工具、遊戲或使用自有網路堆疊的軟體可能不會遵循系統代理。TUN 透過虛擬網路介面接管更多 IP 流量，並涉及路由、DNS 與權限，因此排除問題時需要檢查的範圍更廣。
- 桌面版第一輪測試：先關閉 TUN、啟用系統代理，再用瀏覽器檢查一項明確的連線。
- 第二輪測試：確認有應用程式不遵循系統代理後，再啟用 TUN，並查看路由建立情況與 DNS 記錄。
- Android：優先確認 VPN 是否已啟動、應用程式是否納入代理範圍，以及選取的策略群組是否正確。
系統代理與 TUN 並非一定不能同時啟用，許多客戶端能處理兩者並用；首次設定只啟用一種主要接管方式，是為了縮小問題排查範圍。TUN 也不等於全域代理：在規則模式下，流量仍會依規則選擇直連、代理或拒絕。
7. 驗證是否生效：區分接管、規則與節點問題
開啟客戶端的「連線」頁面，重新存取一個明確的網站，查看網域、命中規則與最終出站方式。只看網頁能否開啟，容易把瀏覽器快取、原本可直連的網站與代理成功混為一談。節點延遲測試成功，也只代表該次測試請求的結果，不能取代對目標服務的實際驗證。
| 現象 | 優先檢查 | 下一步 |
|---|---|---|
| 連線清單中沒有目標請求 | 系統代理、應用程式代理設定、Android 應用程式分流 | 確認請求確實進入目前使用的客戶端。 |
| 有連線記錄，但出站為 DIRECT | 目前模式與命中規則 | 確認該網域是否應直連，再調整規則或策略。 |
| 命中代理後連線逾時 | 目前選取的策略群組、節點狀態、網路連通性 | 改用已知可用的節點，並檢查錯誤記錄。 |
| 網域解析錯誤 | 目前生效的 DNS 設定與上游連通性 | 保留記錄，避免同時更換多組 DNS 設定。 |
| 退出客戶端後無法連線 | 殘留的系統代理、其他 VPN 或路由設定 | 關閉失效的代理設定，再檢查網路是否恢復。 |
若要區分瀏覽器設定與核心問題，可明確指定本機 HTTP 代理進行測試。以下指令中的位址與連接埠必須符合實際設定；測試網域僅為範例，結果只能證明這一次請求的狀況：
curl -I --proxy http://127.0.0.1:7890 https://example.com在 Windows 上使用 curl.exe，可避免部分 PowerShell 環境中同名別名造成的差異。如果明確指定代理後請求成功、瀏覽器卻失敗，請優先檢查瀏覽器擴充功能、個別代理設定，以及系統代理的參照設定；如果出現連線遭拒，先確認本機連接埠是否正在監聽，不要急著更換遠端節點。
8. 首次執行完成後的設定清單
- 記錄有效設定。記下客戶端與核心版本、使用的設定檔、混合連接埠和接管方式，日後升級遇到問題時方便比對。
- 確認設定檔更新正常。手動更新一次訂閱並確認仍可解析，再依服務商建議設定自動更新間隔。
- 視需要開啟開機自動啟動。桌面版請區分「開機時啟動應用程式」和「啟動後自動接管流量」；Android 也須留意系統的背景執行政策。
- 保持關閉區域網路存取。只有需要讓其他裝置使用本機代理時才開啟，並一併考量驗證機制、監聽位址與防火牆範圍。
- 測試正常退出流程。先關閉系統代理或 VPN，再退出應用程式；確認瀏覽器能恢復正常直連。
- 保留可重現問題的資訊。尋求協助時，請提供平台、版本、錯誤時間和已去識別化的記錄，並遮蔽訂閱憑證、節點密碼與個人瀏覽記錄。
首次安裝完成的判準是：設定檔已啟用、核心正在監聽、目標應用程式的請求出現在連線清單中、規則與出站方式符合預期，而且退出後網路可以恢復。確認這些條件後，再新增自訂規則、TUN 和更複雜的 DNS 策略，會更容易找出問題。操作路徑也可參考安裝與設定教學；遇到權限或網路異常時，請查看說明中心。