故障排查 / 框架环境
手机/另一台电脑访问家里跑的模型:连接被拒
本站未复现 改写 影响:llama.cpp / Ollama / LM Studio 全版本 · Windows / Linux / macOS
报错原文
Connection refused | Failed to connect | ECONNREFUSED | cannot reach host
这段字符串可以直接粘到 站内搜索 或外部搜索引擎里找。
现象
服务在自己那台电脑上跑得好好的,同一局域网的手机/另一台电脑却连不上;有人加了 --host 0.0.0.0 还是连不上。
原因
llama-server / Ollama 默认只监听 127.0.0.1(本机回环),不把服务暴露到局域网;要暴露得显式绑定 0.0.0.0、用对端口、并在防火墙放行对应端口。macOS 的防火墙弹窗对后台无界面服务有时根本不弹,关掉 firewall 也不一定生效。
按这个顺序处理
- 显式绑所有接口:llama-server 用 --host 0.0.0.0 --port 8080;Ollama 用环境变量 OLLAMA_HOST=0.0.0.0 再重启 ollama serve。
- 用局域网 IP 而不是 localhost:手机访问 http://192.168.x.x:8080(那台电脑的 IP),先在电脑上 ping 通确认在同一网段。
- 放行防火墙端口:Windows 网络与防火墙→高级设置→入站规则放开对应端口;Ollama 默认 11434,llama.cpp 常见 8080。
- 绑定时别写成具体 IP:--host 192.168.x.x 这种写法 IP 一换就失效,用 0.0.0.0 更稳。
- 安全红线:只放在局域网内,别把端口映射到公网——没鉴权的服务暴露在公网上会被滥用。
怎么确认解决了
在同一局域网的另一台设备上用 http://<电脑IP>:<端口> 能连上并返回正常响应;本机 localhost 仍可用,公网应连不上。
来源与可信度
条目性质依据公开事实与社区普遍报告,用本站自己的话重写(未搬运任何他人文章段落)
是否已在本站机器复现否——请把这条当线索而不是结论
- https://github.com/ggml-org/llama.cpp/discussions/5275 — llama.cpp 官方讨论:--host 0.0.0.0 仍无法局域网访问、防火墙对无界面服务不弹窗,对应'绑定/防火墙'处置
- https://www.wsisp.com/helps/35698.html — Ollama 默认端口 11434、需开放防火墙端口才能让局域网访问,对应'防火墙放行端口'处置
- https://dev.to/alichherawalla/how-to-use-a-remote-ollama-or-llamacpp-server-from-a-desktop-ai-app-on-windows-in-2026-40pa — 桌面端通过 --host 0.0.0.0 远程连本地 llama-server,对应'绑所有接口+端口'处置
- https://docs.purechat.cn/guides/ollama.html — OLLAMA_HOST 0.0.0.0 与局域网访问配置、查监听地址,对应'Ollama 改监听'处置
相关条目
no CUDA devices / unrecognized error code / hipErrorNotFound起不来 · 二进制直接不认显卡,日志里一句 no devices 或者满屏 unrecognized error code;CPU 后端能跑但速度是个位数。从 0 到跑通第一个模型,具体要走几步?五步:确认驱动 → 装一个框架 → 下载一个 GGUF → 用命令行起服务 → 打开网页界面聊天。卡住的位置 90% 在第二、三步。llama.cpp、Ollama、LM Studio、vLLM 我该用哪个?想控制显存和参数用 llama.cpp;想一条命令搞定用 Ollama;想要图形界面用 LM Studio;想要高并发服务很多人用 vLLM。新手第一站推荐 LM Studio。