- SQLite 纯 Go 驱动(modernc.org/sqlite),支持 CGO_ENABLED=0 跨平台编译
- 优化并发性能(WAL 模式),解决 "database is locked" 错误 - Docker 跨平台支持 `host.docker.internal` 访问宿主机服务 - 精简文档和部署指南
This commit is contained in:
79
DOCKER_HOST_ACCESS.md
Normal file
79
DOCKER_HOST_ACCESS.md
Normal file
@@ -0,0 +1,79 @@
|
||||
# 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. **防火墙阻止** - 检查防火墙规则或临时关闭测试
|
||||
Reference in New Issue
Block a user