bug: could not reach server on internal network

快速结论：“bug: could not reach server on internal network” 常见于在 macOS 上使用 Open WebUI 桌面客户端时，在连接（Connections）里填入局域网 / 内网 AI 服务地址（如 http://x.x.x.x:port/v1）后连接失败，而同一台机器在终端用 curl / telnet 可以正常访问。优先排查客户端填写连接的位置与连接配置入口，而不是先怀疑网络本身。

适用环境：Issue 中已确认：Open WebUI 桌面版（fresh install）、Open WebUI Version 为 latest、操作系统 macOS 26、安装方式为 Other；Ollama 版本未提供（nd），浏览器为 none。未确认 Python、CUDA、PyTorch、显卡等信息。

最快修复方案：暂无确认的一步修复方案。Issue 作者最终自行定位到问题出在连接配置的位置/入口上（”where the heck I should configure connections in a clean way”，即从聊天界面模型菜单以外的路径找不到管理连接的入口），但讨论中未给出经维护者验证的具体操作步骤。

注意事项：该 Issue 在讨论中主要被机器人提示标题格式问题，并关联到 #7197、#1375 等相似连接问题；作者明确表示其场景是远程服务器、终端可用、只有 Open WebUI 桌面应用不行，且未看到 macOS 隐私与安全授权弹窗。这些都只是现象线索，尚未形成已验证的官方修复结论；下述步骤为基于 Issue 讨论的排查方向，可优先尝试。

问题场景

用户在 macOS 26 上全新安装 Open WebUI 桌面客户端，尝试连接局域网内的 AI GPU 服务器（LLM 运行在指定端口），在连接设置中点击 “+” 填入类似 http://10.10.1.110:5007/v1 的地址，客户端提示 “could not reach this server”。同一台 Mac 在终端用 telnet 能连通该端口、用 curl 带 Bearer 也能正常请求。作者后续指出，Open WebUI 桌面应用似乎根本没有发起局域网连接请求，也没有出现 macOS 隐私与安全（本地网络访问）授权弹窗。

报错原文

could not reach this server
bug: could not reach server on internal network

原因分析

可能原因：一是连接配置填写的位置/入口不对。作者最初以为聊天界面的 “+” 连接入口就是配置连接的地方，但最终发现并非如此，且明确追问在 Settings 之外、不通过聊天界面的模型菜单，如何找到管理连接的菜单。说明问题很可能不是服务器不可达，而是连接地址没有被写进正确的连接配置中。

二是客户端侧的连接校验行为差异。关联 Issue #1375 提到 macOS 客户端对 HEAD 请求（/ollama/）处理不当导致 “cannot reach server” 一类表现，说明桌面端在验证服务器可达性时可能和终端 curl 的结果不一致。这属于可能原因，尚未在本 Issue 中被确认为主因。

三是 macOS 本地网络权限。作者观察到没有出现隐私与安全授权请求，怀疑应用未真正尝试访问局域网，但这只是作者的推测，Issue 中没有日志或抓包证据支持。

环境排查

确认 Open WebUI 版本：桌面版且为 latest，需与当前 dev / release 行为对齐。
确认 macOS 版本为 26，并检查“系统设置 → 隐私与安全性 → 本地网络”中是否出现 Open WebUI 条目及其开关状态。
确认服务器地址格式：是否带 http:// 前缀、端口是否正确、是否带 /v1 后缀，与终端中 curl 成功的完整 URL 保持一致。
确认终端侧验证方式：telnet 端口可达、curl 携带 Bearer Token 可通，说明服务端与网络链路本身没问题。
Ollama 版本在 Issue 中标记为 nd（未提供），如涉及 Ollama 服务端，需另行确认其版本与监听地址。
Open WebUI 的 Python、CUDA、PyTorch、显卡信息在 Issue 中均未提供，无需作为本问题的前置条件。

解决步骤

先在终端复现服务端连通性：用与客户端中完全相同的 URL（协议、IP、端口、/v1 路径）执行 curl 并携带 Bearer Token，确认返回正常。Issue 作者已确认此步可用。
不要在聊天界面的模型菜单里随手点 “+” 就认为已完成连接配置，改为查找 Open WebUI 设置中专门管理连接（Connections / 外部连接）的配置入口。Issue 作者确认问题出在配置位置，但未在讨论中给出该入口的准确路径。
在连接配置中新增 OpenAI 兼容连接，填入 http://x.x.x.x:port/v1 形式的 Base URL 与对应 API Key，保存后回到聊天界面选择该连接下的模型进行测试。
若保存后仍报 “could not reach this server”，检查 macOS “隐私与安全性 → 本地网络”中 Open WebUI 是否被允许访问本地网络；如无该条目，重启应用后再次触发连接，观察是否弹出授权请求。
若仍未解决，可参考关联 Issue #7197（MacOS 客户端连局域网 / Docker 上的 Ollama 服务失败但 curl 正常）与 #1375（macOS 客户端 HEAD 请求校验导致 405 与不可达表现），确认是否属于客户端可达性校验的已知问题，并在原 Issue 中补充日志与抓包信息。

验证方法

在连接配置中保存地址后，回到聊天界面能看到并选中该连接对外暴露的模型，发送一条测试消息并收到正常回复，即说明连接已生效。若仍在连接测试或保存阶段出现 “could not reach this server”，则记录此时 macOS 本地网络权限状态，并与终端 curl 的结果对比，用于判断是配置入口问题还是客户端网络权限 / 校验问题。