検索意図:プロキシは開けた、その次のコントロール面だけ怖い状況
Clash Verge Rev は多くの利用者が Mihomo コアの上へ GUI と購読取り込みを載せているクライアントです。セットアップ手順だけを追うと転送側の HTTP/SOCKS や TUN が先に頭に浮かびますが、実務ではログ閲覧・ポリシ切替・統計だけを済ませたいときにブラウザ向けダッシュボードや RESTful API をオンにすることがあり、その待ち受けが思いがけず広い経路まで露出していないか、という質問につながります。ユーザーが自分の端末だけで済ませばよいときに欲しい状態はひとことでセキュア設定の固定──待ち先を127.0.0.1だけへ寄せ認証レイヤsecretまで入れ運用開始──です。逆に転送側の LAN 公開や許可モデルとは別次元なので、この稿では広いポート共有の細部だけを混ぜません(ここだけ切り離すと頭が整理されます)。類似構成の総ざらいより前に、単一機能点として「外部external-controllerの向き」を押さえるのが本稿の約束であり、入門済みユーザーが自分で監査チェックリスト化しやすい順に並べます。
external-controller と Web UI/REST が担うレイヤ別の整理
Mihomo 系における external-controller は、いわゆる転送ポートとは別レイヤであり、構成の適用状態・接続リスト・ログ断片までを読み書きする HTTP が束ねられるエンドポイントです。名前に「external」とあるため誤読されがちですが、単に「外向きに JSON を張るサービス」を指すだけで、アドレス側をどこへバインドするかは自分で決める前提です。そのためユーザー検索にある「経路だけ不安」は正しく、転送側がローカルのみでもコントロール面だけホスト側の広い経路につながれば意味が異なります。GUI 側の一部ダッシュボードは、この API の上に単なる SPA を載せ換えしているだけになるため、アプリ側のメニューのURLと実際に開いている待ち番号だけを突き合わせるだけでも初期の棚卸になります。また本稿での用語運用として 127.0.0.1 とループバックを日本語読みでひとつの「本機のみ」グループへまとめるとチェックリスト化しやすく、複数コンテナ構成であれば実ホスト側は別問題として切り離します。先行の Verge Rev セットアップ稿で画面の並びだけ押さえたあと、この層だけを増やしていく構成が読みやすくなります。
構成 YAML:`external-controller`・`secret`・`bind-address` の順で確認するべき場所
読者が自分で並べている YAML のなかでも、ひとつのキーだけを触るときに周辺のマージ済みフラグメントが残ると体感がぐちゃぐちゃになりやすく、レビューの順序だけ固定すると事故率が下がります。まず external-controller が文字としてどんな経路へ解釈されているかだけを一覧し、広い側が残っていたらポート番号の取り間違いや混線を疑ってください。そのうえで secret が空だったり弱すぎる場合は読み込み許可されていても許可モデルだけで守れない状態になります。また bind-address がある世代やバリアントでは、コントロール面とは別次元のトピックだけれど名前が似て並ぶため、並べているテンプレ側にコメントだけでも「どのキーを触ったときの責務か」を自分メモとして残しましょう。GUI アプリ側のオーバーライド機能で差し込むときはドラフト競合だけ注意し、アプリ側の「最終的に読み込まれている構成」だけをソースオブトラスとしてレビュしてください。ひとつの例だけ示します(環境によりキー順や末尾の名前付きだけが増えます)。
# Mihomo-compatible example — reload after editing live profile YAML
external-controller: 127.0.0.1:9090
secret: "REPLACE_WITH_RANDOM_LONG_STRING"
secret は保管場所だけ別レーンに並べれば貼り付け間違いが減ります。構成を Git で追うワークフローは別稿のチェックリストとも相性があります。Clash Verge Rev 側の実務順:どの画面から読み・書きすると迷子になりにくいか
アプリ側の名前付けやタブ並びがアップストリームの更新で入れ替わること自体は許容すべき運用側の話なので、この稿でも画面ラベルを絶対名詞として拘束しません。代わりに「購読を取り込んだあとユーザーが自分で並べている Raw/マージ済みテキスト」を軸としてメモします。複数ウィンドウを開いていたり、自動生成パッチだけをタブで離して編集していたりすると、保存した気がしていた値が効いていないという典型がそのまま再現されます。ワークフローとしてはひとつのプロファイルだけをロックし、YAML を保存したら必ず Mihomo がリロードするまでの順序だけ固定してください。ポート番号だけを頭に残すのでなく「アプリ側に表示されている待ち一覧」と突き合わせるだけでも棚卸になります。また Web パネルを開いたブラウザのタブだけが唯一のソースではなく、アプリ側のログに出ている待ち一覧と両方並べれば混線検知が楽になります。初見のときは前述のセットアップ稿とセットで一度だけウィンドウ階層をスクリーンキャプチャ相当のメモに落としておけば二度目以降が速くなります。
-
最終適用済み構成をだけを編集ロックする:オーバーライドだけに secret を置いたつもりが購読の再取得で丸ごと戻される典型を避けるため、どちらへ書いた結果が読み込まれるか自分でメモしてください。
-
external-controllerのアドレス部を広い側から narrow 側へ並べ換える:広い順で観てから127.0.0.1:ポートへ寄せれば段階的に安全側へできます。 -
保存後コア側をリロードしターミナル相当の一覧で番号だけ再確認:OS が提供する一覧は権限モデルだけで結果が異なるので、開発者コンソールのメモだけに頼らないでください。
Secret を載せたあと読み込み許可モデルだけで足りない理由
secret を設定すると API は本来は未認証のリクエストを拒否側へ寄せやすくなりますが、認証だけを唯一の線として過信しないのが読者にとって重要です。ひとつの理由として、構成が誤って空のときやクライアント実装側の細かな差異で期待したヘッダが付かないケースだけでも露出表面積は残り続けられます。そのためユーザー検索にある「経路側の安全配置」だけを並べれば意味が増します。実務チェックリストとして「同一LANの別ノート」「ゲスト SSID」「コンテナ側から逆引き」の三段だけ試せば多くはそれで足ります。転送側の許可モデルとは別問題として切り離せば混乱が減ります。また将来の自分向けには「どの環境へ secret を転記したメモ」を残してください。開発者コンソールのネットワークタブだけに秘密を張りつけない運用だけでもレイヤひとつの事故は減ります。
Authorization の Bearer だけで済むときとクエリ側を避けるときの細部だけ差異がつきやすく、自分の環境だけで済ませれば十分です。この稿では名前をひとつの固定規格として縛りません。127.0.0.1 だけへ閉じたあとの検証:ブラウザとネットワーク層だけを短く並べる
操作が一通り済んだらチェックリストを二段だけにしましょう。第一段は同一マシン上のブラウザからダッシュボードを読み込み、期待どおり SPA が API を読み込めば UI 側は最低限だけ合格です。第二段は自分の環境にある HTTP クライアントで RESTful API のひとつの軽いエンドポイントだけを読み込み認証済みのみ成功であることを証明します。また誤った秘密値だけ明示的に投げられれば拒否ラインも観察できます。この段だけで自分の頭のノイズが減り、「LAN 側からの curl が落ちている」状態へ近づきます。転送側の LAN 許可モデルだけ整理した別稿ではプロキシ口の expose を扱いますが、自分で「今はコントロール面だ」と頭のラベルを切り替えるだけ検証順が安定します。また将来の自分向けにも「どの端末だけを信頼ゾーンとみなすか」を短文でメモしましょう。冗長になりがちですがチェックリスト化したほうが落ち着きます。
# Example curl — substitute host/port/secret token with your runtime
curl -fsS http://127.0.0.1:9090/version \
-H "Authorization: Bearer REPLACE_ME"
ひとつの症状だけでも切り出すときの順序依存
症状が複数並ぶときに最初へ戻される典型はポート番号の取り間違いだけなので、この稿でもチェック順を短文で固定します。まず自分が触った YAML がリロードされたかだけをログで確認し、そのうえでもう一方のウィンドウに残っている古いドラフトがないかを疑ってください。その次に広い側へバインドされた別プロセスが同じポート帯だけを競合していないかを見れば多くが切り分けられます。またコア側のバージョン差だけで名前付けの細部だけがズレているときはアップストリームのリリースノートへ一度戻れば多くは十分であり、ワークスペースを固定しすぎると細部だけで疲弊します。そのときは関連するアップストリーム側の一覧だけ並べれば足ります。DNS 名前でアクセスしている場合だけループバックと実ホスト名の取り間違いが混入しやすいので、名前と番号の両方を並べれば棚卸になります。この順だけ頭に載せれば、多くのケースでは切り分けが一段落します。
よくある質問:Secret・bind アドレス・LAN 許可モデルの線引きだけ短く拾い直す
広い側へ一度バインドしてしまってから縮めるのは順序だけ気をつければ足りますか。
はい。127.0.0.1 に戻しリロードしたあと、待ち受け一覧だけ再確認しましょう。残る場合は別プロセスの競合も疑い、一覧で並べれば多くは切り分けられます。
bind-address は触らなくていいときもありますか。
あります。そのキーが並んでいなかったり世代差で名前が増減していたりすると混線だけが増えるので、この稿ではチェックリスト項目に載せなかった場合も許容しましょう。自分用メモに「触っていない理由」だけ書けばレビュー順だけ固定されます。
コンテナ側で動かしていたらループバックの語だけが別意味になりませんか。
なります。ゲストコンテナ側の127.0.0.1とホスト側のそれは名前だけ同じであり、実効経路だけを別カテゴリへ切り離して棚卸しましょう。名前だけで判断しない順だけ固定されていれば運用側の混乱は減ります。
まとめ:コントロール面だけ単独で監査チェックリスト化する合理性
一体型プロキシクライアントのなかには、画面上からは見えずにコントローラ相当の機能だけが広い経路側へ並んでしまう例もまれに見られます。アプリ側の説明だけ追うと転送許可モデルとは別次元の許可だけが頭に残らないときがあります。対して構成が YAML 側へ寄せられる Clash と Mihomo 系ほどユーザー自身がチェックリスト化しやすく、転送とは別レイヤだけを短く並べられるのがユーザーにとっての透明性にもつながります。Clash Verge Rev のように上位 GUI を載せ換えられた場合でも、最終適用済み構成へ戻れば同じチェックリストが使えるため、この稿の順だけ頭に載せれば日々の棚卸だけで済むことが多いです。GUI 自動生成へ過度に依存すると変更理由だけ履歴へ残らず、自分だけの監査が難しくなるときもありますが、アップストリームの名前揺れに強い運用に寄せれば保守が楽になります。
まずブラウザ用パネルを開いたいだけでも、使うクライアントの入手経路をサイト側でひとつに寄せればチェックリストの第一段だけが単純化されます。プラットフォームをまたぐ場合も同じ一覧へ一度だけ戻れば、初手の確認が楽になります。
プラットフォームごとの最新ビルドを確認したい場合は、このクライアント一覧へ移動して入手できます。