ドキュメント設定グローバル設定

グローバル設定

config.yaml の最外層、proxies/rules と同じ階層に書く一群のフィールドで、コア自体の動作方式（どのアドレスを監視するか、どのモードで動くか、ログの詳細度、API の公開方法など）を制御します。左側の目次から手引き、出口プロキシ、ルーティングルールなど他のセクションに直接ジャンプできます。

LAN を許可

allow-lanオプション

他のデバイスがこの端末のプロキシポートを経由してインターネットにアクセスすることを許可するかどうか。スマートフォンやタブレットをパソコンで動かしている Clash に接続させたい場合は、これを有効にする必要があります。

bind-addressオプション

バインドアドレス。このアドレス経由でのみ他のデバイスからのアクセスを許可します。"*" は全 IP にバインド。単一の IPv4/IPv6 アドレスを指定して特定のネットワークカードのみにバインドすることも可能です。

lan-allowed-ips / lan-disallowed-ipsオプション

LAN アクセスの 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-interval`	TCP Keep Alive パケットの送信間隔（秒）
`keep-alive-idle`	TCP Keep Alive の最大アイドル時間
`disable-keep-alive`	TCP Keep Alive を無効化します。Android では強制的に true に設定されます

外部コントロール（API）

ダッシュボードは、ここで設定した 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 の4つのデータファイルのダウンロード先アドレスをカスタマイズします。ネットワーク環境が不安定な場合は国内ミラーに変更できます。