ollama 设置 0.0.0.0 windows

模型与算力

给 Windows 用户讲清怎么让 Ollama 监听 0.0.0.0,让同一局域网里的手机、同事电脑和别的服务能连上,并给出验证顺序和放开的边界。

你在 Windows 上装好 Ollama,本机用着没问题,但手机、另一台电脑或者局域网里的 Dify、Open WebUI 就是连不上,多半是它只绑了本机回环地址。这篇按「先确认现状、再改绑定、最后验证和收口」的顺序走一遍,说明改哪、怎么改、改成什么样算成功;也会讲什么网络环境下不该这么干。

你在 Windows 上把 Ollama 装好,本机开着终端问它问题一切正常。可一旦换成手机、同事那台电脑,或者局域网里跑的 Dify、Open WebUI 来连,就一直转圈或者直接超时。这种情况八成不是模型的问题,而是 Ollama 只绑在了本机回环地址上,压根没打算接外来的请求。

下面按「先看现状、再改绑定、再从别的设备验证、最后收口」这个顺序走一遍。每一步都给出判断标准,你照着做就能知道自己是卡在哪一层。网络环境特殊的情况单独说,因为有些网络下你怎么改都连不上,不是你的操作错了。

先确认它现在到底绑在哪

最常见的误判是把「服务没起来」和「起来了但不对外」混成一件事。默认只绑回环地址时,本机请求能通、别的机器一律超时,表现完全一样,但处理方式不一样。先分清楚是哪一种,再动手。

  1. 看端口落在哪个地址打开 PowerShell,用 netstat 查一下 Ollama 默认端口的监听地址。如果显示的是 127.0.0.1 开头的回环地址,说明它只认本机;如果显示 0.0.0.0 或具体的网卡地址,那绑定这步已经没问题了。
  2. 本机请求一次接口在本机用 127.0.0.1 加端口请求一下接口(比如列模型列表),能返回内容就说明服务本身是活的。这一步通过、外面连不上,问题就锁定在绑定或防火墙,而不是服务没启动。
  3. 连本机都不通就先别改绑定如果本机请求也失败,先确认进程在不在、端口有没有被别的程序占。这时候去改绑定地址没有任何意义,改了也不会变好。

改绑定:环境变量的两种设法

核心动作是让 Ollama 启动时读到一个把它绑到全零地址的配置项。读不到,它就一直是默认回环。这里的关键是「进程启动那一刻能读到」,不是「你设过就算」。改完必须把已有进程杀掉重新拉起,否则旧进程还按老配置跑着,你会以为改失败了。

设法适用场景注意点
当前会话临时设一次性调试、试完就还原只对这个终端里启动的进程生效,关掉窗口就没了
写进系统环境变量想让它长期对外提供服务设完要重启服务甚至重启机器,旧进程不会自动认新值
改端口一起做默认端口被占用或想避开冲突放行规则要和你改后的端口一致,别一个改了一个没改

判断改成功没有,看的不是「我设过环境变量」,而是回到上一步,监听地址从回环变成了全零。这一步没变,后面全是白忙。如果端口也动过,顺手确认防火墙放行的是同一个端口。

# 方式一:只在当前会话生效,然后从这个窗口启动 ollama
set OLLAMA_HOST=0.0.0.0
ollama serve

# 方式二:写进系统环境变量(需要重开终端或重启后生效)
setx OLLAMA_HOST 0.0.0.0

# 改完杀掉旧进程再重新拉起
# 然后回头用 netstat 确认监听地址变了

从别的设备验证,别只看本机

本机换 IP 请求能通,只说明它监听的范围变大了,不代表外面真能进来。真正的验证一定在另一台设备上做。按下面三层顺序推,哪一层断了,问题就在那一层,不用瞎猜。

  • 本机用局域网 IP 加端口请求一次,确认服务愿意在这个地址上回应;
  • 同网段另一台电脑请求同一个地址端口,通了说明绑定和网段都没问题;
  • 手机连同一个 WiFi 再请求一次,还通基本就成;
  • 如果第二层通、第三层不通,多半是手机所在频段或隔离策略的问题,不是服务的问题。

Windows 防火墙默认会拦入站请求,这几乎是必踩的一关。正确做法不是把防火墙整个关掉,而是给对应的程序和端口加一条放行规则,并确认规则生效的范围(专用网络还是公用网络)和你现在连的网络对得上。

什么时候不该开,开了怎么收口

把服务放到全零地址,等于同网段任何设备都能调你的模型。自己家里的实验环境无所谓,但办公网、共享网络、涉及敏感数据的时候,这个默认动作就不适用了,别顺手就开。

场景建议原因
家里自用、临时联调可以开,用完记得收同网段基本只有你自己的设备
办公室共享网络尽量别全开,只对需要的机器开同网段别人也能扫到并调用
需要跨网段长期提供加一层反向代理做鉴权直接暴露端口没有访问控制
服务要长期稳定给内网用把本机 IP 固定下来地址一变,连接方就会莫名失联

更稳的替代思路不是全零放开,而是只对指定网卡地址放开,配合防火墙按来源限定。真要跨网段,反向代理那一层还能加鉴权,比裸端口安全得多。

用完就收:把环境变量摘掉或恢复默认,重启服务,删掉为调试加的防火墙放行规则。别让一个调试用的配置长期挂在办公机上,过几个月你自己都忘了它开着。如果你确实要长期对外提供,记得把本机 IP 固定,否则路由器重新分配地址后,连接方会毫无征兆地连不上。

帮别人选服务前先看这里如果你自己搭 Ollama 是为了接某个中转或本地工具,动手前建议先到站内的中转站检测页核对对方的可用性和历史表现,免得多花时间在已经不稳的服务上。

常见问题

改完还是连不上,最先查什么?

先查进程是否真的重启过:环境变量改了但旧进程还在跑,监听地址不会变。其次确认防火墙放行的是当前端口和程序,最后换一台同网段设备再试一次。如果在公司网络里,很可能是客户端隔离,用手机热点对拉一下就能判断。

这样设了有安全风险吗?

有。全零地址意味着同网段的任何设备都能调用你的模型和接口,读写都不需要额外验证。个人家里自用问题不大,办公网、宿舍网或公共网络不建议这么开。要长期对外,前面加一层带鉴权的代理更合适。

能不能只让某一台设备访问?

可以,思路是不绑全零地址,而是绑到那块网卡的局域网地址,再配合防火墙只放行那一台设备的来源地址。这样比全零放开可控得多,代价是设备地址变了要跟着调整,所以建议搭配固定地址使用。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。