1. なぜ Kimi / Moonshot で分流が効くのか
生成 AI の開発者向けポータルは、ドキュメントの静的配信、ログインとセッション、課金と利用量の API、実際の推論エンドポイント、場合によってはオブジェクトストレージや CDN への副次リクエストまで、複数ホスト名に接続が分岐します。Clash の ルール分流は、これらを意図した 策略(ポリシー) に載せるか DIRECT に残すかをホスト単位で制御する仕組みです。
Moonshot のオープンプラットフォームまわりも同様で、ブラウザでコンソールを開いていても背後では platform. や api.、認証まわりの別サブドメインが動き、インフラ更新でホストが増えることがあります。古い汎用ルールのままだと「メインだけ PROXY で、API だけ意図せず直結」のような部分的不通が起き、体感では「全体がダウンしているように見える」ことがあります。
本稿は違法な迂回や利用規約に反する行為を推奨するものではありません。契約とポリシーの範囲内で、自宅や開発環境のネットワークを整えるための一般的な話に限定します。
2. 既存記事との役割分担
当サイトではベンダごとにホスト空間が異なる前提で記事を分けています。DeepSeek 向けは deepseek.com 系、智譜 Z.ai は bigmodel.cn や z.ai 系、OpenAI 互換の広い話は openai.com 系にフォーカスしています。これらをそのまま流用しても Moonshot の API ベース URL はカバーされないため、本稿では moonshot.cn を中心とした短い追記ルールを例示し、既存の「国内 LLM API」記事群と補完する想定です。
クライアント選びは Windows 向け GUI の比較記事も参照してください。考え方の骨格はどの記事も共通で、① ログの Server Name を正とする ② DOMAIN-SUFFIX 等でまとめて期待の策略へ ③ ノードと DNS をセットで疑うの三段です。
3. コンソールと API で症状が分かれる理由
ブラウザのコンソールは、まず JS・CSS・画像を取得し、その後にセッション維持や課金情報の API が走ります。ここで一つでも DIRECT のまま地理的制限や輻輳にさらされるホストがあると、画面は「ずっとスピナー」のまま止まります。
一方 REST API(公式ドキュメントが示す https://api.moonshot.cn 系への POST、OpenAI 互換の /v1/chat/completions など)は、User-Agent も TLS の扱いもブラウザと異なり、企業プロキシやセキュリティ製品の分類も別物です。「コンソールは開けるが API だけタイムアウト」は、ルール以前にAPI キー・レート制限・エンドポイントの打ち間違いの可能性もありますが、切り分けの第一歩は 同じノード・同じ DNS に揃えて再現するかを見ることです。
HTTPS_PROXY などを本機の mixed-port に合わせてから、ルールの話に進むと手戻りが減ります。
4. ドメインとエンドポイントの整理
公式構成は更新されるため、以下は設定時の思考のための例です。必ずクライアントの接続ログに出たホスト名を正として追記・削除してください。
- ブランド/ポータル:
moonshot.cn本体やドキュメント、ステータス案内など。 - 開発者コンソール:
platform.moonshot.cnなど、キー発行や利用量確認を行うホスト。サブドメインが増える場合があります。 - API:多くの連携例では
api.moonshot.cnをベースに OpenAI 互換パスへ POST します(実際のパス・認証は公式ドキュメント優先)。 - Kimi 製品側:チャット UI が
kimi.comや別ホストを参照する場合、ログに出たホストを個別に足すと安全です。DOMAIN-KEYWORD,moonshotのような広い書き方は他サービスと衝突しやすいので、可能なら避けます。
ログの見方
GUI のログでは、各接続について マッチしたルールと実際に使われたノードが並びます。rules: は上から順に評価されるため、汎用の RULE-SET や国別ルールが、後から足した Moonshot 用ルールより上で吸っていないかを確認します。タイムアウトが続くときは TLS Handshake Timeout 記事で SNI とノード層もあわせて見てください。
5. Clash ルール例(コピー用)
Clash(Mihomo/Meta 系コア)では rules: に DOMAIN、DOMAIN-SUFFIX、外部 RULE-SET を並べ、最後に MATCH でデフォルトへ落とします。Moonshot 向けに最小限だけ足すなら、サフィックス単位が扱いやすいです。
# Example only — verify hostnames in your client logs
# Optional: use a dedicated select/fallback group instead of PROXY
rules:
- DOMAIN-SUFFIX,moonshot.cn,PROXY
- DOMAIN-SUFFIX,kimi.com,PROXY
- MATCH,DIRECT
kimi.com はログに出なければ削除して構いません。専用の策略グループを挟む場合は PROXY をそのグループ名に置き換えてください。
購読ルールとマージするときは、競合する上位ルールに負けていないかを必ず確認してください。用語や全体像は ドキュメント概要も併せて参照すると、プロファイルの責務分けが整理しやすくなります。
6. 策略グループとノード選択
ノード選択は往復遅延が低いものを選べばよい、という話だけではありません。TLS、輻輳、BGP の揺らぎ、プロバイダ側のレート制限まで含めると、「速いが不安定」と「やや遅いが落ちにくい」が入れ替わることがあります。長いストリーミング応答やバッチ推論では、一時的な切断が積み重なって「総タイムアウト」に見えることもあります。
実務的には、同一プロファイル内で複数ノードを順に試し、コンソールと curl の両方で再現性を見ます。API 利用では、アプリ側に短いリトライと指数バックオフを入れておくと一時混雑に強くなります(実装はアプリの責務ですが、ネットワーク側の揺らぎを吸収できます)。
フォールバックグループの扱い
自動フェイルオーバー系のグループを使う場合、閾値が甘いとノードが頻繁に泳ぎ、ストリーミングでは途切れが目立ちます。まずは手動で安定ノードを固定し、問題が再現しないことを確認してから自動化を検討するのが無難です。
| 症状 | ありがちな原因 | 先に試すこと |
|---|---|---|
| 最初だけ応答があるがすぐ止まる | 輻輳・レート制限・中間機器のタイムアウト | 別ノード、時間帯変更、リトライ間隔の調整 |
| コンソールのみ SSL エラー | ローカル証明書/HTTPS 検査 | セキュリティ製品の設定を確認 |
| ルールは PROXY だが遅い | 実ノードが遠い/混雑 | 低遅延ノードへ変更 |
| 名前解決だけ失敗 | DNS の漏れ・汚染 | dns 設定と fake-ip の整合 |
7. DNS・Fake-IP・ターミナル
Clash 利用者がつまずきやすいのが DNS です。Fake-IP を使う構成では、名前解決とルール評価のタイミングが密接に絡み、「ログ上のホストとアプリの表示が噛み合わない」ように見えることがあります。大方のケースでは、漏れない DNS と ルールと矛盾しない解決経路が揃えば体感は落ち着きます。
詳細なキー名はコアのバージョンで差があるため、ここでは方針のみ述べますが、「DNS だけが意図せず直進している」状態は、ルールを直しても改善しない典型です。fake-ip と DNS の切り分け記事で仮想 IP 周りを疑う手順もあわせて確認してください。
IPv6 が別経路に出ているケースでは、OS やルータで IPv4 を優先するだけで挙動が変わることもあります。CI やサーバから API を叩く場合は、実行環境の出口と自宅の Clash 設定が別物であることも忘れず、再現環境を揃えてから比較します。
8. 簡易セルフチェック
上から順に試すと無駄が少ないチェックリストです。
- クライアントの更新:古い GUI はコア挙動とずれます。公式ダウンロードページから現行版へ。
- システムプロキシと TUN:トラフィックをどちらに載せているか統一し、例外アプリがないか確認。
- ルールのヒット:ログで Moonshot 関連ホストが期待の策略に乗っているか。
- ノードの健全性:別ノードへ切り替えて再現性を確認。
- DNS:解決経路と fake-ip の整合。
- API 認証:キー期限・課金状態・ベース URL の誤り(ルール以前の切り分け)。
これでも改善しない場合は、プロバイダ側の障害や地域的制限の可能性が高まります。ステータス情報と時間を置いた再試行も現実的な対処です。
9. まとめ
Kimi と Moonshot オープンプラットフォームのように、コンソールと API の両方から触るサービスほど通信は単一ホストに収まらず、ルール分流の設計ミスが「読み込みの止まり」や「API だけの失敗」として現れます。moonshot.cn 系をログで正にし、Clash で DOMAIN-SUFFIX などを丁寧に積み上げ、策略グループと DNS をセットで見直すと体感はかなり落ち着きます。
同種のプロキシツールと比べて、Clash 系はログとルールの見え方が明瞭な場合が多く、試行錯誤のコストを下げられます。ルールを少し整えただけで、長い会話や夜間バッチが途切れにくくなることも珍しくありません。