配置 Ollama 环境变量 OLLAMA_HOST 允许局域网访问的具体步骤是什么

文章导读
想要在局域网内其他设备访问 Ollama,核心是将环境变量 OLLAMA_HOST 设置为 0.0.0.0 并重启服务,同时确保防火墙放行 11434 端口。
📋 目录
  1. 命令速用版
  2. 为什么会这样
  3. 分步处理
  4. 怎么验证是否生效
  5. 常见坑
  6. 参考来源
A A

想要在局域网内其他设备访问 Ollama,核心是将环境变量 OLLAMA_HOST 设置为 0.0.0.0 并重启服务,同时确保防火墙放行 11434 端口。

先说结论:修改环境变量是生效的关键,但必须配合防火墙设置才能连通,且需注意暴露服务的安全风险。

  • 适合:局域网调试、多设备调用或团队协作开发场景
  • 先准备:确认本机局域网 IP 地址,备份当前环境变量配置
  • 验收:需用另一台设备通过 IP 地址测试连接是否成功

命令速用版

核心配置仅需设置一个环境变量,不同系统操作略有差异:

变量名:OLLAMA_HOST
变量值:0.0.0.0

配置 Ollama 环境变量 OLLAMA_HOST 允许局域网访问的具体步骤是什么

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 服务或重启电脑。

配置 Ollama 环境变量 OLLAMA_HOST 允许局域网访问的具体步骤是什么

2. Linux/Mac 系统设置

可通过修改 shell 配置文件(如 .bashrc)或直接在前缀添加变量启动。若使用 systemd 管理,需在服务文件中配置 Environment 参数。

3. 防火墙放行

配置 Ollama 环境变量 OLLAMA_HOST 允许局域网访问的具体步骤是什么

Windows 需在防火墙入站规则中开放 TCP 11434 端口,否则其他设备仍无法连接。

怎么验证是否生效

在局域网内另一台电脑上,打开浏览器或终端,访问 http://<本机局域网 IP>:11434。若能看到响应或无连接拒绝错误,即表示配置成功。

常见坑

1. 修改后未重启服务,导致配置未生效。
2. 防火墙拦截,即使变量设置正确也无法连通。
3. 安全风险,0.0.0.0 会监听所有接口,若设备直接暴露在公网可能存在隐患,建议配合防火墙限制来源 IP。

参考来源

  • Windows 下 Ollama 局域网共享配置全攻略
  • OLLAMA_HOST 环境变量设置全攻略
  • Windows 上 Ollama 的本地与外网配置全攻略
  • 在 Debian 12 上配置 Ollama 支持局域网访问