Ollama本地服务无法通过IP访问的终极解决方案

Ollama本地服务无法通过IP访问的终极解决方案


问题描述

在 Mac 系统上启动 Ollama 服务后,通过 localhost 可以正常访问 API,但通过本地 IP(如 192.168.1.106)访问时却报错 Connection refused


1. 问题现象

  • 正常访问curl http://localhost:11434/api/generate 可正常返回结果。
  • 异常访问curl http://192.168.1.106:11434/api/generate 报错 Connection refused

2. 排查步骤与解决方案

2.1 检查ollama 配置`

Ollama 默认仅监听 localhost,需配置为监听 0.0.0.0

执行以下命令检查 ollama 监听的 ip

bash 复制代码
lsof -i :11434

若返回

bash 复制代码
COMMAND   PID   USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
ollama  99664  user    3u  IPv6 0xb5d825d19a65fcd3      0t0  TCP localhost:11434 (LISTEN)

其中localhost:11434说明 ollama 只监听了localhost,这样当你使用 ip 访问 ollama 服务的时候就会被 refused

正常返回应如下

bash 复制代码
COMMAND   PID   USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
ollama  99664  user    3u  IPv6 0xb5d825d19a65fcd3      0t0  TCP *:11434 (LISTEN)
2.2 环境变量强制覆盖配置(关键解决方案)

临时方案

通过设置当前终端会话环境变量 OLLAMA_HOST 强制临时指定监听地址:

bash 复制代码
# 临时生效(当前终端会话)  
export OLLAMA_HOST="0.0.0.0:11434"  
ollama serve  

永久生效方案

将环境变量添加到 Shell 配置文件(如 ~/.bashrc~/.zshrc):

bash 复制代码
echo 'export OLLAMA_HOST="0.0.0.0:11434"' >> ~/.zshrc  
source ~/.zshrc  

2.3 其他排查项
  1. 检查端口占用

    bash 复制代码
    lsof -i :11434  

    若其他进程占用端口,终止进程:

    bash 复制代码
    kill -9 <PID>  

3. 最终验证

执行以下命令测试:

bash 复制代码
curl http://192.168.1.106:11434/api/generate \  
  -d '{"model": "deepseek-r1:8b", "prompt": "为什么天空是蓝色的?"}'  

若返回正常结果,问题解决!


4. 总结

  • 核心问题 :Ollama 默认仅监听 localhost,需通过配置或环境变量开启外部访问。
  • 关键步骤
    1. 使用环境变量 OLLAMA_HOST 强制覆盖配置(优先级最高)。
    2. 检查防火墙和端口占用。

通过以上方法,即使配置文件未生效,也能通过环境变量快速解决问题。希望本文能帮助你顺利部署 Ollama 服务!

相关推荐
djk888817 小时前
一个完整的 TCP 服务器监听示例(C#)
服务器·tcp/ip·c#
AI大模型分享营17 小时前
LLM 应用评估体系详解:从多轮对话到 RAG 与 AI Agent 的落地评估
人工智能
汀丶人工智能17 小时前
AI Compass前沿速览:ChatGPT Atlas、Claude Code、Haiku 4.5、Veo 3.1、nanochat、DeepSeek-OCR
人工智能
玩转AGI17 小时前
总结了 13 个 顶级 RAG 技术
人工智能
曦樂~17 小时前
【Qt】TCP连接--客户端和服务器
服务器·网络·c++·qt·tcp/ip
TG_yunshuguoji18 小时前
阿里云代理商:如何给阿里云配置网络ACL?
服务器·网络·阿里云·云计算
一念&18 小时前
每日一个网络知识点:应用层WWW与HTTP
网络·网络协议·http
久爱物联网18 小时前
串口调试数据-之TCP透传
网络·网络协议·tcp/ip
勿忘,瞬间18 小时前
HTTP协议
网络·网络协议·http
言德斐18 小时前
数据挖掘知识体系分析
人工智能·数据挖掘