external-controller と Web UI が担当すること
Clash Meta(Mihomo) を動かしている環境では、通信を実際に中継するための待ち受け(たとえば Mixed ポートや HTTP/SOCKS 用ポート)とは別に、設定や状態を読み書きするための HTTP サービスとして external-controller が用意されています。GUI クライアントの一部機能やサードパーティツールがこれを叩くほか、組み込みのWeb コンソール(Web UI)もこのポートにぶら下がっていることが多いです。
ユーザー検索としては「外部コントローラ」「9090」「ダッシュボードが開かない」「secret はどこ」とばらけますが、整理するとひとつの TCP ポートに REST API とブラウザ向け UI が同居しているイメージです。ビルドやパッチによりパスや既定ポートは変わり得るので、スクショの数字より自分の YAML とログに出ている listenをソース・オブ・トゥルースにしてください。
external-controller のポートは設定コンソール用であり、HTTP プロキシとして貼っても期待どおりには動きません。対応関係は Mixed ポートの実測記事 とセットで読むと頭の中が一本線になります。
YAML で見るべきキー:external-controller と secret
設定ファイルでは external-controller にバインドするアドレスとポートを書きます。歴史的な例としては次のような断片です(環境に合わせて読み替えてください)。
# Listen address and port for REST API / dashboard (example)
external-controller: 127.0.0.1:9090
secret: "replace-with-a-long-random-string"
secret は REST へのアクセスをBearer トークン相当で縛るための値です。GUI が自動生成している場合もありますが、購読テンプレが空のまま配っているケースでは自分で長めのランダム文字列を入れる必要があります。リポジトリやスクショにそのまま載せないください。権限モデルやヘッダ名の細部は実装バージョンで確認し、「認証ヘッダ無しでも叩ける状態」をWAN 側へ広げない運用が前提になります。
ポートが競合すると listen に失敗し、結果としてダッシュボードだけ開けない状態になります。Windows で別プロセスが握っているときの調査は ポート占有の記事 と矛盾しないように、ログに出ている実ポートを優先してください。
ステップ 1:バインドは「127.0.0.1」から始めるのが無難
同一マシンのブラウザだけでコンソールを触りたいなら、external-controller を 127.0.0.1:<ポート> に限定するのが最も単純です。ループバックにはその PC のユーザー空間からしか届きません(OS の細かなポリシーは別として)、家庭内 LAN にサービスを広げないという意味でも説明がしやすいです。
一方で「スマホや別 PC のブラウザから見たい」という要件では 0.0.0.0:<ポート> のようにすべてのインタフェースで listenする書き方や、明示的に LAN IP を書く運用へ広げたくなることがあります。そのときはファイアウォールで送信元を絞ること、ルータ側から不必要なポート転載をしないこと、そしてクライアントの Allow LAN/許可リストなどプロキシ側の公開設定とセットで設計することが重要です。LAN でプロキシや API を広げるときの共通項は LAN とファイアウォールの整理記事 がカバーしています。
0.0.0.0 listen とポート転載を組み合わせると、世界中からコンソール宛の SYN が届く状態になりやすくなります。認証が弱い・ログ監視が無い・TLS が無い、のどれかが付くと設定やノード情報が狙われるリスクが現実味を帯びます。どうしても遠隔から触るなら VPN、SSH トンネル、リバースプロキシでの TLS とアクセス制御など別レイヤーで閉じる前提で設計してください。
ステップ 2:ブラウザで Web UI を開く(パスとバージョン差)
listen が成功している状態では、同一マシンから http://127.0.0.1:<ポート>/ui のような URL で組み込みパネルへ入れるビルドが一般的です(末尾スラッシュや追加パスは製品により異なるため、開けないときはそのバージョンの公式説明へ一度戻ってください)。デスクトップ GUI が別ウィンドウで同じバックエンドを叩いているだけの場合もあり、そのときは画面上の「ダッシュボードを開く」メニューのほうが早いです。
secret を設定している環境では、初回アクセス時にトークン入力を求める UI が出たり、クエリではなくヘッダ送信が前提だったりします。スクショで見た他人の画面と自分の入力欄が一致しないのはよくあるので、「403/401 が返るのは認証」「接続自体できないのは listen/ファイアウォール」と切り分ける癖をつけると復旧が速くなります。
ステップ 3:curl で REST が生きているか切り分ける
ブラウザがキャッシュや拡張の影響を受けるときは、REST を直接叩いてポートと認証だけを検証すると淡々と進みます。secret を設定している例:
curl -fsS \
-H "Authorization: Bearer YOUR_SECRET_HERE" \
http://127.0.0.1:9090/version
YOUR_SECRET_HERE は YAML の secret と同一文字列に置き換えます。HTTP 200 でバージョン JSON が返れば listen と認証はおおむね整合しています。タイムアウトならポート転載やバインド網羅不足、401/403 ならヘッダや値の typo、という順で疑うと探索コストが下がります。
運用上は API で設定を書き換えられる項目があるため、サードパーティ連携ツールや自作スクリプトから強すぎる権限を渡さないこともセットです。読み取り専用で足りるなら、その用途に限定したツール側の設定やネットワーク分離を検討してください。
セキュリティ実務:最小権限・監査・バックアップ
まず公開範囲を最小にすることです。ローカルだけで足りるならループバック、LAN だけなら送信元ネットワークとファイアウォールで輪をかける、業務用途なら中央の認証基盤や VPN の背後へ寄せる、という順で検討します。次にsecret をローテーションできる運用です。スクショやログに値が残っていないか、チャットやチケットに貼っていないかも含めて確認してください。
TLS はブラウザから裸の HTTP で LAN を跨ぐとパッシブリスニングに弱いので、別ホストへポート転載してまで HTTP のまま広げないほうが無難です。どうしても HTTPS で終端したいときはリバースプロキシ側で証明書とアクセス制御を済ませ、上流へはループバック限定で繋ぐ構成が説明しやすいです。
ルール設計そのものやノード選択ロジックが本体であるため、コンソールはあくまで便利なオペレーション窓口です。分流や自動選択の話題は url-test/フォールバック記事、DNS と名前解決まわりは Fake-IP/DNS の記事 が別軸の参照になります。
よくある質問
Q. 「Mixed を 7890、コンソールを 9090」という並びは標準ですか?
A. テンプレやドキュメントでよく見られる冗長な番号の並べ方ですが、義務ではありません。自分の YAML と実際に listen しているログ/コマンド出力が一致しているかだけが重要です。
Q. secret を無効化したビルドもありますか?
A. 開発ビルドや特殊プリセットでは認証がゆるい場合があります。長期運用では逆に危険なので、公開範囲とセットで見てください。
Q. Headless の Linux でだけ運用するときも開ける?
A. listen はできますがブラウザ UI は別マシンからSSH トンネルで転送するか、LAN を限定公開して叩くことになります。systemd 運用の骨格は Linux と systemd の記事 と組み合わせて読むと流れがつながります。
まとめ
external-controller は Clash Meta における外部から設定と状態へアクセスするための HTTP エンドポイントであり、ブラウザで開く Web UI はその上に載ったインタフェースです。Mixed などプロキシ用ポートとは別物であり、書き込み権限や公開範囲にはインターネットに晒さない・secret を適切に・バインドは必要最小限という三原則が効きます。
現場では「設定ファイルが読めるだけ」「ダッシュボードもある」「REST で自動化もしたい」という要求が同居しますが、そのどれもコアと GUI に依存した機能差が残ります。OSS で自分で組み立てるほど YAML とポートとログを直接いじる負担が増えるため、説明が分散したりバージョン差で詰まったりしがちです。対して商用や統合されたクライアントでは、待ち受けや認証まわりがウィザード化されていて試行錯誤のステップが短いことがあります。
ClashSky は、そのような摩擦を減らす方向でインストールから購読取り込み、モード切替やログ確認までを一つの製品体験としてそろえることを意識しています。コンソールを自分で開いて細かく触りたい利用者にも、GUI で安定運用したい利用者にも、入口がぶれにくいほうが結果的に安全です。無料で試せるので、自分のワークフローに合うかどうか一度確かめてみてください。ダウンロードページから環境別ビルドを入手し、手元のネットワーク前提で動きを比較するとよいでしょう。