Ollama 装完默认只有本机能连,手机、同事的电脑、另一台跑前端或知识库的机器一律连不上,报错通常是连接被拒绝或超时。这篇按顺序给一套排查动作:先搞清 0.0.0.0 到底改了什么,再改监听地址和端口,然后处理防火墙与网段隔离,最后用 curl 和客户端各验一遍。也会写明哪些环境不建议这么开。
Ollama 装完默认只有本机能连。手机、同事的电脑、另一台跑前端或知识库的机器一律连不上,报错通常是「连接被拒绝」或「连接超时」。多数人第一反应是去改客户端配置,其实问题在服务端根本没往局域网那侧开门。
下面按顺序给一套动作:先搞清 0.0.0.0 到底改了什么,再改监听地址和端口,然后处理防火墙与网段隔离,最后用命令行和客户端各验一遍。中间会说明哪些环境不建议这么开。
先弄清 0.0.0.0 和 127.0.0.1 差在哪
- 127.0.0.1
- 本机回环地址,只接受从这台机器自己发出的请求,别的设备根本看不到这个服务
- 0.0.0.0
- 不是某个具体地址,而是「在所有网卡上监听」的意思,局域网设备才有机会连上
- 本机局域网 IP
- 比如路由分给这台机器的那个地址,直接写它也能通,但换网络或改 IP 后要重新配
要分清两件事:改监听地址只是让服务「愿意接」局域网请求,能不能真连上还取决于防火墙和路由。前者是应用层的事,后者是网络层的事,排查看两者要分开看,不要混在一起试。
- 只改监听地址、没放行端口:客户端表现为连接超时
- 服务压根没起或端口错了:客户端表现为连接被拒绝
- 网段被隔离或路由不通:同一网段能通、跨网段不通
- 写 0.0.0.0 省事但暴露面变大,只在可信内网用
改监听地址:环境变量与启动参数两条路
Ollama 服务端的监听地址一般通过环境变量指定 host。改完必须重启服务进程才生效,只关掉当前终端窗口再开一个是不算的——很多人卡在这一步,以为改了没用。
- 确认当前监听状态在服务机上用 netstat 或 ss 看 Ollama 端口绑在哪个地址上,绑在 127.0.0.1 说明只对本机开放,绑在 0.0.0.0 或 * 说明已经在监听所有网卡
- 设置监听 hostLinux 写进 shell 配置或服务管理的环境文件;Windows 改系统环境变量后重启 Ollama 服务进程,别只重启命令行
- 处理端口冲突启动前先查这个端口有没有被别的进程占着,占了就换端口或停掉旧进程,别硬启
- 重启并回看监听状态重启服务后再查一次监听地址,确认从回环变成了所有网卡,这一步不过关后面全白搭
# 查监听地址(Linux/macOS)\nss -tlnp | grep ollama\n\n# 临时指定监听地址启动(仅当前会话)\nOLLAMA_HOST=0.0.0.0:11434 ollama serve\n\n# 从另一台机器测连通\ncurl http://<服务机局域网IP>:11434/防火墙、网段与访问控制三件事
本机放行端口只是第一步。路由器或交换机的网段隔离、公司网络的分区策略、客户端的私有网络开关,都可能让请求半路到不了。这几层要一层层排,不要一上来就怀疑模型服务本身。
| 现象 | 先查哪里 | 下一步动作 |
|---|---|---|
| 本机能通、别的设备超时 | 服务机防火墙 | 放行该端口,或临时关掉防火墙验证 |
| 同一网段能通、跨网段不通 | 路由器/网段隔离 | 确认两个网段之间是否允许该端口通信 |
| 连接被拒绝 | 服务是否在跑、端口对不对 | 查监听地址和进程状态,别只改客户端 |
| 时通时断 | 无线信号、IP 变化 | 给服务机配固定 IP 或 DHCP 保留 |
如果只是想找免费的在线接口做对照,可以到 中转站导航(/sites) 里挑几个候选,再配合 中转站真假在线实测(/tools/verify) 做一次连通性对照。别凭一次成功就下结论,网络这东西很看当时的环境。
从另一台设备验证:三步确认法
验证要按顺序来,每一步只排除一类问题,跳过任何一步后面都会返工。这三步做完,基本能定位是服务、网络还是客户端配置的问题。
- 第一步:服务机上自测在服务机上用本机回环地址调一次接口,能返回说明服务本身正常,把服务问题先隔离掉
- 第二步:局域网内他机调用从另一台设备用服务机的局域网 IP 加端口调一次,失败就回到网络层排查防火墙和路由
- 第三步:客户端里改地址客户端软件里要填服务机的局域网 IP 加端口,不是 localhost。填 localhost 会指向客户端自己,必然失败,这是最常见的坑
- 先在服务机 curl 本机地址,服务正常再往下走
- 再 curl 局域网 IP,通了说明网络层没问题
- 最后在客户端软件里改地址,用局域网 IP 而非回环地址
- 两条测试都通了、客户端还失败,基本就是客户端配置或它自己的网络策略
什么情况下不要这么开
开放监听等于把模型和机器资源挂在网上,谁能连上谁就能调。便利和暴露面是一起涨的,这一点要先想清楚,再决定要不要开。
- 要暴露到公网、或接到公共 Wi-Fi 时,不要直接开,得先做认证或干脆不开
- 多人共用的办公网里要确认是否符合你们的运维与合规要求,别自己偷偷开
- 只有本机应用调用时保持默认监听就行,没必要为省事扩大暴露面
- 不确定该不该开时,先按最小范围放行:只允许特定 IP 访问
如果你同时还在挑在线模型接口,价格和可用性这类会变的数字,一律去站内页面核对当时的数字,不要凭印象下判断。本地部署和在线调用各有用处,关键是知道各自的暴露面和维护成本。
下一步改完监听地址、放行端口、他机验证通过之后,建议顺手做一次在线接口的连通性对照,确认你现在的网络策略不会误伤正常调用。→常见问题
改成 0.0.0.0 之后其他设备还是连不上,先查什么?
按顺序查三层:服务是否真的重启并生效、本机防火墙是否放行了该端口、两台设备是否在同一网段且路由可达。报错「连接被拒绝」多半是服务或端口问题,报错「超时」则偏向防火墙或网络隔离。先在本机用回环地址自测一次,能通说明服务没问题,问题在网络层。
手机上想用局域网里的 Ollama,需要额外装什么东西吗?
服务端按本文改监听地址、放行端口即可,客户端只需要能发 HTTP 请求。用浏览器或支持自定义接口地址的客户端,把地址填成服务机的局域网 IP 加端口,不要填 localhost。手机和电脑要在同一个 Wi-Fi 下,公司网络若是隔离网段,跨网段访问可能被拦,这种要单独确认网络策略。
局域网访问要不要加鉴权?
看你的网络可信程度。纯家庭内网、设备都是自己的,通常按监听配置直接调就行;办公网、合租网络或任何你无法确认接入设备的场景,建议加一层反向代理做鉴权,或者只在需要时临时开启。Ollama 本身的接口鉴权口径可以去站内 官方 API 价格(/official-api) 与模型库相关页面核对,别凭印象设定。