症状:ブラウザは速いのに pip・conda だけ固まる

Clash や Mihomo 系クライアントを起動し、システムプロキシやルールも「海外サイトは問題なく開ける」状態なのに、ターミナルで pip install や conda install を実行すると、進捗表示が長く止まったり、タイムアウトで途切れたりする——この記事は、その典型パターンにフォーカスします。ローカル LLM 向けの Ollama や Hugging Face のような別レイヤーの取得ではなく、汎用の Python パッケージ管理(PyPI・conda チャンネル・GitHub 由来の配布物)が通る経路を整理します。

原因は一つではありません。インデックス用の JSON/HTML と、実体の .whl や .tar.bz2 が別ドメインに載っていること、社内ミラーを DIRECT にしたルールが意図せず広くマッチしていること、あるいはブラウザだけがプロキシを知っていてシェルは直結のまま、といった組み合わせが多いです。以下では、まず「どのホストに触れているか」を意識するための地図を置き、次に Clash 側の分流の考え方、最後に端末の環境変数の照合へ進みます。

ダウンロードチェーン:pip/conda が触るホストは複数本線

pip(PyPI 既定)は、パッケージ一覧や依存解決のために pypi.org を叩き、実ファイルの多くは files.pythonhosted.org から取得します。ミラー(例:国内や教育機関向けの PyPI ミラー)を pip.conf で指している場合は、そのミラーのホストが追加の主役になります。ここで「ミラーは速いはず」と思いつつ Clash 側で同名サフィックスを広く PROXY に載せていると、期待と実際の出口がずれて帯域が不安定になることがあります。

conda/mambaは、repo.anaconda.com や conda.anaconda.org(conda-forge など)、場合によっては CloudFront 型の CDN ホスト名へ分散します。チャンネル設定や .condarc のミラー行が、ブラウザで見ている「速い経路」とは別物であることも珍しくありません。さらに、パッケージのソースが GitHub の Release にある場合、github.com の API/HTML と objects.githubusercontent.com などのオブジェクトストレージが別ルールに落ちると、「メタは取れたのにバイナリだけ失敗」という見え方になります。

したがって、「Python っぽいドメインを一括で同じ policy に入れる」だけでは足りず、遅延の出ているホスト単位でログを見ながら調整するのが安全です。ルールセットの読み方全般はルールプロバイダ解説と併読すると、RULE-SET と手書き DOMAIN-SUFFIX の順序設計がつながります。

分流の考え方:ミラー直結と海外ノードの棲み分け

方針はシンプルです。国内ミラーや社内キャッシュへ行きたいトラフィックは、広い GEOIP より前に、明示的な DOMAIN-SUFFIX または信頼できる RULE-SET で DIRECT(または専用 policy)へ送る。PyPI 本家や GitHub のオブジェクトストレージなど、ミラーがカバーしない/カバーが不完全なホストは、遅延と帯域を見ながら別の policy に載せる——この二段構えです。

よくある失敗は、DOMAIN-KEYWORD,google のような雑な行が先にマッチしてしまうことや、GEOIP,CN,DIRECT が広すぎて意図しないホストまで直結に引っ張られることです。逆に、すべてを単一の海外ノードに流すと、CDN のエッジ選択が不利になり「ブラウザより遅い」こともあります。実務では、ログに出たホスト名をそのままルールに昇格する反復が最も確実です。

アプリ全体をトンネルで包みたい場合は環境変数に頼らず TUN を検討する価値があります。挙動の整理はTUN モードガイドを参照してください。

ルール記述の例(コア設定のイメージ)

実際の proxy-groups 名や購読ノード名は手元のプロファイルに合わせて置き換えてください。以下は説明用の断片です(コメントは英語のみ)。

# Place BEFORE overly broad GEOIP / KEYWORD rules that steal matches
DOMAIN-SUFFIX,pypi.org,PYTHON_INDEX
DOMAIN-SUFFIX,pythonhosted.org,PYTHON_INDEX
DOMAIN-SUFFIX,files.pythonhosted.org,PYTHON_CDN

DOMAIN-SUFFIX,repo.anaconda.com,CONDA_MAIN
DOMAIN-SUFFIX,anaconda.com,CONDA_MAIN
DOMAIN-SUFFIX,anaconda.org,CONDA_FORGE

DOMAIN-SUFFIX,github.com,GITHUB_WEB
DOMAIN-SUFFIX,githubusercontent.com,GITHUB_REL

# If you intentionally use a domestic mirror, pin it explicitly to DIRECT
# DOMAIN-SUFFIX,example-mirror.edu.cn,DIRECT

PYTHON_INDEX と PYTHON_CDN を分けるかどうかは、ノード品質次第です。遅延が CDN 側に集中するなら分離し、どちらも同程度なら同一 policy で運用して構いません。先頭から評価されることを忘れず、購読ルールの直後に「自分用のピン留め」を挿入する運用も有効です。

ターミナルがプロキシを見ているか(環境変数)

macOS や Linux では、GUI の「システムプロキシ」とシェルの http_proxy/HTTPS_PROXY は別物です。pip は環境変数と設定ファイルの両方を参照するため、片方だけ整っている状態が起きがちです。読み込み順や NO_PROXY の例外、Git 単体の http.proxy なども交差します。

手元のシェルで実際に何が見えているかは、macOS 向けターミナル・プロキシ診断の手順がそのまま流用できます。Windows では WSL2 とホスト側のポート転送の組み合わせも絡むため、WSL2 稿とあわせて、127.0.0.1 がどこを指すかを揃えてください。

# Quick sanity check in the same shell that runs pip / conda
echo "$http_proxy" "$HTTPS_PROXY"
python -c "import os; print(os.environ.get('HTTPS_PROXY'))"

仮想環境(venv/conda env)をアクティベートしたシェルと、IDE 内蔵ターミナルでは変数が異なる場合があります。install を実行したプロセスの環境を疑うのがコツです。

conda 利用者向けの追加チェック

.condarc の channels 順序は、実際に叩かれる URL を変えます。defaults だけか conda-forge を混ぜるかでホスト集合が変わるため、ルール調整の前に conda config --show channels で現状を固定しておくとよいです。企業プロキシの内側では、HTTPS インタセプトと証明書ストアの問題で「接続はするが検証で落ちる」ケースもあるため、エラーメッセージが TLS 関連か帯域関連かを分けます。

ミラーを追加する場合は、そのミラーの FQDN を Clash でも明示的に DIRECT に寄せるか、意図的に海外出口へ流すかを決め切ります。中途半端に MATCH へ落ちると、再現が難しい「たまにだけ失敗」になります。

検証:ログと curl でホストを確定する

Clash のログ(またはダッシュボードの接続一覧)で、詰まっている接続のターゲットホストをメモします。同じホストへ curl -I をシェルから打ち、環境変数付き/なしの差分を見ると、「ルールが悪いのか、そもそも CLI がプロキシを使っていないのか」が切り分けられます。DNS モードが fake-ip のときは、ドメインルールと名前解決の相互作用に注意が必要です——挙動はクライアントのドキュメントとセットで読むのが安全です。

GitHub Release の取得だけ遅い場合、ブラウザでは github.com ばかり見ていて objects.githubusercontent.com を取りこぼすことがあります。ログに出た名前をそのままルールに足すのが最短です。

社内ポリシーでミラーのみ許可されている場合は、本稿の「海外 CDN を別 policy に」ではなく、許可リストに沿った DIRECT 設計を優先してください。セキュリティと開発体験のバランスは組織ごとに異なります。

オープンソースとドキュメント

コアの挙動や設定キーは、利用中の実装(Mihomo など)の公式ドキュメントやGitHub リポジトリで確認できます。クライアントの入手と更新は当サイトのダウンロードページを第一導線にし、GitHub は仕様確認・Issue 参照に使い分けると、読者が手順を取り違えにくくなります。画面操作の流れはドキュメント/チュートリアルも参照してください。

まとめ

pip・conda の停滞は、「Clash が壊れている」よりホスト単位の経路設計と CLI のプロキシ認識を疑うほうが早いことが多いです。PyPI のインデックスと files.pythonhosted.org、Anaconda 系と GitHub のオブジェクト配信を分けてログで確認し、ミラー運用とルールの広いマッチが矛盾していないかを見直す——この流れは、2026 年現在もローカル開発環境で繰り返し効くチェックリストです。

同種のツールのなかでも、Clash / Mihomo 系は policy グループと接続ログが追いやすく、CDN 分割の試行錯誤に向いています。ノードとルールを手元で揃えつつ、クライアントを最新に保てば、Python エコシステムの大きな依存取得も安定しやすくなります。

→ Clash を無料ダウンロードし、pip・conda まで含めた開発用トラフィックを整理する