Files
huobao-drama/DOCKER_HOST_ACCESS.md
Connor 249ba3d4aa - SQLite 纯 Go 驱动(modernc.org/sqlite),支持 CGO_ENABLED=0 跨平台编译
- 优化并发性能(WAL 模式),解决 "database is locked" 错误
- Docker 跨平台支持 `host.docker.internal` 访问宿主机服务
- 精简文档和部署指南
2026-01-16 10:30:59 +08:00

1.6 KiB

Docker 容器访问宿主机服务指南

核心配置

Docker 容器内使用 http://host.docker.internal:端口号 访问宿主机服务。

macOS / Windows

直接使用,无需额外配置。

Linux

docker-compose - 已在 docker-compose.yml 配置:

extra_hosts:
  - "host.docker.internal:host-gateway"

docker run - 需添加参数:

docker run --add-host=host.docker.internal:host-gateway ...

Ollama 配置示例

1. 宿主机启动服务

# 监听所有接口(重要)
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

2. 前端 AI 服务配置

字段
Base URL http://host.docker.internal:11434/v1
Provider openai
Model qwen2.5:latest
API Key ollama 或留空

3. 其他服务端口

服务 默认端口 Base URL
Ollama 11434 http://host.docker.internal:11434/v1
LM Studio 1234 http://host.docker.internal:1234/v1
vLLM 8000 http://host.docker.internal:8000/v1

验证和故障排查

测试连接

# 进入容器测试
docker exec -it huobao-drama sh
wget -O- http://host.docker.internal:11434/api/tags

# 查看容器日志
docker logs huobao-drama -f

常见问题

Connection refused

  1. 宿主机服务未运行 - 检查服务状态

    curl http://localhost:11434/api/tags
    
  2. 服务未监听 0.0.0.0 - Ollama 默认只监听 127.0.0.1

    export OLLAMA_HOST=0.0.0.0:11434
    ollama serve
    
  3. 防火墙阻止 - 检查防火墙规则或临时关闭测试