Ollama服务监听地址配置：从127.0.0.1到0.0.0.0的跨网络访问实战

1. 为什么Ollama默认只监听127.0.0.1？

当你第一次安装Ollama并启动服务时，可能会发现一个奇怪的现象：在本地通过127.0.0.1:11434可以正常访问服务，但使用本机局域网IP（比如192.168.1.100:11434）却总是连接失败。这不是你的配置有问题，而是Ollama出于安全考虑默认只绑定在本地回环接口上。

**本地回环地址（127.0.0.1）**就像是一个内部通话系统，它只允许本机上的应用程序相互通信，外界根本无法触及。这种设计在以下场景中特别有用：

• 开发测试时避免外部干扰
• 防止未授权的网络访问
• 减少暴露在公网的安全风险

但当我们想要：

• 在局域网内共享模型服务
• 从手机或其他设备访问主机上的Ollama
• 搭建远程开发环境

这时就需要突破这个限制，让服务监听0.0.0.0（所有网络接口）。不过要注意，开放网络访问会带来安全风险，建议配合防火墙规则使用。

2. 跨平台配置OLLAMA_HOST环境变量

2.1 macOS系统配置

对于使用zsh终端（macOS Catalina及以后版本的默认shell）的用户：

# 编辑配置文件
vim ~/.zshrc
# 在文件末尾添加
export OLLAMA_HOST="0.0.0.0"
# 使配置生效
source ~/.zshrc

如果你更习惯使用bash：

vim ~/.bash_profile
添加相同内容后执行：
source ~/.bash_profile

重要提示：修改后需要完全重启Ollama服务才能生效。最简单的方法是：