MIHOMO / FAQ
Mihomo 常見問題
依問題查找訂閱、代理接入與連線故障的檢查順序。
請先確認用戶端名稱、作業系統與目前的流量接入方式。系統代理、TUN 與規則模式負責不同環節,分開檢查更容易找出原因。
基礎知識
釐清核心、用戶端、設定與流量接入方式之間的差異。
Mihomo 核心與 Clash 用戶端有什麼不同?
Mihomo 是處理代理連線、DNS 與規則比對的核心;圖形化用戶端則提供匯入設定、選擇代理群組及設定系統代理等操作介面。即使不同用戶端使用相同核心,選單名稱、權限要求與設定合併方式也可能不同。參考教學前,請先確認用戶端名稱,再查看設定頁面或日誌中的核心資訊。若設定項目無法辨識,應依實際核心版本查閱文件,不能只憑視窗外觀判斷是否支援該功能。一般桌面使用者通常適合選擇圖形化用戶端;核心套件則主要用於命令列、伺服器與路由器部署。
安裝用戶端後,為什麼還需要訂閱或設定檔?
用戶端負責套用設定,不會自動提供可用的遠端代理服務。訂閱連結通常由服務提供者產生,用來取得節點、代理群組與規則等內容;本機 YAML 檔案也能承載這些設定。匯入前請確認設定適用於 Mihomo,不要將服務商網頁或帳號登入頁面當成訂閱網址。訂閱連結可能包含存取憑證,應妥善保管,避免出現在公開截圖、群組聊天或程式碼儲存庫中。若連結已外洩,請至服務提供者的管理後台重設,再更新各裝置儲存的網址。
規則、全域與直連模式各適用於哪些情況?
規則模式會依設定中的規則順序,決定請求採用直連、代理群組或其他策略,適合日常分流。全域模式則由全域策略處理交由核心接手的請求,適合短暫測試規則是否影響連線。直連模式會讓這些請求直接連線至目標。模式只決定核心收到請求後如何處理,不代表所有應用程式流量都已進入核心;系統代理與 TUN 決定的是流量如何接入。疑難排解時,可暫時切換至全域模式並選擇可用節點;測試結束後請恢復規則模式,避免長期保留臨時設定。
節點支援 UDP,就代表遊戲和通話一定能使用嗎?
UDP 能否轉送取決於整條連線路徑,包括應用程式流量是否進入核心、節點設定是否啟用 UDP、代理協定與伺服器是否支援,以及網路是否允許相關封包通過。用戶端顯示節點可用或網頁能開啟,只能證明部分連線正常,不能取代實際 UDP 測試。遊戲與通話也可能同時依賴 DNS、直連策略及 NAT 環境。請先確認應用程式的流量接入方式,再檢查命中的代理群組與節點,最後在實際應用程式中測試。只開啟 UDP 選項,無法補足伺服器不具備的能力。
安裝設定
先確認安裝套件與授權,再檢查訂閱回傳內容。
訂閱更新失敗,或回應 401、403,該怎麼處理?
先查看更新日誌中的 HTTP 狀態碼與錯誤內容。401 通常與缺少驗證資訊或憑證失效有關;403 則可能是存取限制、方案狀態或伺服器策略所致,請依服務提供者的說明判斷。前往管理後台重新複製完整訂閱網址,確認沒有漏掉查詢參數、混入空格或複製成一般網頁連結。若網址可以存取,但匯入時顯示 YAML 錯誤,請確認回傳內容不是登入頁面或錯誤提示頁。先釐清是下載失敗還是設定解析失敗,再採取處理方式;不要反覆刪除目前可用的設定,也可保留舊設定以便暫時還原。
TUN 模式顯示權限不足或服務未執行,該檢查哪些地方?
TUN 需要建立虛擬網路介面並調整路由,通常比系統代理需要更多權限。Windows 上請先確認用戶端的服務模式已安裝並正在執行,再依用戶端指示完成系統管理員授權;不要同時啟動多個會接管路由的代理工具。macOS 請依所用用戶端的說明檢查系統授權或輔助服務,不要把所有彈出視窗都當成同一種網路延伸功能要求。授權後重新啟用 TUN,並查看第一筆失敗日誌。若仍無法建立介面,請先關閉 TUN,確認系統代理是否可用,再分別檢查權限、驅動程式與路由問題。
Windows 或 macOS 應選擇哪種處理器架構?
請先查看作業系統提供的硬體資訊,不要只憑裝置年份猜測。Windows 可在設定的系統資訊中查看系統類型;常見的 Intel 或 AMD 電腦使用 x64,ARM 裝置則需確認用戶端是否提供相容的安裝套件。macOS 可在「關於這台 Mac」中確認使用 Apple 晶片或 Intel 處理器,再選擇對應架構。架構不符可能導致程式無法啟動,或需要系統轉譯支援。更新前請備份設定,並先結束正在執行的舊版本。若安裝程式提示系統版本不符合需求,請查閱該用戶端的發行說明,不要重複安裝。
Android 出現 VPN 授權提示,或切換到背景後連線中斷,該怎麼辦?
Android 用戶端通常透過 VpnService 接入裝置流量,首次連線時需要確認系統 VPN 授權。這表示允許建立本機 VPN 介面,不代表伺服器節點已可使用。同一使用者環境通常只能有一個作用中的 VPN,啟動其他 VPN 工具可能會中斷目前連線。若切換到背景後斷線,請先查看系統是否限制電池使用、背景活動或自動啟動,再依裝置提供的設定允許用戶端在背景執行。另外也要分辨是應用程式被系統關閉,還是節點連線失敗:前者通常會伴隨通知消失,後者則應繼續查看日誌與訂閱狀態。
使用技巧
透過連線紀錄確認流量路徑,不要只看開關狀態。
已啟用系統代理,為什麼瀏覽器或其他軟體沒有使用代理?
系統代理只會向遵循系統設定的應用程式提供代理網址,不會強制接管所有網路連線。先確認系統設定中的網址與連接埠,是否和用戶端實際監聽的設定一致,再檢查應用程式是否使用內建代理、瀏覽器擴充功能、環境變數或獨立網路設定。測試時開啟用戶端的連線清單,確認是否出現新的請求;若沒有紀錄,應先處理流量接入問題,而不是修改分流規則。對於不遵循系統代理的應用程式,可視需要設定應用程式內的代理或使用 TUN。切換接入方式前,請先關閉互相衝突的設定,避免多種代理層層疊加而難以判斷連線路徑。
Windows UWP 應用程式無法連線,如何處理本機迴圈限制?
部分受到 AppContainer 網路隔離限制的 Windows 應用程式,無法直接存取本機迴圈代理,因此瀏覽器能正常連線,不代表這些應用程式也能使用。請先確認應用程式確實受到此限制,再使用用戶端提供的迴圈豁免工具,或透過系統的 CheckNetIsolation 工具查看並管理指定應用程式的豁免。只為有需要的應用程式授權,不要一次放行所有應用程式。變更後重新啟動目標應用程式,再查看連線紀錄。迴圈豁免只處理本機代理的存取限制,無法修復訂閱失效、DNS 錯誤或遠端節點逾時,而且並非所有商店應用程式都需要設定。
節點測速數值偏低,為什麼下載速度還是很慢?
常見的延遲測試通常測量連線至指定測試網址所需的時間,並不等於可持續的下載頻寬。測試目標、逾時門檻、快取,以及節點到目標網站的路由都會影響結果。選擇節點時,請在相同測試網址和相近時段比較,再使用實際需要的服務確認體驗。下載速度也可能受到伺服器限速、出口壅塞、無線網路品質及目標網站限制影響。不要只根據一次延遲排序就頻繁切換節點;進行中的連線可能仍使用原節點,只有新連線才會採用新選擇,兩者應分開觀察。
Fake-IP 是什麼?區域網路裝置或特定應用程式不相容時該怎麼處理?
Fake-IP 模式會使用映射位址,將網域名稱與後續連線關聯起來,再由用戶端依網域名稱和規則處理請求。這些位址不是目標網站真正的公網 IP,不能用一般直連位址的方式判斷是否可達。若區域網路裝置探索、特定登入程式,或依賴真實 DNS 解析結果的應用程式發生異常,請先確認 DNS 請求是否交由 Mihomo 處理,再針對特定網域檢查 fake-ip-filter 與相關解析策略。不要直接將所有網域加入過濾清單。調整後可能需要清除系統與應用程式的 DNS 快取,並重新建立連線;修改前請保留原設定以便比較。
疑難排解
每次只變更一個條件,並保留可重現問題的紀錄。
節點測試顯示逾時,應依什麼順序排查?
先關閉代理,確認基本網路正常,再檢查裝置時間、訂閱是否更新成功,以及方案或節點是否仍可使用。若只有一個節點逾時,請改用同一訂閱中的其他節點比較;若全部逾時,優先檢查網路出口、設定錯誤與服務提供者的狀態。查看日誌時,請區分網域名稱解析失敗、連線遭拒、驗證失敗與交握逾時,這些問題需要不同的處理方式。測試網址本身無法連線也可能造成延遲測試失敗,因此還應嘗試實際要使用的目標服務。不要一開始就同時修改連接埠、DNS 和規則;每次只調整一項並記錄結果。
用戶端顯示已連線,卻無法開啟網頁,該如何找出問題?
顯示已連線有時只代表核心或本機 VPN 介面已啟動,不表示目標請求一定能完成。先查看連線清單是否出現瀏覽器請求:若沒有紀錄,檢查系統代理、應用程式代理或 TUN 接入;若有紀錄,則查看命中的規則、代理群組與節點。接著依據日誌分辨是 DNS 失敗還是遠端連線失敗,再暫時切換至全域模式,並換用另一個可用節點進行比較。若更換節點後恢復正常,請著重檢查原節點;若只有特定網域異常,則檢查規則與解析設定。每次測試都應重新發起連線,避免瀏覽器重複使用舊連線而影響判斷。
修改規則後沒有生效,為什麼仍使用原本的代理群組?
先確認目前使用的是規則模式,並檢查實際生效的設定,不要只看編輯器中儲存的檔案。部分用戶端會合併訂閱、覆寫設定與本機規則,後續更新也可能改變最終內容。Mihomo 會依順序比對規則;位置較前的廣泛規則或 MATCH,可能讓後面的項目無法命中。請用明確的網域名稱發起新請求,並在連線詳細資料中確認命中的規則與策略。已建立的長連線通常不會因修改規則而自動切換,可關閉相關連線後再試。若要長期保留自訂規則,應使用用戶端支援的覆寫或合併入口。
結束用戶端後無法上網,如何還原網路設定?
先重新開啟用戶端,關閉系統代理與 TUN,再正常結束程式,避免直接強制結束而留下流量接管狀態。接著到系統網路設定中確認是否仍指向本機代理連接埠;核心停止後,該位址不會提供服務。若曾手動設定 DNS,請記下原值,再依目前網路需求還原。也要確認沒有其他代理工具或 VPN 同時執行。每完成一項就測試一次,不要立即大範圍重設網路。若問題只在從睡眠喚醒或切換網路後出現,請記錄發生時機、介面狀態與日誌,再查看用戶端的更新說明。