文件 設定 全域設定

全域設定

寫在 config.yaml 最外層、跟 proxies/rules 平級的一批欄位，控制核心本身的執行方式：監聽哪些位址、跑什麼模式、日誌開多細、API 怎麼開放。

允許區域網路

allow-lan可選

是否允許其他裝置經過本機的代理埠存取網際網路。手機、平板要接入電腦跑的 Clash，必須把它開啟。

bind-address可選

綁定位址，僅允許其他裝置透過這個位址存取。"*" 綁定所有 IP；也可以填單個 IPv4/IPv6 位址只綁定一個網卡。

lan-allowed-ips / lan-disallowed-ips可選

區域網路存取的 IP 白名單和黑名單，僅在 allow-lan: true 時生效；黑名單優先級高於白名單。

config.yaml YAML
allow-lan: true
bind-address: "*"
lan-allowed-ips:
  - 0.0.0.0/0
  - ::/0
lan-disallowed-ips:
  - 192.168.0.3/32
使用者驗證
authentication可選

給 http(s)/socks/mixed 代理設定使用者名稱密碼驗證，格式為 "user:pass" 陣列。

skip-auth-prefixes可選

設定允許跳過驗證的 IP 段，比如 127.0.0.1/8、::1/128。

執行模式與日誌

mode預設 rule

rule 規則匹配（最常用）；global 全域代理，所有流量走 GLOBAL 策略組裡選中的節點；direct 全域直連，忽略所有代理。

log-level預設 info

輸出日誌的詳細程度，從少到多：silent 靜默 → error → warning → info → debug（幾乎輸出全部執行資訊，排除故障時才需要）。

ipv6預設 true

是否允許核心接受 IPv6 流量。

find-process-mode預設 strict

是否匹配發起連線的行程（配合 PROCESS-NAME 規則用）：always 強制匹配所有行程；strict 由核心判斷是否需要匹配；off 完全不匹配，路由器上跑建議用這個。

TCP Keep Alive

行動裝置上適當調整這幾項可以減少耗電：

欄位說明
keep-alive-intervalTCP Keep Alive 封包的發送間隔，單位秒
keep-alive-idleTCP Keep Alive 的最大閒置時間
disable-keep-alive停用 TCP Keep Alive，Android 上會被強制設為 true

外部控制（API）

面板（Dashboard）就是透過這裡設定的 RESTful API 跟核心通訊的。

external-controller可選

API 監聽位址，預設 127.0.0.1:9090 只允許本機存取；改成 0.0.0.0:9090 可以監聽所有網卡（比如手機連路由器上的面板）。

secret可選

API 的存取金鑰，開放到 0.0.0.0 時強烈建議設定，否則任何人都能連上你的面板改設定。

external-controller-cors可選

API 的 CORS 標頭設定，allow-origins 陣列 + allow-private-network。

external-ui / external-ui-url可選

把一份面板靜態網頁資源（如 metacubexd）掛載到 API 位址/ui；external-ui-url 用來設定自動下載/更新面板資源的位址。

config.yaml YAML
external-controller: 127.0.0.1:9090
secret: ""
external-ui: ui
external-ui-url: "https://github.com/MetaCubeX/metacubexd/archive/refs/heads/gh-pages.zip"

還有 external-controller-tls（HTTPS API）、external-controller-unix（Unix socket）、external-controller-pipe（Windows namedpipe）等進階寫法，透過 Unix socket / namedpipe 存取 API 不會驗證 secret，請自行確保安全。

其他常用欄位

欄位說明
unified-delay開啟統一延遲時會計算 RTT，消除不同協議握手耗時帶來的延遲差異，讓測速數字之間可比
tcp-concurrent啟用 TCP 並行連線：用 DNS 解析出的所有 IP 同時發起連線，取第一個成功的，可以緩解某些線路的連線失敗問題
interface-name指定 mihomo 的流量出站網卡
routing-mark為 Linux 下的出站連線設定預設路由標記
profile.store-selected記住每個策略組上次手動選擇的節點，重新啟動後不用重新選
profile.store-fake-ip儲存 fake-ip 對應表，網域再次連線時複用原有對應位址
global-client-fingerprint已棄用，請直接在每個 proxy 裡設定 client-fingerprint

GEO 資料來源

geodata-mode預設 false

GEOIP 資料檔案格式，true 使用 .dat 格式，false 使用 .mmdb 格式。

geodata-loader預設 memconservative

standard 標準載入器；memconservative 為小記憶體裝置優化的載入器（路由器等場景推薦）。

geo-auto-update / geo-update-interval可選

是否自動更新 GEO 資料庫以及更新間隔（單位小時）。

geox-url可選

自訂 geoip/geosite/mmdb/asn 四個資料檔案的下載位址，網路環境不好時可以換成國內鏡像。