Clash 全平台
安裝與設定指南

通用準備事項

用戶端、核心與訂閱

Clash 生態系中的用戶端負責提供介面、儲存設定並呼叫系統網路功能；核心則負責解析設定、比對規則並建立連線。下載用戶端不代表已取得可用的代理服務。實際連線還需要有效的節點設定或訂閱連結，以及允許使用該服務的網路環境。建議先前往用戶端下載頁選擇適用平台的程式，再準備服務商提供的訂閱。Windows、macOS、Android 和 iOS 可優先查看 Clash Plus；Linux 可先查看 Clash Verge Rev。名稱相近的程式不一定使用相同核心，設定是否相容須視實際支援的協定與欄位而定。

訂閱可能是完整的 Clash YAML 設定，也可能只包含節點，或須透過服務商指定的格式入口匯入。匯入前請確認連結用途，勿將帳戶管理頁面、付款頁面或網頁分享網址當成訂閱連結。連結通常包含帳戶識別資訊，應比照密碼妥善保管。排查問題時只需描述回應狀態與錯誤文字，勿將完整網址貼到公開討論區；設定截圖也請遮住節點密碼、權杖與管理介面金鑰。若網址已公開，請優先至服務商後台重設，再更新用戶端中的舊資料。

系統架構與安裝範圍

下載前先確認系統架構與安裝套件類型。Windows 常見 x64 與 ARM64；Mac 須區分 Apple Silicon 和 Intel；Android 要確認 ARM64、ARM 或通用套件；Linux 則須考量發行版的套件格式。處理器架構與系統位元數無法只靠裝置外觀判斷，請優先查看系統「關於」頁面或執行系統指令。下載頁列出的套件才是本站提供的範圍；若某用戶端沒有對應架構的下載選項，應改用支援該裝置的用戶端，不要將其他平台的檔案改名後嘗試安裝。

匯入訂閱與首次檢查

在用戶端的設定或訂閱頁面新增項目，選擇透過 URL 匯入，貼上連結後執行下載。成功後先確認是否出現設定名稱、更新時間與代理群組，再將這份設定設為目前使用項目。有些用戶端將「新增項目」和「啟用設定」分成兩個步驟，只完成下載並不會切換正在執行的設定。若匯入本機檔案，請保留原始檔案作為備份；直接編輯用戶端產生的執行設定，可能在下次更新時遭到覆寫。若要長期修改，請使用用戶端支援的覆寫、合併或指令碼機制。

匯入失敗時，先檢查裝置時間、基本網路與連結是否完整。訂閱伺服器若回傳網頁，用戶端通常會顯示解析錯誤；這與節點是否連得上是兩回事。勿將所有失敗都歸咎於格式，也不要反覆更換核心來掩蓋帳戶過期問題。請先確認訂閱仍有效，再查看用戶端記錄中的網路錯誤或欄位提示。若所在環境須透過代理才能更新訂閱，請先使用既有可用設定建立連線；首次安裝且無法連線時，可依服務商允許的方式下載設定檔，再匯入本機。

代理群組、模式與驗證順序

首次連線建議使用規則模式，並在設定提供的選擇群組中手動選取可用節點。全域模式可用於短時間比對，但會改變原本直連的請求路徑；直連模式則不會使用代理節點。延遲測試只反映測試位址的連線狀況，不代表所有網站都能正常存取，也不代表實際下載速度。先開啟熟悉的網站，再查看連線記錄中的規則與出口；確認請求經過目標代理群組後，再考慮更換地區、協定或測試位址。節點選擇的考量可參閱延遲、倍率、地區與協定比較。

Windows 安裝與設定

下載、安裝與移轉

前往Windows 下載區，先查看 Clash Plus，再依需求比較 Clash Verge Rev、FlClash 和 Clash Nyanpasu。下載前至「設定 → 系統 → 關於」確認系統類型，並依下載頁實際提供的安裝套件選擇。安裝時留意目標資料夾與權限提示，完成後從開始功能表啟動。若使用免安裝版，請解壓縮至穩定的本機資料夾，不要直接在壓縮檔預覽中執行，也不要放在會自動清除的暫存資料夾。安全軟體出現提示時，先確認檔案來源與具體行為，不建議直接關閉整個防護系統。

Clash for Windows 已停止維護，封存版本較適合了解舊環境，不建議作為新裝置的預設選擇。移轉至仍在維護的用戶端時，先備份訂閱網址、規則修改與代理群組選擇，再退出舊程式並關閉其系統代理。不同用戶端的資料庫與介面設定未必相通，較可靠的移轉方式通常是重新匯入訂閱，而非複製整個程式資料夾。舊設定若使用特定指令碼或欄位，請逐一確認新核心是否支援；介面主題、快速鍵與啟動設定通常都需要重新設定。

匯入訂閱與系統代理

在設定頁新增訂閱、執行更新並啟用後，前往代理頁選擇規則模式與可用節點。接著在設定或首頁開啟系統代理，並確認用戶端顯示的監聽連接埠。Windows 系統代理主要影響遵循系統代理設定的程式，不會自動接管所有網路流量。若瀏覽器裝有獨立代理擴充功能，可能會覆蓋系統設定；排查時請先讓瀏覽器使用系統代理，避免兩組設定同時生效。其他 VPN、加速器或舊用戶端也可能反覆改寫代理位址，驗證前請先退出這些程式。

可在 Windows 的「網路和網際網路」設定中，確認手動代理位址是否指向本機，以及連接埠是否與用戶端一致。若位址指向本機但程式已退出，瀏覽器會嘗試連線至不存在的服務，表面上就像網路完全中斷。此時先關閉系統代理以恢復基本網路，再重新啟動用戶端。不要因為瀏覽器能開啟網頁，就認定設定必然正確：請求可能走直連，也可能命中快取。開啟用戶端的連線清單，觀察新請求對應的規則與策略，才能更清楚判斷實際路徑。

TUN、服務模式與權限

若要處理不遵循系統代理的軟體，可在用戶端支援的情況下啟用 TUN。它透過虛擬網卡與路由接管流量，所需權限通常高於一般系統代理。有些用戶端須先安裝輔助服務，有些則需要管理員授權；請以目前介面的提示為準。啟用後，檢查記錄是否回報建立網卡、新增路由或設定 DNS 失敗。長期以管理員身分執行整個介面不一定是最佳做法；若用戶端提供服務模式，請依說明設定服務，再確認服務是否正常啟動。

TUN 與其他 VPN 同時執行時，可能會爭用預設路由；企業安全軟體也可能限制虛擬網卡。測試前先記錄原有 VPN 與網路設定，再暫時只保留一個流量接管工具。若啟用 TUN 後無法上網，先關閉 TUN，確認系統代理是否仍正常，再分別檢查權限、路由與 DNS。若系統代理可用但 TUN 不可用，通常不必重新購買訂閱或反覆重裝用戶端；這表示節點連線可能正常，問題較可能出在本機流量接管層。

UWP 回送與命令列代理

部分在 Windows 應用程式容器中執行的程式，無法直接存取本機代理連接埠，因此可能出現瀏覽器可用、商店應用程式卻失敗的情況。先確認該應用程式是否屬於受限制的應用程式容器，再考慮使用用戶端提供的回送豁免工具。不要一次開放所有應用程式的存取權，僅為明確有需求的應用程式設定即可。TUN 是另一種處理方式，但仍須有用戶端與系統環境支援，並檢查路由。一般桌面軟體、瀏覽器擴充功能衝突與應用程式容器限制並非同一種問題，不能只因為是「從商店下載的程式」就認定必須豁免。

命令列工具不一定會讀取 Windows 系統代理。可先用明確指定參數的方式測試本機 HTTP 代理，並將下方連接埠替換為用戶端實際顯示的數值。使用 curl.exe 可避免部分 PowerShell 環境中同名別名造成混淆。若明確指定代理後測試成功，但一般呼叫失敗，應查看該工具支援的環境變數或設定，而不是繼續修改訂閱。

curl.exe --proxy http://127.0.0.1:7890 --head https://example.com

開機自動啟動與退出後恢復

手動連線確認正常後，再啟用開機自動啟動，並分別確認「啟動用戶端」、「啟動核心」和「恢復系統代理」的實際作用。登入時啟動不等於以系統服務啟動，輔助服務也不一定會替你選擇設定。重新啟動後，檢查系統匣圖示、目前設定與代理開關，再發出請求驗證。退出程式前可先關閉系統代理與 TUN，尤其是移轉或解除安裝時；若解除安裝後仍無法上網，請優先檢查殘留的系統代理與 VPN 路由，不要立刻重設所有網路設定。

macOS 安裝與設定

晶片選擇與首次啟動

開啟「關於這台 Mac」查看晶片或處理器資訊，再前往macOS 下載區選擇安裝套件。Clash Plus 是優先推薦的選項，Clash Verge Rev 和 FlClash 也可列入考慮；ClashX Meta 已停止維護，使用封存版本時請留意相容性。Apple Silicon 與 Intel 的安裝套件不能只憑檔案大小判斷。系統是否允許透過相容層執行其他架構的程式，須視應用程式本身的需求而定；若有原生套件，請優先選擇對應架構。安裝前先退出舊用戶端，避免兩個選單列程式同時監聽連接埠或設定代理。

常見的安裝方式是開啟磁碟映像檔，將應用程式拖曳至「應用程式」資料夾後再啟動。不要長期從映像檔中執行，否則卸載映像檔、重新啟動或更新時，可能會找不到程式。首次開啟時若出現安全提示，先確認下載來源，再依系統「隱私權與安全性」中的指示允許執行。不要為了單一應用程式關閉整體系統安全機制。若提示應用程式已損毀，請先重新下載並確認系統相容性，不要立刻執行網路上的批次解除限制指令；這類指令可能影響超出預期範圍的檔案。

啟用設定與網路服務代理

在設定頁匯入訂閱後，選取目前設定，再到代理頁選擇規則模式與節點。開啟系統代理後，請確認目前使用的網路服務：Wi-Fi、有線網卡、擴充基座介面與其他網路位置可能各自有不同的代理設定。有些用戶端會代為設定目前服務，但切換網路後仍應確認設定是否一致。若瀏覽器能上網、終端機卻失敗，先確認兩者是否都會讀取系統代理，不要將兩個應用程式的結果視為相同的網路路徑。

在系統設定的網路詳細資料中，確認網頁代理、安全網頁代理或 SOCKS 代理是否符合用戶端的監聽設定。若使用混合連接埠，它可以接收 HTTP 與 SOCKS5 請求，但兩種協定仍須填入正確的系統欄位。位址通常是本機回送位址，不應填入訂閱伺服器網址；訂閱網址用來取得設定，並非本機代理服務的監聽位置。更換用戶端後尤其要重新確認連接埠，不能直接沿用舊軟體的預設值。

輔助服務與 TUN 接管

TUN 或增強接管通常需要額外的網路權限，有些用戶端會安裝輔助服務。授權前請確認正在要求權限的程式，並確認它來自剛安裝的用戶端。授權後若開關立即回到關閉狀態，請查看記錄中的服務連線、網卡建立與路由資訊。選單列顯示程式正在執行，不代表輔助服務一定可用；更新、移動應用程式位置或還原備份後，服務與主程式也可能出現不一致。建議優先使用用戶端提供的服務檢查與修復功能。

公司裝置的管理政策可能限制代理、網路擴充功能或輔助服務，反覆點擊開關無法解決這類限制。請在裝置管理政策允許的範圍內使用用戶端。其他 VPN、虛擬機器軟體與容器網路也可能新增路由；啟用 TUN 後若只有部分網段異常，先觀察受影響的目標位址與現有路由。不要直接清除系統的所有路由；先退出其他網路接管程式進行比對，既能保留問題線索，也方便還原原本的工作環境。

終端機、DNS 與網路切換

終端機工具通常需要明確指定代理。以下指令僅用於確認本機監聽與請求路徑，連接埠以用戶端顯示為準；第二條指令會讀取目前的系統代理資訊，不會修改設定。若請求成功，接著再依各工具支援的方式設定代理。將變數寫入 shell 設定檔會影響後續的終端機工作階段，因此請先在目前視窗暫時測試，並確認退出用戶端時如何清除，避免開發工具持續連線到已關閉的本機連接埠。

curl --proxy http://127.0.0.1:7890 --head https://example.com
scutil --proxy

切換 Wi-Fi、連接手機熱點或從睡眠狀態喚醒後，用戶端可能需要重新建立連線。先確認本機基本網路，再檢查核心與代理開關；若只有網域名稱無法存取，請查看 DNS 記錄與目前網路的解析設定。飯店或公共網路可能要求先完成網頁認證，此時可暫時關閉代理以開啟認證頁，完成後再恢復。不要因為某個網路的認證頁無法開啟，就長期修改所有網路的 DNS，以免將局部問題擴大到其他環境。

登入時啟動、移轉與解除安裝

若要登入時啟動，請在用戶端設定與系統登入項目中確認實際狀態。關閉視窗可能只是隱藏介面，通常須透過選單列操作才能真正退出；判斷是否仍在代理，應查看核心與監聽狀態，而非桌面上是否還有視窗。移轉至其他用戶端前，請備份訂閱與本機規則，並關閉舊程式的系統代理。解除安裝時依用戶端提供的方式移除輔助服務，之後確認目前網路服務是否仍保留本機代理設定。只有在發現明確殘留時才處理對應項目，無須為一次軟體移轉重建整個網路環境。

Android 安裝與設定

安裝套件架構與用戶端選擇

先前往Android 下載區查看 Clash Plus，再依設定需求選擇 Clash Meta for Android、FlClash 或 Surfboard。ARM64 適用於相應的 64 位元環境，ARM 套件適用於對應環境；若用戶端有提供通用套件，也可供不確定架構的裝置選用。硬體支援 64 位元，不代表系統一定允許安裝所有 ARM64 應用程式；舊裝置或特殊系統仍須確認實際執行環境。若出現「無法安裝」，先檢查系統相容性、剩餘空間與簽章衝突，不要反覆重新命名同一個套件再安裝。

透過安裝檔更新應用程式時，套件名稱與簽章必須和原應用程式相符。不同分支或不同簽章的套件可能無法覆蓋安裝；解除安裝前請先備份訂閱與本機修改，因為應用程式資料可能隨解除安裝一併刪除。系統要求授權安裝來源時，只需授權實際用來開啟安裝檔的檔案管理員或瀏覽器，安裝完成後即可收回權限。不同 Android 品牌的選單位置各異，但檢查重點都是來源權限、應用程式相容性與既有安裝紀錄，不是關閉所有安全提示。

訂閱、作用中設定與規則

前往設定頁，透過遠端訂閱入口新增連結並下載，接著明確選取要執行的設定。下載成功後先開啟代理頁，確認是否出現預期的代理群組與節點，再啟動連線。Clash Meta for Android 與 FlClash 的入口名稱可能不同，但操作順序相近：取得設定、設為作用中項目、選擇策略、要求系統授權。Surfboard 的設定格式與 Clash YAML 並不相同，使用時應取得服務商明確支援的格式，勿匯入不相容的檔案後再試圖靠切換模式修復。

遠端更新通常會取代訂閱內容，本機重新命名、追加規則與選取狀態是否保留，取決於用戶端的實作方式。若要長期維護規則，應使用用戶端支援的獨立覆寫或本機設定，並在更新後確認實際生效結果。服務商有時會調整代理群組名稱，舊選擇可能因此失效；若列表中仍有節點，卻沒有預期的出口，請先檢查目前群組的引用關係。不要只檢查單一節點的測試按鈕，也要確認最終規則確實指向該群組。

VpnService 授權與接管範圍

Android 通常透過系統 VpnService 將流量交給用戶端。首次連線時會跳出 VPN 連線要求，確認後系統可能顯示鑰匙或 VPN 狀態圖示。這只代表系統允許建立本機接管通道，不代表代理節點已成功連線。若拒絕授權，可再次點選啟動並查看系統提示；若裝置處於工作設定檔、受管理模式，或已有永遠啟用的 VPN 政策，是否允許新連線將由系統政策決定。不要把政策限制誤認為訂閱格式錯誤。

同一使用者環境通常只能有一個作用中的 VpnService 服務，廣告過濾器、防火牆或其他 VPN 也可能使用相同的接管入口。測試時先關閉其他相關應用程式，再啟動目前的用戶端。若有依應用程式代理功能，請仔細區分「僅代理選取的應用程式」和「排除選取的應用程式」；兩種清單的意義相反，很容易將需要使用代理的程式排除。修改清單後，有些用戶端須重新連線才會套用；驗證時請重新開啟目標應用程式並查看新的連線記錄。

背景常駐與螢幕關閉後斷線

若安裝成功且螢幕亮起時可用，關閉螢幕一段時間後卻失效，請優先檢查電池最佳化與背景限制。前往系統應用程式資訊頁允許背景活動，並依品牌系統提供的入口設定電池最佳化例外、自動啟動或背景鎖定。這些選項不一定全都存在，也不保證任何情況下都能常駐，請以裝置實際狀況為準。系統通知中的前景服務提示通常與持續執行有關，不建議只為隱藏狀態而任意停用必要通知。背景限制與通知權限是不同設定，排查時請分別記錄。

可進行一次可重複的測試：連線後記錄時間，關閉螢幕，稍後重新開啟同一個應用程式查看是否恢復，再檢查用戶端記錄是否出現重新啟動或網路切換。若程序仍在執行，卻只在行動網路下失敗，應改查流量權限、數據節省設定與網路狀況；若程序已消失，則較可能是系統回收程序所致。相關操作可參閱VpnService 授權與省電白名單說明，但實際選單請依目前裝置查找。

熱點分享、DNS 與中斷後恢復

手機上的 VPN 狀態不代表透過熱點連線的其他裝置也會使用該代理。熱點轉送的流量可能不在應用程式 VpnService 的接管範圍內，不能只憑手機本身能上網就判定分享成功。若要讓平板使用電腦代理，請依區域網路分享方式設定平板的代理位址與連接埠，並確認電腦允許連線。Android 的私人 DNS、瀏覽器安全 DNS 與用戶端 DNS 也可能使用不同的解析路徑；只有發生明確的網域錯誤時才逐項比對，不要一次關閉所有解析功能。

退出、解除安裝或移轉前，先停止目前的連線，並確認系統 VPN 頁面是否仍有需要處理的設定。保留備份時，只儲存必要的訂閱與本機規則，不要將含帳戶資訊的匯出檔留在共用儲存空間或會自動公開的資料夾。完成移轉後，重新確認應用程式代理範圍與背景權限；舊用戶端的系統權限通常不會自動轉移至新用戶端。

iOS 安裝與設定

商店安裝與裝置相容性

iPhone 和 iPad 可從iOS 下載區前往 Clash Plus 的商店頁面，也可直接查看Clash Plus App Store 詳細資訊。官方網站為 clashplus.io，如需確認產品入口，可核對此網域。安裝前請查看商店顯示的裝置與系統相容性，系統需求以商店目前資訊為準，不要沿用其他平台安裝套件的需求。安裝完成後先開啟應用程式，再準備匯入訂閱；若系統中已有 VPN 設定，請先記下原有用途與連線狀態。

本頁說明的是裝置上的用戶端與系統連線設定，代理服務仍須有有效設定。商店安裝成功、應用程式能開啟、節點能連線，是三個不同的檢查項目。若應用程式無法開啟，先檢查裝置儲存空間、系統相容性與安裝狀態；若應用程式能開啟但訂閱下載失敗，請檢查連結與網路；若訂閱已有節點但連線失敗，再檢查授權與節點連線。依此順序排查，可避免把安裝問題擴大成帳戶或網路全面重新設定。

匯入、更新與選取訂閱

在 Clash Plus 中找到設定或訂閱入口，依目前介面提供的方式新增遠端連結。貼上前請確認複製的是完整訂閱網址，而不是訊息中的說明文字；下載完成後查看設定是否已啟用，並確認代理群組是否出現。若介面支援匯入檔案，可使用服務商提供的相容設定檔。連結回傳的格式須符合目前用戶端支援的格式，不能因名稱中都有 Clash 就認定任何訂閱都能使用，尤其是含有較新協定或核心專用欄位的設定。

更新訂閱前，先記下已選取的代理群組與必要的本機設定。設定更新可能造成節點更名、群組調整或規則變更，更新後應確認是否仍選取原本預期的出口。訂閱若有多個選擇群組，請查看最終請求會比對哪個群組，而不只是到首頁選一個看起來延遲較低的節點。自動選擇群組也可能依測試目標重新挑選出口；若要固定地區或連線方式，應使用設定提供的手動選擇群組，並確認規則確實引用該群組。

VPN 授權與連線狀態

首次啟動連線時，應用程式可能會要求新增 VPN 設定，系統也會要求確認或裝置驗證。完成授權後返回應用程式繼續連線，並查看系統設定中的 VPN 狀態。這個系統入口是接管流量的權限，不是向代理服務商提交帳戶密碼的步驟。若授權視窗未出現或連線立即中斷，先確認系統是否已有其他作用中的 VPN、管理政策或待確認的設定，再檢查應用程式內的錯誤訊息。反覆匯入相同訂閱通常無法解決系統權限問題。

iOS 的連線路徑與桌面系統代理不同，通常依賴系統允許的網路延伸功能。下文提到的桌面 TUN 開關、服務安裝與命令列環境變數，不應直接套用到手機。若應用程式提供隨選連線、規則或其他網路選項，請依目前功能說明設定；啟用前先了解其在 Wi-Fi、行動網路與裝置鎖定時的行為。已有企業 VPN 或受管理設定的裝置，應遵守裝置管理要求，不要為了讓兩個接管工具同時執行而刪除工作所需的設定。

Wi-Fi、行動網路與網域排錯

首次驗證時可先使用穩定的 Wi-Fi，選擇規則模式與一個可用節點，再開啟目標網站並查看連線記錄。接著切換至行動網路進行相同測試。若只有其中一種網路失敗，先檢查該網路的基本連線與應用程式的行動數據權限；若兩種網路都失敗，而其他裝置使用相同節點正常，請再檢查目前裝置的設定與授權。切換網路會中斷既有連線，請分別記錄短暫重新連線與持續無法上網的情況，不要只因切換瞬間失敗就認定訂閱已過期。

公共 Wi-Fi 通常有認證入口，請先完成基本網路認證，再開啟代理。若代理啟用後無法開啟認證頁，可暫停連線以完成認證，再恢復代理。網域解析問題則應查看用戶端是否回報 DNS 錯誤，以及相關隱私或網路功能是否影響請求路徑。不要把「某個網站無法開啟」直接等同於系統 DNS 故障：也可能是命中直連規則，或目前出口遭到拒絕。比對規則模式與短暫全域模式的結果並查看連線記錄，通常比反覆更換系統設定更有助於找出原因。

背景連線與家用裝置分享

關閉應用程式介面不一定會停止已建立的網路延伸功能，若要真正中斷，請使用連線開關或在系統 VPN 頁面確認。強制結束應用程式後連線是否保留，取決於目前實作方式與系統狀態，不能只依介面是否在背景執行來判斷所有流量。長時間未使用後恢復時，先查看 VPN 狀態，再確認訂閱是否仍有效。應用程式或系統更新後若連線異常，可先中斷再重新連線，並記下具體錯誤文字；只有出現明確的設定或授權問題時，才處理對應項目。

若要讓 iPhone 或 iPad 使用電腦上的代理，可在可信任的區域網路 Wi-Fi 詳細資訊中設定手動 HTTP 代理，填入電腦的區域網路位址與實際監聽連接埠。此方式只會影響遵循該 Wi-Fi 代理設定的請求，不等同於手機用戶端的完整流量接管，通常也不會延伸至行動網路。離開該網路前請還原代理設定，避免裝置下次連線時仍嘗試連接已關機的電腦。分享的完整限制與防火牆說明請參閱混合連接埠與區域網路分享教學。

Linux 安裝與設定

桌面用戶端與命令列方案

Linux 請依使用情境選擇方案：桌面使用者可前往Linux 下載區查看 Clash Verge Rev，再查看 FlClash；伺服器、路由器或需要以指令碼管理的環境，可前往核心下載區選擇 mihomo。圖形用戶端負責管理設定與互動，命令列核心則需要自行管理檔案、程序與系統接管。安裝核心不代表會自動設定桌面代理。開始前執行 uname -m 查看架構，並確認發行版支援的套件格式，DEB 與 RPM 不能視為通用安裝檔。

桌面安裝建議優先使用發行版的套件管理工具，以便管理相依套件與解除安裝紀錄。請以下載頁實際提供的檔案為準，透過系統軟體安裝程式開啟，或在下載資料夾中呼叫套件管理器；不要直接從不明指令碼授予管理員權限。安裝後若程式無法啟動，先從終端機執行對應啟動指令，查看缺少函式庫或圖形環境錯誤。伺服器若沒有圖形工作階段，桌面程式無法顯示不代表核心不支援 Linux；應改用命令列方案，而非繼續安裝無關的桌面元件。

桌面訂閱與應用程式代理

圖形用戶端匯入訂閱的方式與其他桌面平台相近：新增連結、下載、設為作用中設定，再選擇規則模式與節點。開啟系統代理後，請確認目前桌面環境的網路代理設定。GNOME、KDE 與獨立應用程式讀取系統代理的方式不完全相同，終端機、容器與系統服務通常也不會自動沿用桌面設定。先用瀏覽器驗證，再以明確指定代理參數測試命令列工具，可區分節點問題與應用程式未使用代理的問題。

若圖形用戶端支援 TUN，應檢查輔助服務、核心權限與路由，而非只看開關是否開啟。在 Linux 中建立 TUN 裝置通常涉及 /dev/net/tun 與網路管理權限；容器也需要宿主明確授權。長期對一般應用程式授予完整權限並不適用於所有環境，應採用用戶端提供的服務方式，或在充分了解權限範圍後再設定。透過 SSH 遠端操作時尤其要保留還原方式，不要在唯一連線通道上直接嘗試改寫預設路由。

mihomo 檔案配置與設定驗證

使用命令列部署時，先解壓縮適用架構的核心，並放在固定位置。以下使用 /usr/local/bin/mihomo 與 /etc/mihomo/config.yaml 作為範例路徑，前者是可執行檔，後者是設定檔；可依自己的管理方式調整路徑，但指令與服務檔案必須保持一致。建立資料夾後，將已取得的相容設定儲存至指定檔案，再進行語法測試。測試通過只代表設定可以載入，不代表節點帳戶或目標網路可用；正式啟動後仍須查看記錄與實際請求。

sudo install -d -m 700 /etc/mihomo
sudo chmod 755 /usr/local/bin/mihomo
sudo /usr/local/bin/mihomo -t -d /etc/mihomo -f /etc/mihomo/config.yaml

若只想確認核心能否啟動，可使用以下最簡直連設定。它不含代理節點，也不會提供代理出口，僅用來驗證監聽、記錄與基本設定格式。實際使用時應改用有效的訂閱設定，或先了解欄位之間的關係，再加入節點與代理群組。監聽僅綁定本機並停用區域網路存取，適合先建立安全的測試基準；不要為了方便就將管理介面公開至網際網路。

mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

systemd 常駐服務與記錄

使用 systemd 的發行版可將核心設為服務。以下範例適用於本機 HTTP 或 SOCKS 監聽、不啟用 TUN 的初始環境，並以非特權的動態使用者執行；設定所在資料夾必須允許服務使用者讀取，設定中指定的檔案路徑也須可存取。範例使用狀態資料夾儲存執行資料，將設定與可寫入資料分開。若須讀取本機規則檔案，應另外設定相應的讀取權限，不要直接將含有憑證的整個資料夾改為所有人皆可寫入。

[Unit]
Description=mihomo local proxy
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
DynamicUser=yes
StateDirectory=mihomo
ExecStart=/usr/local/bin/mihomo -d /var/lib/mihomo -f /etc/mihomo/config.yaml
Restart=on-failure
RestartSec=5
NoNewPrivileges=yes

[Install]
WantedBy=multi-user.target

將檔案儲存為 /etc/systemd/system/mihomo.service。由於前述資料夾權限僅允許管理員讀取，啟用此動態使用者範例前，必須讓服務能讀取設定：可使用 systemd 憑證機制，或改用專用固定使用者並授予精確的讀取權限；不要忽略權限差異，直接照原樣啟用。若採用專用使用者方案，須同步調整服務的使用者欄位與資料夾擁有者。部署 TUN 還需要額外的網路權限與路由規劃，本範例不涵蓋此情境。確認權限後，再執行重新載入、啟用服務與查看記錄；若失敗，先閱讀具體錯誤訊息。

sudo systemctl daemon-reload
sudo systemctl enable --now mihomo
sudo systemctl status mihomo
sudo journalctl -u mihomo -b --no-pager

遠端安全與更新還原

服務啟動後，使用明確指定代理的請求驗證監聽狀態，不要先修改伺服器所有對外路由。若需分享連線，請限制監聽網卡、來源網段與防火牆規則；管理介面與代理連接埠用途不同，應分別限制。更新核心前先備份設定與服務檔案，停止服務後再替換二進位檔，接著測試設定並啟動。若出現錯誤，可還原原始檔案，避免只靠重新啟動掩蓋相容性問題。桌面與命令列方案的完整比較請參閱Linux 圖形用戶端與 systemd 部署說明。

設定問題與排查順序

連接埠、規則與覆寫

排查設定問題時，先區分不同層級：檔案能否解析、節點能否連線、規則是否選到預期出口，以及應用程式是否連上本機代理。混合連接埠用來接收 HTTP 與 SOCKS5 請求；系統代理負責告知部分應用程式要連線至哪個位址；TUN 則從較底層接管流量。三者彼此相關，卻不能互相取代。記錄若顯示監聽失敗，先檢查連接埠是否被占用；若找不到策略，檢查代理群組引用；若請求已進入連線清單但出口不正確，檢查規則順序。先確認故障層級，修改才有明確目標。

規則通常依由上而下的順序比對，最終的 MATCH 應放在需要優先處理的規則之後。規則中的出口名稱必須與現有節點或代理群組完全相符，大小寫、空格與重新命名都可能影響引用。以下範例中的 PROXY 必須是目前設定中已定義的策略，並非核心自動建立的通用出口。修改遠端訂閱時也要確認用戶端覆寫順序；執行中的設定與訂閱原文不同，可能是正常的合併結果，請查看最終生效設定再判斷。

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

逐項檢查常見問題

記錄、復原與延伸閱讀

記錄問題時，請保留系統、用戶端名稱、核心資訊、接管方式、目標應用程式與最短重現步驟。記錄先使用一般執行層級，只有必要時才暫時提高詳細程度，分享前請刪除帳戶資訊。連線記錄中沒有請求、請求命中錯誤規則，以及節點交握失敗，是三種不同的排查方向；依情況處理比反覆重裝有效。核心欄位差異請參閱原版、Meta 與 mihomo 相容性說明，術語意義可查閱術語手冊。

若問題暫時無法定位，先恢復至最近一次可用狀態：關閉新加入的接管功能、還原備份設定，並確認系統代理沒有指向已退出的程式。恢復網路後，再逐步重現問題。若要重新選擇用戶端，請查看選型指南；若只想重新走一次主要操作流程，可回到快速入門教學。將下載、設定與系統權限分開處理，能為下次移轉與更新留下清楚的參考。