Ollama 启动失败并提示 bind address already in use，本质上不是模型下载或推理问题，而是监听地址被占用。默认情况下，Ollama 会尝试绑定 127.0.0.1:11434，为本地 API 请求提供服务。如果这个端口已经被其他进程监听，或者之前启动的 Ollama 实例没有完全退出，就会出现地址已占用的错误。
错误含义与Ollama的默认监听行为
Ollama 启动后需要开启一个 HTTP 服务，用来接收 ollama run、ollama pull 以及各类 API 调用。这个服务默认监听在 127.0.0.1:11434，也就是只允许本机访问。如果启动时看到 bind address already in use，说明在创建这个监听套接字时，操作系统发现目标地址和端口已经被别的进程占用，无法继续绑定。
这里有一个容易忽略的细节：监听地址并不只是端口号。比如一个进程已经监听了 0.0.0.0:11434，它代表所有网卡上的 11434 端口；此时另一个进程再去绑定 127.0.0.1:11434 同样可能失败，因为 0.0.0.0 覆盖了本地回环地址。排查时不能只盯着 11434 端口，还要注意监听地址是通配地址还是具体地址。
Ollama 的监听地址可以通过环境变量 OLLAMA_HOST 修改。例如设置为 0.0.0.0:11434 时允许局域网设备访问，设置为 127.0.0.1:11435 则同时修改地址和端口。先确认你当前环境中是否已经存在这个变量，命令如下：
# 查看当前环境变量中与 Ollama 相关的配置 env | grep -i ollama
如果输出中包含 OLLAMA_HOST=0.0.0.0:11434 或其他端口，那么排查目标应该以这个值为准，而不是默认的 11434。
定位占用端口的进程
遇到地址占用后，第一件事是确认到底哪个进程占用了端口。先不要盲目结束进程，因为那可能是另一个服务、容器或者你自己没注意到的 Ollama 残留实例。Linux 下可以使用 ss 或 netstat 查看监听状态：
# 查看 11434 端口被哪个进程监听 ss -tulpn | grep 11434 # 如果系统里没有 ss，可以使用 netstat netstat -tulpn | grep 11434
macOS 的 netstat 参数与 Linux 略有不同，更适合使用 lsof。命令如下：
# macOS 下查看监听 11434 端口的进程 lsof -nP -iTCP:11434 -sTCP:LISTEN
Windows 用户可以在命令提示符或 PowerShell 中执行：
netstat -ano | findstr :11434 tasklist /FI "PID eq 1234"
上面第一条命令会显示占用 11434 端口的进程 PID，第二条命令用 PID 查询对应的进程名。例如 PID 为 1234，如果进程名是 ollama.exe，说明是残留的 Ollama 实例；如果进程名是 docker.exe 或其他服务，则需要进一步判断是否能结束该进程。
结束冲突进程并处理残留实例
确认占用端口的进程后，需要根据场景决定处理方式。如果占用进程确实是上一次启动的 Ollama，而且没有正在执行模型推理任务，可以直接结束它。Linux 和 macOS 下执行：
# 先通过 PID 查看进程详情，确认是 Ollama 再结束 ps -p 1234 -o pid,ppid,cmd kill 1234 # 如果进程未响应，可以强制结束 kill -9 1234
Windows 下对应的结束命令是：
taskkill /PID 1234 /F
如果占用端口的不是 Ollama，而是其他软件，建议先不要直接结束，尤其是一些系统服务或容器端口映射。这时可以考虑给 Ollama 更换一个空闲端口，避免影响现有服务。修改监听地址和端口的方法是在启动前设置 OLLAMA_HOST：
# Linux/macOS 临时修改端口为 11435 export OLLAMA_HOST=127.0.0.1:11435 ollama serve
Windows PowerShell 中可以使用 $env:OLLAMA_HOST 设置当前会话环境变量，再启动 Ollama。
服务化部署与长期配置
如果你通过 systemd 管理 Ollama，或者在 Windows 上把它作为后台服务运行，单次修改环境变量并不能持久生效。Linux 下使用 systemd 时，可以先查看服务文件位置和当前环境变量配置：
systemctl status ollama systemctl cat ollama
如果需要固定修改端口，建议在服务配置中增加或修改 Environment 行。例如将监听地址改为 127.0.0.1:11435：
[Service] Environment="OLLAMA_HOST=127.0.0.1:11435"
修改后执行 systemctl daemon-reload 并重启服务。Windows 服务化部署则需要通过系统环境变量设置 OLLAMA_HOST，或者修改服务启动参数。重启之前再次用 ss、lsof 或 netstat 检查目标端口，确保新端口没有被其他程序占用。
最后还要注意，修改端口后，所有原本访问 11434 的脚本、客户端配置都需要同步调整。比如调用 curl http://127.0.0.1:11434/api/tags 的地方要改成新的端口。否则虽然 Ollama 正常启动了，后续 API 调用仍然会失败。处理这类问题的核心思路就是先定位监听冲突，再决定是结束残留进程还是更换监听地址，最后把配置固化到服务管理环节。
Ollamabind address already in use端口占用修改时间：2026-09-23 23:08:47