笙亿网络策划

本地运行 Ollama 如何修改默认端口 11434 避免与其他服务冲突

约 6 分钟读完 117 阅
文章导读
修改 Ollama 默认端口最直接的方式是通过环境变量 OLLAMA_HOST 控制服务端监听地址，客户端同步配置即可解决冲突，适用于端口被占用或需要局域网访问的场景。
📋 目录
  1. Ⅰ 命令速用版
  2. Ⅱ 为什么会这样
  3. Ⅲ 分步处理
  4. Ⅳ 怎么验证是否生效
  5. Ⅴ 常见坑
  6. Ⅵ 参考来源
A A

修改 Ollama 默认端口最直接的方式是通过环境变量 OLLAMA_HOST 控制服务端监听地址，客户端同步配置即可解决冲突，适用于端口被占用或需要局域网访问的场景。

先说结论：通过设置环境变量 OLLAMA_HOST 修改服务端监听端口，并确保客户端连接地址同步更新，可避免 11434 端口冲突。

  • 适合：端口被占用、需要局域网访问、配合反向代理或统一端口规范。
  • 先准备：确认新端口未被占用，区分服务端配置与客户端连接配置。
  • 验收：使用 netstat 检查端口监听状态，通过 curl 或客户端命令验证连接。

命令速用版

# Linux 临时修改并启动
export OLLAMA_HOST="0.0.0.0:8080"
ollama serve

# Windows PowerShell 临时修改
$env:OLLAMA_HOST="0.0.0.0:8080"
ollama serve

# Docker 启动映射端口
docker run -d -p 8080:11434 `--name` ollama ollama/ollama

# 验证端口监听 (Linux/macOS)
lsof -i:8080
# 验证端口监听 (Windows)
netstat -aon|findstr 8080

为什么会这样

Ollama 默认监听 127.0.0.1:11434，这在单机运行时没问题，但在实际开发中常遇到端口被占用（如其他服务已使用 11434）或需要对外暴露 API 的情况。修改端口涉及两个部分：服务端决定监听哪个 IP 和端口，客户端决定连接哪里。如果只改服务不改客户端，命令行工具或 API 调用会因连接默认地址失败而报错。

分步处理

1. 确认端口占用情况
在修改前，先确认 11434 是否真的被占用，以及占用进程是否为 Ollama。
Windows 执行：netstat -aon|findstr 11434
Linux/macOS 执行：lsof -i:11434
若发现非 Ollama 进程占用，需先终止冲突进程或更换 Ollama 端口。

2. 修改服务端配置（永久生效）
Linux (systemd):
创建覆盖配置目录：sudo mkdir -p /etc/systemd/system/ollama.service.d
写入配置：sudo tee /etc/systemd/system/ollama.service.d/override.conf
内容如下：

[Service]
Environment="OLLAMA_HOST=0.0.0.0:8080"

重载并重启：sudo systemctl daemon-reload && sudo systemctl restart ollama.service
Windows:
可通过系统环境变量设置 OLLAMA_HOST，或在启动脚本中设置。部分资料提到配置文件路径为 C:\Users\<用户名>\.ollama\config.json，内容 {"OLLAMA_HOST":"0.0.0.0:8080"}，修改后需重启服务。
Docker:
启动时通过 -p 参数映射，如 -p 8080:11434，宿主机 8080 对应容器内 11434。

本地运行 Ollama 如何修改默认端口 11434 避免与其他服务冲突

3. 配置客户端连接
修改端口后，客户端必须显式指定新端口。
命令行：ollama run llama2 `--host` http://localhost:8080
Python 客户端：client = Client(host='http://localhost:8080')
若使用第三方工具（如 Chatbox），需在设置中将接口地址改为 http://localhost:8080。

怎么验证是否生效

1. 检查端口监听
使用 netstat 或 lsof 确认新端口（如 8080）处于 LISTENING 状态，且进程名为 ollama。
2. API 接口测试
调用接口获取模型列表：curl http://localhost:8080/api/tags
若返回 JSON 数据包含模型信息，说明服务正常。
3. 客户端连接测试
执行 ollama list 或运行模型，若未报错且能正常对话，说明客户端配置正确。

常见坑

1. 客户端未同步修改
只改了服务端端口，客户端仍连接 11434，会报“server not responding”。务必检查所有调用方的配置。
2. 防火墙拦截
若设置 OLLAMA_HOST=0.0.0.0 允许局域网访问，需确保防火墙或安全组放行了新端口，否则外部机器无法连接。
3. 0.0.0.0 与 127.0.0.1 的区别
仅本地使用建议绑定 127.0.0.1，更安全；若需局域网访问才用 0.0.0.0。
4. Docker 端口映射
Docker 模式下，容器内端口通常保持 11434 不变，修改的是宿主机映射端口，客户端连接的是宿主机 IP 和映射端口。

参考来源

  • 【超详细】Ollama 修改默认端口 (11434 → 8080) 完整指南:systemd + Shell + 客户端全适配_ollama 修改端口-CSDN 博客
  • Ollama 修改默认端口方法
  • Ollama 启动失败，端口冲突终极解决方案：一劳永逸解决 WinNAT 占用 11434 端口问题
  • 解决 Ollama 端口冲突:Error listen tcp 127.0.0.1:11434 bind 问题