Ollamaに接続できないときの直し方｜localhost:11434の確認手順

Ollama対応アプリで「connection refused」「failed to connect」「localhost:11434に接続できない」と表示された場合、モデルより先にOllamaのサーバーが動いているかを確認します。

localhostは「そのアプリが動いている環境自身」を指します。Dockerコンテナや別PCから接続するときは、ブラウザで見ているlocalhostと同じとは限りません。

この記事でわかること

• Ollamaに接続できないときの直し方の具体的な確認手順
• 原因を一つずつ切り分ける方法
• 再発時に残しておく情報

最初の3分で確認すること

1. ollama listが実行できるか
2. http://localhost:11434へ同じPCから到達できるか
3. 接続しているアプリが同じPC・同じネットワーク環境で動いているか

CLIも動かなければOllama本体、CLIは動くのにアプリだけ接続できなければURLやコンテナの経路を疑います。

Ollamaのプロセスを確認する

macOSやWindowsではメニューバー・タスクバーのOllamaが起動しているかを確認します。Linuxや手動起動では、サービス状態やollama serveの実行状況を確認します。

アップデート直後に問題が出た場合は、公式FAQの案内に従ってOllamaを更新・再起動し、最小構成で試します。

APIへ直接アクセスして切り分ける

同じPCのターミナルからOllama APIへアクセスし、応答があるかを確認します。APIが応答するのにフロントエンドだけ失敗するなら、アプリ側の接続URLや権限が原因です。

URLの末尾、HTTPとHTTPS、ポート番号の誤りを確認します。Ollamaの既定ポートと別のアプリのポートを混同しないようにしてください。

Dockerからlocalhostへ接続できない理由

Dockerコンテナ内のlocalhostは、通常ホストPCではなくそのコンテナ自身を指します。Open NotebookなどをDockerで動かし、Ollamaをホスト側で動かす場合は、公式の外部Ollama向け構成やDocker Compose例を確認します。

むやみに外部公開用のバインドへ変更すると、同一ネットワーク上からOllamaへアクセスできる状態になる可能性があります。接続範囲とファイアウォールを理解してから設定してください。

ログで確認する

公式トラブルシューティングにはOS別のログ確認方法があります。再現時刻を記録し、接続拒否、モデル読み込み失敗、メモリ不足を分けて確認します。

エラー全文にはユーザー名やローカルパスが含まれることがあります。公開フォーラムへ貼る前に、個人情報や秘密情報を除いてください。

復旧後に確認すること

• 小さいモデルで1回だけ生成できるか
• アプリを再起動しても接続が維持されるか
• PC再起動後にOllamaが自動起動する設定か
• DockerやVPNを使った場合だけ再発しないか

再発条件を一つ記録しておくと、次回はモデルの再取得やアプリの再インストールをせずに対処できます。

まとめ

一度に複数の設定を変えず、同じ条件で比較することが解決への近道です。最初の状態、変更した項目、結果を短く記録しておけば、再発時にも無駄な再インストールや買い替えを避けやすくなります。

関連するLEXIAの記事

• Ollamaの基本的な使い方
• Ollamaが遅い原因の確認方法
• Open Notebookの使い方

参考にした公式情報

• Ollama公式トラブルシューティング
• Ollama公式FAQ