一、確認訂閱已更新並成功載入
先確認核心目前使用的是哪份設定檔。節點清單仍然看得到,有時只是因為用戶端保留了上次成功載入的內容。更新訂閱、套用設定與啟動核心是三個不同步驟。
- 在用戶端的設定頁找到目前啟用的項目,手動更新一次,記下更新時間和錯誤訊息。若該項目從未啟用,即使更新成功,也不會影響目前的連線。
- 若更新回應 HTTP 401 或 403,請確認訂閱網址與帳號狀態,並確認伺服器是否限制存取;若回應 404,請確認網址是否已變更。這些是訂閱請求的結果,不能直接據此判定節點離線。
- 若下載完成但載入失敗,請查看記錄中的第一個解析錯誤。若收到的是登入頁面或錯誤頁面,請修正訂閱網址;若錯誤指向通訊協定類型或欄位,請先確認用戶端實際使用的核心與版本,再對照設定需求。
- 套用設定後,確認代理頁是否出現預期的節點與策略群組。若設定使用
proxy-providers個別取得節點,也要查看對應提供者的更新時間與記錄。主設定檔更新成功,不代表提供者也取得了新清單。
二、檢查本機代理連接埠是否正在監聽
先確認應用程式能否連上本機核心。mixed-port 是 HTTP 與 SOCKS 共用的本機代理入口,不是遠端節點的連接埠。以下以 7890 為例;實際測試時應以用戶端目前生效的設定為準,因為用戶端可能會覆寫訂閱中的連接埠。
mixed-port: 7890
allow-lan: false
先確認連接埠正在監聽,再明確指定代理發送請求
在 Windows 的 PowerShell 中查看監聽連接埠。將 OwningProcess 的值與工作管理員「詳細資料」中的 PID 對照,確認監聽程序是目前用戶端的核心,而不是其他代理程序。
Get-NetTCPConnection -State Listen -LocalPort 7890 |
Select-Object LocalAddress, LocalPort, OwningProcess
接著用 curl 明確指定本機 HTTP 代理。Windows 請使用下方的 curl.exe;macOS 與 Linux 可將命令名稱改為 curl。連線階段最多等待 5 秒,整個請求最多等待 15 秒;這些是測試參數,不代表節點測速結果。
curl.exe -v --noproxy "" --proxy http://127.0.0.1:7890 --connect-timeout 5 --max-time 15 https://example.com/
- 本機連接埠連線遭拒:先檢查核心是否已啟動、連接埠是否正確,以及監聽位址是否包含本機 IPv4 迴圈位址。若啟動記錄顯示連接埠已被占用,請先確認占用程序,再關閉舊執行個體或更換連接埠;更換後也要同步更新系統代理與測試命令。
- 本機連線已建立,但後續失敗:代理入口已可連線。接著檢查同一時間的核心記錄,釐清是本機代理驗證、網域名稱解析、規則拒絕,還是對外連線逾時。
- 成功收到目標回應:若要確認特定節點是否正常,仍須確認記錄顯示實際使用的是該節點,而不是
DIRECT。一次成功只能驗證該次請求所經過的路徑。
三、區分系統代理、應用程式代理與 TUN
明確指定代理的請求成功,但瀏覽器仍無法開啟網頁時,優先確認瀏覽器是否將請求交給核心。對同一個目標發出請求,並查看連線頁面或記錄是否出現同一時間的紀錄。若沒有紀錄,先檢查代理入口,不要直接更換節點。
| 入口 | 檢查位置 | 判斷與處理方式 |
|---|---|---|
| Windows 11 系統代理 | 「設定」→「網路和網際網路」→「Proxy」 | 若用戶端使用手動系統代理,請確認位址與連接埠是否和監聽設定一致,並檢查目標是否列在代理例外清單中。 |
| 應用程式個別代理 | 該應用程式的網路或代理設定 | 確認應用程式是沿用系統設定,還是使用個別位址。若個別設定為 SOCKS,必須使用支援 SOCKS 的連接埠,不能直接沿用僅支援 HTTP 的入口。 |
| TUN 模式 | 用戶端的 TUN 開關、核心啟動記錄 | 若問題只在啟用 TUN 後出現,請檢查虛擬介面、路由與 DNS 接管是否生效,並確認是否有其他 VPN 同時變更預設路由。 |
系統代理只會影響採用該設定的應用程式。TUN 則透過虛擬介面處理路由至該介面的流量,兩者不是同一個開關。排查時一次只切換一種入口,並以相同目標重新測試。用戶端代理頁內建的節點測速通常由核心發起,即使系統代理關閉也可能正常運作,因此測速結果無法證明瀏覽器已連上代理。
四、區分節點伺服器 DNS 與目標網站 DNS
先查看記錄中究竟是哪個網域名稱解析失敗。若節點的 server 填寫的是網域名稱,解析失敗會直接阻斷節點連線;若解析失敗的是瀏覽目標,則須依實際分流方式與代理通訊協定,確認解析是在應用程式、本機核心還是遠端進行。
查詢核心目前使用的 DNS 解析入口
以下是 mihomo 的 DNS 設定片段,用來說明欄位用途:nameserver 負責一般解析,proxy-server-nameserver 專門解析節點伺服器的網域名稱。範例使用 IP 格式的上游位址;只有目前的網路能連線至這些上游時,設定才有診斷價值。請先備份原設定,再逐項測試,不要覆蓋目前使用的分流解析設定。
dns:
enable: true
listen: 127.0.0.1:1053
nameserver:
- 1.1.1.1
proxy-server-nameserver:
- 223.5.5.5
若系統已安裝 dig,可對範例中的監聽連接埠送出一次查詢。此命令只能確認核心的 DNS 監聽是否能回覆這次查詢,不會驗證節點伺服器專用的上游,也不會自動變更系統 DNS。
dig @127.0.0.1 -p 1053 example.com A +time=2 +tries=1
- 查詢逾時:先確認 DNS 模組確實正在
127.0.0.1:1053監聽,再檢查上游是否可連線。若直接使用未指定伺服器的系統查詢命令,測到的可能是另一條解析路徑。 - 查詢有回應,但記錄仍顯示節點網域名稱解析失敗:請檢查節點位址是否拼寫正確,以及目前網路是否能使用節點伺服器專用上游。查得到目標網域,不能取代這項檢查。
- 回傳
198.18.0.x這類位址:若已啟用 fake-ip,且位址位於設定的 fake-ip 網段內,通常代表這是用於映射網域名稱的虛擬位址。請勿對該位址執行 ping,並以結果判斷遠端節點是否上線。
五、確認規則命中與策略群組選項
核心收到請求後,先確認當時命中了哪條規則,再確認該策略群組實際選取的項目。規則模式會依序比對,由最先命中的規則決定處理路徑。命中 DIRECT 的請求並未經過遠端節點;命中 REJECT 的請求也不能用來測試節點連線狀態。
例如,目前設定已經有名為「手動選擇」的策略群組時,可以將下方的特定網域規則暫時插入現有的 rules 清單,並放在可能先命中的規則之前。不要新增第二個頂層 rules,也不要用範例取代整套規則。
- DOMAIN,example.com,手動選擇
在該群組中選取一個要測試的節點,再發送一次相同的請求。記下目標網域、命中規則、策略群組與最後使用的節點。若結果仍顯示直連,請先檢查目前是否為規則模式、群組是否選到 DIRECT,以及請求是否命中更前面的規則。若用戶端記錄未顯示預期的網域,也要確認應用程式是否直接連線至 IP 位址。測試完成後請移除暫時加入的規則。
六、以相同目標比對,判斷單一節點或測速問題
只有確認請求確實經過待測節點後,才適合比較節點。固定裝置、網路與目標位址,在同一個手動選擇群組中分別測試節點 A 和節點 B。每次更換節點都要建立新連線,避免沿用先前的瀏覽器連線。先在相同網路下比對,再決定是否改用另一個獲准使用的網路複測。
| 觀察結果 | 下一步 |
|---|---|
| A 連線逾時,B 可連上相同目標 | 查看 A 的對外連線錯誤。若連線逾時,優先檢查伺服器位址、連接埠與網路路徑;若是 TLS 或驗證錯誤,則確認訂閱提供的參數、裝置時間與核心相容性。請勿關閉憑證驗證來排查問題。 |
| 測速全部失敗,但已確認可透過節點瀏覽網頁 | 個別確認測速網址能否經由該節點連線,以及回應狀態是否符合設定要求。測速與實際使用的目標不同;測速失敗不能直接判定所有節點都已離線。 |
| 多個節點都在相同階段失敗 | 回頭檢查共用環節,包括節點網域名稱解析、共用的伺服器位址或連接埠,以及目前網路的連線條件。不要把一批相同錯誤當成多個獨立故障。 |
回報故障時,至少附上故障時間、核心版本、測試目標、已遮蔽敏感資訊的節點識別資料,以及同一時間的規則命中結果與第一個對外連線錯誤。指出錯誤發生在「連線至本機」、「解析網域名稱」、「連線至遠端」或「交握」階段,比只寫「所有節點都逾時」更容易找出問題。