企業ネットワーク、VPN、または外部プロキシサーバーを介して ollama pull
を使用してモデルをダウンロードしようとしている場合、dial tcp: lookup registry.ollama.ai や
context deadline exceeded のようなエラーに直面していることでしょう。
Ollama はデフォルトではシステムのプロキシ設定を常に正しく取得するわけではなく、大きなモデルのサイズ(2GB から 70GB 以上)が問題を悪化させます —
ダウンロード中に接続が切断されることがあります。この記事では、環境変数の正しい設定方法、Docker および systemd でのプロキシ設定、
よくある pull エラーの解読とその解決方法について説明します。
Ollama のネットワークとプロキシの動作
Ollama はクライアントサーバーアプリケーションです。ローカルサーバー (ollama serve)
は CLI からのコマンドを受け取り、モデルレジストリ registry.ollama.ai およびモデルのレイヤー (layers) が保存されている CDN へのネットワークリクエストを実行します。
コマンド ollama pull llama3 は実際には一連の HTTPS リクエストを実行し、
Docker pull に似ています。最初にモデルのマニフェストが要求され、その後、バイナリレイヤー (GGUF ファイルの重み) が順次または並行してダウンロードされます。
重要なポイント: ネットワークリクエストは サーバープロセス Ollama によって実行され、CLI コマンドではありません。これは、プロキシ設定を含む環境変数を
ollama serve プロセスが実行されている場所で設定する必要があることを意味します。
つまり、ollama pull を呼び出すターミナルではなく、
サービスが systemd ユニットや Docker コンテナとして実行されている場合、通常の bash セッションでの変数のエクスポートは影響を与えません —
これが「プロキシは設定されているように見えるが、pull がうまくいかない」最も一般的な理由です。
HTTP_PROXY、HTTPS_PROXY、NO_PROXY 環境変数
Ollama は Go で書かれており、Go の標準 HTTP ライブラリは古典的な環境変数からプロキシ設定を読み取ります:
HTTP_PROXY— 通常の HTTP リクエスト用のプロキシHTTPS_PROXY— HTTPS リクエスト用のプロキシ(モデルのダウンロードにはこれが必要です、レジストリは TLS で動作します)NO_PROXY— プロキシから除外するホストのリスト(例: 127.0.0.1:11434 のローカル API Ollama)
値のフォーマット: プロキシ認証付きの場合は http://user:password@host:port、
または SOCKS5 の場合は socks5://host:port。Go は両方の形式をサポートしていますが、
SOCKS5 の場合は Ollama のバイナリがこのプロキシをサポートするようにビルドされていることが重要です — 現在のほとんどのビルドではそうですが、エラーが発生した場合はまず
HTTP/HTTPS プロキシでテストしてこの変数を除外してください。
重要: 環境変数は小文字と大文字の両方で指定してください
(http_proxy および HTTP_PROXY)。
一部の Linux ディストリビューションは小文字のみを読み取りますが、Go アプリケーションは時々大文字を期待します — 両方の形式を指定する方が良いでしょう。
Linux および macOS の設定
Ollama をターミナルから直接起動する場合(システムサービスとしてではなく)、サーバーを起動する前に環境変数をエクスポートするだけで済みます:
export HTTP_PROXY="http://user:[email protected]:8000"
export HTTPS_PROXY="http://user:[email protected]:8000"
export http_proxy="http://user:[email protected]:8000"
export https_proxy="http://user:[email protected]:8000"
export NO_PROXY="localhost,127.0.0.1"
ollama serve &
ollama pull llama3
設定をセッション間で保持するには、これらの行を ~/.bashrc,
~/.zshrc または ~/.profile
(使用しているシェルに応じて)に追加します。編集後、source ~/.bashrc
を実行し、Ollama プロセスを再起動してください — 環境変数はプロセスの起動時にのみ読み取られ、ホットリロードはサポートされていません。
macOS では、Ollama がアプリケーションとしてインストールされている場合(Homebrew 経由ではなく)、ターミナルからの環境変数が GUI で起動されたプロセスに届かないことがあります。
この場合、launchctl setenv を使用して環境変数を設定する方が信頼性があります:
launchctl setenv HTTPS_PROXY "http://user:[email protected]:8000"
launchctl setenv HTTP_PROXY "http://user:[email protected]:8000"
# その後、Ollama アプリケーションを完全に再起動してください(トレイから退出し、単にウィンドウを閉じるだけではありません)
Windows の設定
PowerShell では、変数は現在のセッションのために次のコマンドで設定されます:
$env:HTTP_PROXY="http://user:[email protected]:8000"
$env:HTTPS_PROXY="http://user:[email protected]:8000"
$env:NO_PROXY="localhost,127.0.0.1"
ollama pull mistral
Ollama がバックグラウンドサービスとして実行されている場合(システムトレイのアイコン)、セッション変数だけでは不十分です — サービスはログイン時に起動し、
PowerShell を開く前に実行されます。ユーザーまたはシステムレベルで変数を設定する必要があります。
「設定 → システム → この PC について → システムの詳細設定 → 環境変数」を開き、その後、タスクマネージャーを使用して
ollama.exe プロセスを完全に終了し、アプリケーションを再起動します。
Docker における Ollama のプロキシ
Ollama がコンテナ内で実行されている場合(サーバー展開の一般的なケース)、ホストの環境変数は自動的にコンテナ内に渡されません —
明示的に -e または docker-compose の environment セクションを介して渡す必要があります:
docker run -d \
-e HTTP_PROXY="http://user:[email protected]:8000" \
-e HTTPS_PROXY="http://user:[email protected]:8000" \
-e NO_PROXY="localhost,127.0.0.1" \
-v ollama:/root/.ollama \
-p 11434:11434 \
--name ollama ollama/ollama
docker-compose.yml でも同様です:
version: "3.8"
services:
ollama:
image: ollama/ollama
environment:
- HTTP_PROXY=http://user:[email protected]:8000
- HTTPS_PROXY=http://user:[email protected]:8000
- NO_PROXY=localhost,127.0.0.1
volumes:
- ollama:/root/.ollama
ports:
- "11434:11434"
volumes:
ollama:
環境変数を変更した後は、コンテナを再作成する必要があります (docker compose up -d --force-recreate)、
単純な再起動では不十分です。環境変数はコンテナ作成時に固定されます。
Ollama の systemd サービス用プロキシ
Linux サーバーでは、Ollama は公式のインストールスクリプトを介して systemd サービスとしてインストールされることがよくあります。この場合、環境変数は
ターミナルでの export ではなく、オーバーライドファイルを介して設定されます:
sudo systemctl edit ollama.service
開いたエディタに次のように追加します:
[Service]
Environment="HTTP_PROXY=http://user:[email protected]:8000"
Environment="HTTPS_PROXY=http://user:[email protected]:8000"
Environment="NO_PROXY=localhost,127.0.0.1"
その後、変更を適用します:
sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl show ollama --property Environment
最後のコマンドは、プロセスが実際にどの環境変数を認識しているかを表示します — 設定が適用されたことを確認する便利な方法で、 再度 pull を試みる前に確認してください。
pull エラーの解析とその解決
プロキシを介してモデルをダウンロードする際の最も一般的なエラーメッセージとその対処法を解説します。
dial tcp: lookup registry.ollama.ai: no such host
DNS 解決がプロキシの背後で機能していません — 通常、これはリクエストが直接プロキシサーバーをバイパスしようとしているか、
マシンが DNS にアクセスできないことを意味します(閉じた企業ネットワーク)。解決策: HTTPS_PROXY
がプロセスによって正しく取得されていることを確認してください(上記の systemctl show コマンドを参照)、
そしてプロキシサーバー自体が外部ドメインを解決できることを確認してください(SOCKS5 プロキシは自分の側で DNS を解決し、HTTP プロキシもそうですが、一部のローカルプロキシはこれを行いません)。
proxyconnect tcp: dial tcp: connection refused
Ollama はプロキシに接続しようとしていますが、拒否されます。ポートとホストにタイプミスがないか確認し、プロキシサーバーが指定されたポートで外部からリッスンしていることを確認してください(localhost のみではなく)、 またファイアウォールがプロキシポートへのアウトバウンド接続をブロックしていないことを確認してください。
407 Proxy Authentication Required
プロキシがログインとパスワードを要求していますが、これらが渡されていないか、誤って渡されています。環境変数にログインとパスワードが
http://user:password@host:port フォーマットで組み込まれていることを確認し、
パスワード内の特殊文字(例: @ や :)
が URL エンコーディング(%40、%3A)を介してエンコードされていることを確認してください。
x509: certificate signed by unknown authority
これは TLS インスペクション(MITM)を持つ企業プロキシの兆候で、SSL 証明書を自分のルート証明書で置き換えています。Ollama の Go クライアントは
この証明書を信頼しません。解決策は、企業のルート証明書を信頼された証明書機関のシステムストレージに追加することです
(Linux では通常、.crt ファイルを /usr/local/share/ca-certificates/ にコピーした後、update-ca-certificates を実行します)。証明書の検証をグローバルに無効にすることは推奨されません — これはトラフィックの傍受を許可します。
context deadline exceeded / i/o timeout の際のレイヤーのダウンロード
大きなモデルのレイヤーのダウンロード中に接続が切断されます(通常、4GB から 40GB のファイルです)。このエラーはほぼ常にプロキシサーバーの不安定さや 低い帯域幅を示しており、Ollama 自体の問題ではありません。無料または過負荷の公共プロキシは、特にダウンロードに数分以上かかる場合に 長い TCP セッションを切断します。このような場合は、より安定したチャネルに切り替えることが役立ちます — たとえば、データセンターのプロキシは、高速で 大きなファイルのダウンロードにおいて安定した接続を提供します。
Ollama に適したプロキシの種類
プロキシの種類の選択は、Ollama にプロキシが必要な理由によって異なります。企業のファイアウォールの制限を回避することが目的であれば、 ほぼすべての安定した HTTP(S) プロキシが適しています。しかし、目的がモデルレジストリの地理的制限を回避することや リクエストがデータセンターから来ていることを隠すことであれば(一部の CDN はクラウドプロバイダーの既知の IP 範囲に対して速度を制限します)、 プロキシの種類の選択が重要になります。
| プロキシの種類 | 速度 | Ollama に使用する場合 |
|---|---|---|
| データセンター | 高い | 大きなモデルのレイヤー(4GB 以上)のダウンロードを途切れずに行う、異なるデータセンターのロケーションからのテスト |
| レジデンシャル | 中程度 | レジストリの地理的制限を回避する、データセンターの IP が地域のレート制限に引っかかる場合 |
| モバイル | 変動 | プロバイダーの IP 範囲が完全にブロックされている場合の最終手段、大きなダウンロードには速度の変動のためあまり効果的ではありません |
Ollama に関するほとんどのシナリオ — 数十 GB のモデルを安定してダウンロードする必要がある場合 — では、 データセンターのプロキシが最適な選択肢です。これにより最大の帯域幅と 最小の遅延が提供され、大きなバイナリレイヤーのダウンロードにおいて重要です。レジデンシャル IP は、データセンターのアドレスが 実際にモデルレジストリの制限に引っかかる場合にのみ接続するべきです。
接続の診断
Ollama 自体のデバッグに時間を費やす前に、curl を介してプロキシを直接確認してください — これによりアプリケーションの問題と プロキシサーバーの問題の混乱を排除できます:
# プロキシを介したレジストリの可用性を確認
curl -v -x http://user:[email protected]:8000 https://registry.ollama.ai/v2/
# プロキシを介したダウンロード速度を測定
curl -x http://user:[email protected]:8000 -o /dev/null -w "%{speed_download}\n" https://registry.ollama.ai/v2/
# 詳細なログで ollama serve を実行
OLLAMA_DEBUG=1 ollama serve
curl が正常に応答を受け取る場合、ollama pull がそれでも失敗する場合 —
問題はほぼ確実に環境変数がサーバープロセスに届いていないことにあります(サービスは別のユーザー、別のシェルで実行されているか、
オーバーライドなしの systemd ユニットとして実行されています)。systemd に関するセクションに戻り、systemctl show ollama --property Environment の出力を確認してください。
もし curl も大きなファイルのダウンロード中に切断されるか、不安定な速度を示す場合 — 原因はプロキシサーバー側にあり、 大量のデータ転送に特化したより安定したプロキシプロバイダーへの切り替えを検討する価値があります。
結論
Ollama のプロキシ設定は、3 つの重要なポイントに集約されます: 環境変数は ollama serve プロセスのために設定される必要があり、
pull を呼び出すターミナルではありません; プロキシの URL フォーマットには正しくエンコードされたログインとパスワードが含まれている必要があります; 証明書エラーが発生した場合は
企業のルート証明書を信頼されたストレージに追加し、TLS 検証を無効にしないでください。ほとんどの pull エラーは、Ollama 自体のバグではなく、
ネットワーク設定が必要なプロセスに適用されなかったり、プロキシサーバーが大きなファイルの長時間転送に耐えられないことが原因です。
あなたの主な目的が、数十 GB のモデルを安定して迅速にダウンロードし、接続が切断されないようにすることであれば、 データセンターのプロキシを試してみることをお勧めします — これにより、 大きなモデルのレイヤーをダウンロードするために必要な高い帯域幅が提供されます。もしプロキシの使用理由がモデルレジストリの地理的制限を回避することであれば、 レジデンシャルプロキシに注目してください。これらは、クラウドプロバイダーの IP 範囲に適用される地域の制限に引っかかることが少なくなります。