249ba3d4aa
- 优化并发性能（WAL 模式），解决 "database is locked" 错误 - Docker 跨平台支持 `host.docker.internal` 访问宿主机服务 - 精简文档和部署指南
80 lines
1.6 KiB
Markdown
80 lines
1.6 KiB
Markdown
# Docker 容器访问宿主机服务指南
|
|
|
|
## 核心配置
|
|
|
|
Docker 容器内使用 `http://host.docker.internal:端口号` 访问宿主机服务。
|
|
|
|
### macOS / Windows
|
|
|
|
直接使用，无需额外配置。
|
|
|
|
### Linux
|
|
|
|
**docker-compose** - 已在 `docker-compose.yml` 配置：
|
|
```yaml
|
|
extra_hosts:
|
|
- "host.docker.internal:host-gateway"
|
|
```
|
|
|
|
**docker run** - 需添加参数：
|
|
```bash
|
|
docker run --add-host=host.docker.internal:host-gateway ...
|
|
```
|
|
|
|
## Ollama 配置示例
|
|
|
|
### 1. 宿主机启动服务
|
|
|
|
```bash
|
|
# 监听所有接口（重要）
|
|
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` |
|
|
|
|
## 验证和故障排查
|
|
|
|
### 测试连接
|
|
|
|
```bash
|
|
# 进入容器测试
|
|
docker exec -it huobao-drama sh
|
|
wget -O- http://host.docker.internal:11434/api/tags
|
|
|
|
# 查看容器日志
|
|
docker logs huobao-drama -f
|
|
```
|
|
|
|
### 常见问题
|
|
|
|
**Connection refused**
|
|
|
|
1. **宿主机服务未运行** - 检查服务状态
|
|
```bash
|
|
curl http://localhost:11434/api/tags
|
|
```
|
|
|
|
2. **服务未监听 0.0.0.0** - Ollama 默认只监听 127.0.0.1
|
|
```bash
|
|
export OLLAMA_HOST=0.0.0.0:11434
|
|
ollama serve
|
|
```
|
|
|
|
3. **防火墙阻止** - 检查防火墙规则或临时关闭测试
|