設定詳解

Mihomo 設定檔結構詳解

YAML 設定的基礎設定、proxies、proxy-groups、rules 四大區塊各管什麼，改設定前先看懂它。

內容複核 · 2026年11月3日

適合誰

想看懂 YAML 設定檔結構，或在排查問題時需要對照設定的人。

1
頂層常見四塊：proxies 節點列表、proxy-groups 代理群組、rules 規則列表，以及 dns、mixed-port 這類基礎設定。
2
proxies 定義節點：每條節點寫協定類型、伺服器位址、連接埠和憑據。這部分通常由訂閱自動產生，不需要手寫。
3
proxy-groups 定義代理群組：select 手動選節點，url-test 自動選延遲最低的，fallback 故障轉移。群組把節點組織成規則引用的「入口」。
4
rules 決定流量走向：由上而下比對，命中即停。常見寫法是先放行區域網路與直連網域，再依 GEOIP 分流，最後 MATCH 兜底交給代理群組。
5
手改設定前先備份：縮排錯誤是 YAML 最常見的坑。改完用客戶端的設定校驗，或用最小設定啟動驗證。

九成是縮排用了 Tab 或層級錯位。YAML 只認空格縮排，逐行對齊後重試。

先確認改的是目前選取的設定檔；訂閱自動更新會用服務方的版本覆蓋手改內容，自訂規則要確認訂閱更新策略。

想了解規則裡用到的協定名詞，看協定科普那篇。