想要在局域网内其他设备访问 Ollama,核心是将环境变量 OLLAMA_HOST 设置为 0.0.0.0 并重启服务,同时确保防火墙放行 11434 端口。
先说结论:修改环境变量是生效的关键,但必须配合防火墙设置才能连通,且需注意暴露服务的安全风险。
- 适合:局域网调试、多设备调用或团队协作开发场景
- 先准备:确认本机局域网 IP 地址,备份当前环境变量配置
- 验收:需用另一台设备通过 IP 地址测试连接是否成功
命令速用版
核心配置仅需设置一个环境变量,不同系统操作略有差异:
变量名:OLLAMA_HOST
变量值:0.0.0.0
Linux 临时生效命令:export OLLAMA_HOST=0.0.0.0(重启终端或服务后失效)
为什么会这样
Ollama 默认启动时绑定的是 127.0.0.1,这是本地回环地址,只允许本机内部访问。将其改为 0.0.0.0 意味着监听所有网络接口,包括局域网网卡,这样其他设备才能通过你的局域网 IP 找到服务。
分步处理
1. Windows 系统设置
按下 Win + S 搜索“编辑系统环境变量”,打开后点击“环境变量”。在“系统变量”区域新建变量,名填 OLLAMA_HOST,值填 0.0.0.0。保存后必须重启 Ollama 服务或重启电脑。
2. Linux/Mac 系统设置
可通过修改 shell 配置文件(如 .bashrc)或直接在前缀添加变量启动。若使用 systemd 管理,需在服务文件中配置 Environment 参数。
3. 防火墙放行
Windows 需在防火墙入站规则中开放 TCP 11434 端口,否则其他设备仍无法连接。
怎么验证是否生效
在局域网内另一台电脑上,打开浏览器或终端,访问 http://<本机局域网 IP>:11434。若能看到响应或无连接拒绝错误,即表示配置成功。
常见坑
1. 修改后未重启服务,导致配置未生效。
2. 防火墙拦截,即使变量设置正确也无法连通。
3. 安全风险,0.0.0.0 会监听所有接口,若设备直接暴露在公网可能存在隐患,建议配合防火墙限制来源 IP。
参考来源
- Windows 下 Ollama 局域网共享配置全攻略
- OLLAMA_HOST 环境变量设置全攻略
- Windows 上 Ollama 的本地与外网配置全攻略
- 在 Debian 12 上配置 Ollama 支持局域网访问