容器连不上宿主机本地模型（Connection Refused / Timeout）

Ollama 默认仅绑定 127.0.0.1:11434。来自 Docker 网桥虚拟网卡（172.17.0.x）的数据包会被宿主机内核直接拒绝。

1. macOS 环境：通过 launchctl 设置 OLLAMA_HOST 环境变量，并彻底重启 Ollama 客户端。
2. Linux systemd 环境：使用 systemctl edit ollama.service 写入 OLLAMA_HOST=0.0.0.0:11434 并重启服务。
3. 安全边界提醒：开放 0.0.0.0 后，请确保云服务器安全组或局域网防火墙未将 11434 暴露至公网。

# macOS (launchctl)
launchctl setenv OLLAMA_HOST "0.0.0.0:11434"
# Then Quit and Reopen Ollama.app

# Linux (systemd override)
sudo mkdir -p /etc/systemd/system/ollama.service.d
printf "[Service]\nEnvironment=\"OLLAMA_HOST=0.0.0.0:11434\"\n" | sudo tee /etc/systemd/system/ollama.service.d/override.conf
sudo systemctl daemon-reload && sudo systemctl restart ollama

[边界说明]绑定 0.0.0.0 会使无鉴权的 Ollama 接口对同局域网设备可见，生产机器建议仅绑定 docker0 IP 或配置防火墙白名单。

在容器独立的网络命名空间内，localhost / 127.0.0.1 指向容器自身，而不是运行本地模型的宿主机。

1. 将容器环境变量 OLLAMA_BASE_URL 或工作流请求地址改为 http://host.docker.internal:11434。
2. 在 docker-compose.yml 中补充 extra_hosts: ["host.docker.internal:host-gateway"]。

services:
  open-webui:
    environment:
      - OLLAMA_BASE_URL=http://host.docker.internal:11434
    extra_hosts:
      - "host.docker.internal:host-gateway"

[边界说明]配合 extra_hosts 后，该配置可在 macOS、Windows Docker Desktop 与 Linux Docker Engine 下保持完全一致。

与 Mac/Windows 的 Docker Desktop 不同，原生 Linux Docker 默认不会往容器 /etc/hosts 注入 host.docker.internal。

1. 在 docker-compose.yml 对应服务下添加 extra_hosts: ["host.docker.internal:host-gateway"]。
2. 执行 docker compose up -d --force-recreate 重建容器使 hosts 映射生效。

docker run -d \
  --name tinker-open-webui \
  --add-host=host.docker.internal:host-gateway \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -p 3000:8080 \
  ghcr.io/open-webui/open-webui:v0.5.10

[边界说明]需要宿主机 Docker Engine 版本 ≥ 20.10。

Linux 宿主机的 UFW 或 firewalld 拦截了来自 docker0 / 自定义网桥（172.16.0.0/12）发往宿主机 11434 端口的数据包。

1. 仅针对 Docker 私有网段（172.16.0.0/12）放行宿主机 11434 TCP 端口，避免对公网敞开。
2. 重载防火墙规则并重新在容器内执行探测。

sudo ufw allow from 172.16.0.0/12 to any port 11434 proto tcp comment "Allow Docker containers to local Ollama"
sudo ufw reload

[边界说明]限制源网段为 172.16.0.0/12 可确保只有本机容器能访问模型接口，外部局域网依然受防火墙保护。