パッケージマネージャの HTTP プロキシ設定

SPM の組み込み HTTP クライアントが行うすべてのネットワーク操作に対して、HTTP / HTTPS プロキシのサポートを追加します。設定方法は、JSON の設定ファイル proxy.json と、標準的なプロキシ環境変数（http_proxy / https_proxy / no_proxy）という 2 つの相補的な仕組みです。設定ファイルは起動のされ方（ターミナル、Xcode、CI）によらず確実に効くのに対し、環境変数は CI システムや既存の Unix ワークフローとの自然な統合手段になります。

設定ファイル proxy.json

SPM の設定ディレクトリに proxy.json を置きます。

• ユーザーレベル（共有）: ~/.swiftpm/configuration/proxy.json
• プロジェクトレベル（ローカル）: <project>/.swiftpm/configuration/proxy.json

{
  "version": 1,
  "http": {
    "proxy": "http://proxy.corp.example.com:8080"
  },
  "https": {
    "proxy": "http://proxy.corp.example.com:8080"
  },
  "noProxy": ["localhost", "127.0.0.1", "::1", ".internal.corp"]
}

• version（必須・整数）: スキーマのバージョン。1 を指定します。
• http / https（任意・オブジェクト）: それぞれ HTTP / HTTPS リクエスト向けのプロキシ設定。proxy（必須・文字列）にプロキシ URL を書きます。http だけを指定した場合、HTTPS リクエストはそのプロキシを使わず直接通信します（逆も同様）。これは curl の挙動に倣ったもので、HTTPS トラフィックを誤って HTTP 専用プロキシに流さないための設計です。
• noProxy（任意・文字列の配列）: プロキシを経由せず直接通信するホストやパターン。

http / https の下がオブジェクトとして入れ子になっているのは意図的で、将来の認証付きプロキシ対応（"authentication": "basic" など）をスキーマのバージョンを上げずに追加できるようにするためです。

CLI コマンド

swift package config の下に、プロキシ設定用のサブコマンドを追加します。

# プロジェクトの HTTP プロキシを設定
swift package config set-proxy --http http://proxy:8080

# グローバル（ユーザーレベル、全プロジェクト）に設定
swift package config set-proxy --global --http http://proxy:8080

# HTTP と HTTPS を同時に設定
swift package config set-proxy --http http://proxy:8080 --https http://proxy:8080

# 既存の設定に除外ホストを追加
swift package config set-proxy --no-proxy "localhost,.internal.corp"

# 現在の実効設定を表示
swift package config get-proxy

# HTTPS プロキシ設定だけを削除
swift package config unset-proxy --https

# すべてのプロキシ設定を削除（プロジェクトレベル）
swift package config unset-proxy

set-proxy は --http / --https / --no-proxy の少なくとも 1 つを要求し、追加的（additive） に動作します。つまり、指定したフィールドだけを更新し、既存の設定は残します。unset-proxy はフラグを指定するとその設定だけを、フラグなしではすべてのプロキシ設定を削除します。

--global フラグはユーザーレベルの設定を対象とし、カレントディレクトリに Package.swift がなくても任意のディレクトリで実行できます。これは SE-0535 でミラーコマンドに追加された --global フラグと一貫した挙動です。

get-proxy は優先順位を解決した後の実効設定を表示し、各値がどのソース（プロジェクト設定・ユーザー設定・システム・環境変数）に由来するかも示します。

$ swift package config get-proxy
HTTP proxy:  http://proxy:8080 (user: ~/.swiftpm/configuration/proxy.json)
HTTPS proxy: http://corpproxy:3128 (system)
No proxy:    localhost, .internal.corp (user: ~/.swiftpm/configuration/proxy.json)

優先順位

プロキシ設定を決めるとき、SPM は次の順で最初に値を提供したソースを採用します。フィールドごとに独立して解決されるため、たとえば HTTP はユーザー設定、HTTPS はシステムプロキシ、というように別々のソースから来ても構いません。

1. 環境変数（http_proxy / HTTP_PROXY など。小文字が大文字より優先） — 最優先
2. プロジェクトのローカル設定（<project>/.swiftpm/configuration/proxy.json）
3. ユーザーレベル（グローバル）設定（~/.swiftpm/configuration/proxy.json）
4. macOS のシステムプロキシ（システム設定のネットワーク → プロキシ。macOS のみ）
5. プロキシなし（直接接続） — デフォルト

環境変数を最優先にしているのは、これがコマンドラインツールの標準的な慣習であり、呼び出し側が他の設定によらずプロキシ設定を確実に強制できるようにするためです。macOS では URLSession がシステムプロキシ設定を自動的に引き継ぐため、システムプロキシが設定済みであれば環境変数も proxy.json もなしで通信がプロキシ経由になります。Linux にはシステムプロキシの層がないため、設定手段は環境変数と proxy.json になります。

noProxy のマッチング

noProxy は次のパターンをサポートします（マッチングは大文字小文字を区別しません）。

プロキシ URL の形式

プロキシ URL は scheme://host[:port] の標準形式で、http（最も一般的で、CONNECT により HTTP / HTTPS 両方のターゲットに使われる）、https、socks5 のスキームに対応します。URL に資格情報（user:password@）を含めることはできません。含まれていた場合、SPM は認証付きプロキシがまだサポートされていない旨のエラーを出します。

適用範囲

プロキシ設定は、SPM の組み込み HTTP クライアントが行うすべての HTTP 操作に適用されます。

• バイナリアーティファクトのダウンロード
• パッケージレジストリの API リクエスト
• パッケージコレクションの取得
• OCSP 証明書検証のリクエスト
• Swift SDK のダウンロード
• ビルド済みバイナリのダウンロード

一方、git 操作には影響しません。git は従来どおり git 自身のプロキシ設定（gitconfig の http.proxy、またはサブプロセスに渡される環境変数）を使います。

実装上は、SPM のすべての HTTP クライアント抽象（HTTPClient / LegacyHTTPClient）が共通して使う唯一の具体実装である URLSessionHTTPClient の層でプロキシ設定を適用します。URLSession を生成する前に URLSessionConfiguration の connectionProxyDictionary を設定するため、既存の利用側コードは変更なしでプロキシ対応を得られます。プラットフォーム差は条件付きコンパイルで吸収します。

なお、この提案は完全にオプトインで、プロキシを設定しないパッケージは従来どおり直接接続を行います。Package.swift のマニフェスト形式や依存解決の挙動、tools-version による制御には一切変更がありません。