Ollama 局域网访问配置 (Windows 11)#

前提条件#

• Ollama 已通过 .exe 文件安装 且已成功运行。
• 了解基本的网络知识，包括 IP 地址和端口概念。

目标#

让 Ollama 的 API 接口绑定到你的主机局域网 IP，以便局域网内的其他电脑可以访问。

方法一：设置环境变量 (推荐，持久有效)#

核心： 通过设置 OLLAMA_HOST 环境变量，指定 Ollama 监听的 IP 地址和端口。

1. 打开环境变量设置：

   • 按下 Win + S 键，搜索“环境变量”，然后点击“编辑系统环境变量”。

2. 环境变量设置页面：

   • 在“系统属性”窗口中，点击“环境变量”按钮。

3. 添加环境变量：

   • 在“系统变量”或“用户变量”区域（推荐选择“系统变量”以便所有用户可用），点击“新建”按钮。

   • 变量名： OLLAMA_HOST

   • 变量值： 0.0.0.0:11434

     • 0.0.0.0 表示监听所有可用的 IP 地址。
     • 11434 是 Ollama API 默认端口。 请确保端口未被其他程序占用。

4. 重启 Ollama 服务或重启电脑： 环境变量的更改需要重新加载才能生效。

方法二：通过命令行手动运行 (临时方式)#

核心： 在启动 Ollama 时临时设置 OLLAMA_HOST 环境变量。

1. 打开命令行窗口： 打开 cmd 或 PowerShell。

2. 执行命令：

   • 例如，在 PowerShell 中：

     1
     set OLLAMA_HOST=0.0.0.0:11434
     2
     ollama serve
     

   • 在 cmd 中：

     1
     set OLLAMA_HOST=0.0.0.0:11434
     2
     ollama serve
     

3. 注意事项： 仅在当前命令行会话有效。 关闭终端后设置失效。

防火墙设置 (必须)#

Ollama 进程必须允许外部连接。 如果未正确配置防火墙，即使设置了 OLLAMA_HOST 也无法被局域网其他设备访问。

1. 打开防火墙设置： 在 Windows 搜索栏中搜索“防火墙”，点击“Windows Defender 防火墙高级设置”。

2. 添加入站规则：

   • 点击“入站规则” -> “新建规则”。
   • 选择“端口”，然后点击“下一步”。
   • 设置“特定本地端口”，输入 11434，点击“下一步”。
   • 选择“允许连接”，点击“下一步”。
   • 作用域： 可以选择“域”、“专用”、“公用”，或者选择 “基于名称” 进一步细化。 通常选择“局域网” 或 “专用”。
   • 命名规则，例如 “Ollama API”。

3. 确认设置： 按照向导完成规则创建。

验证配置#

配置完成后，可以使用以下命令从局域网中的另一台设备测试 Ollama API 是否可访问。 替换 192.168.5.235 为你 Ollama 运行主机的局域网 IP 地址。

Mac:

1
curl -s http://192.168.5.235:11434/api/tags | jq '.models[].name'

windows:

1
Invoke-RestMethod -Uri http://192.168.5.235:11434/api/tags | Select-Object -ExpandProperty models

如果返回的是模型列表，则表示配置成功。 如果出现错误，请仔细检查步骤和防火墙设置。