用 Docker 部署 Ollama 并让局域网内其他设备访问,核心动作有两个:把容器端口 11434 映射到宿主机,以及让 Ollama 进程监听所有网络接口而不是默认的 127.0.0.1。这两个条件缺一不可。以下步骤适用于同一个局域网内的笔记本、手机或另一台服务器直接通过宿主机 IP 访问,不涉及跨网段和公网暴露。
前置条件
开始前需要确认宿主机的 Docker 环境可用,并已拉取基础镜像。局域网内的其他设备需要能够 ping 通宿主机 IP。如果宿主机开启了防火墙,需要放行 TCP 11434 端口,或先临时关闭以便定位问题。以下操作均在宿主机 shell 中执行。
- Docker 版本不低于 20.10,老旧版本可能存在端口映射行为差异。
- 确认宿主机局域网 IP,例如
ifconfig或ip addr中对应网卡的地址。 - 准备一个模型存储目录,例如
/opt/ollama,并确保 Docker 用户对该目录有读写权限。 - 根据自己的业务选择桥接网络还是 host 网络,这里以桥接网络映射端口为例。
部署容器
拉取镜像后启动容器,使用 -p 11434:11434 将容器的 11434 端口映射到宿主机的所有网卡。通过环境变量 OLLAMA_HOST=0.0.0.0 让 Ollama 服务暴露在容器内所有 IP 上,这样外部请求才能进来。挂载目录用于保存模型,避免容器重建后模型丢失。
docker run -d `--name` ollama -p 11434:11434 -v /opt/ollama:/root/.ollama -e OLLAMA_HOST=0.0.0.0 ollama/ollama注意 -p 左侧是宿主机端口,右侧是容器端口。如果宿主机 11434 已被占用,可以改成宿主机其他端口,例如 -p 11435:11434,此时局域网访问地址变为 http://宿主IP:11435。启动后通过 docker ps 查看容器状态,应显示 Up。
验证局域网访问
在局域网内另一台设备上用 curl 测试端口连通性。如果返回内容包含 Ollama 相关的响应体和 HTTP 状态码(不一定为 200),说明端口已连通。可以用 Ollama 官方客户端或 Python 库设置 OLLAMA_HOST 指向宿主机 IP 后,执行模型拉取和推理。
curl http://192.168.1.100:11434/如果这条命令在局域网内返回类似 Ollama is running 的文本,或者至少是 HTTP 响应而不会 timeout,就说明服务已经对外开放。更进一步的验证是在另一台机器上使用 ollama run 并将 OLLAMA_HOST 设置为宿主机 IP。这里不需要贴出模型的输出结果。
排查与回退
常见的失败原因有三类:容器未正常启动、端口映射未生效、防火墙或 SE Linux 拦截。先执行 docker logs ollama 查看容器日志,确认 Ollama 是否监听在 0.0.0.0。再用 docker port ollama 查看端口映射是否正确。如果容器内正常但外部不可访问,检查宿主机防火墙,例如 ufw status 或 firewall-cmd `--list-all`。确认需要放行 TCP 11434 端口。
如果临时无法解决,可以改用 host 网络模式重新部署,这样容器直接使用宿主机网络,Ollama 会绑定到宿主机所有接口上,端口映射问题由 Docker 处理,不再需要额外配置。
docker run -d `--name` ollama-host `--network` host -v /opt/ollama:/root/.ollama -e OLLAMA_HOST=0.0.0.0 ollama/ollamahost 网络模式适合 Linux 环境,Windows 和 macOS 的 Docker Desktop 对 host 网络支持有限,所以需要先确认当前系统环境。回退方案只是将访问入口调整到宿主机的宿主机 IP 的 11434 端口,数据目录保持一致。
注意事项
以上方案仅适合信任的局域网环境。如果宿主机本身有公网 IP 或开启了端口转发,11434 端口就会暴露到公网,此时需要设置访问认证或限制来源 IP,不能直接用裸端口。Ollama 本身没有内置的访问控制,需要自行通过反向代理或防火墙规则补上。