46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 历史数字我：本地 Docker Compose
|
||
|
||
## 启动
|
||
|
||
1. 启动 Docker Desktop，或执行 `colima start`。
|
||
2. 在本目录执行：
|
||
|
||
```bash
|
||
cp .env.docker.example .env.docker
|
||
docker compose --env-file .env.docker up --build -d
|
||
```
|
||
|
||
本机浏览器打开：<http://localhost:8080>
|
||
|
||
同一局域网内的手机或电脑打开：<http://192.168.110.3:8080>
|
||
|
||
局域网 IP 可能在重新连接 Wi-Fi 后变化。可在 Mac 上执行以下命令查看当前地址，
|
||
并同步修改 `.env.docker` 中的 `PUBLIC_URL`、`CORS_ORIGINS` 和 `WEB_BASE_URL`：
|
||
|
||
```bash
|
||
ipconfig getifaddr en0
|
||
```
|
||
|
||
后端健康检查：<http://localhost:8080/health>
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
docker compose --env-file .env.docker ps
|
||
docker compose --env-file .env.docker logs -f backend web mongo
|
||
docker compose --env-file .env.docker down
|
||
```
|
||
|
||
数据默认保存在 Docker named volumes 中。普通 `down` 不会删除数据；只有显式执行
|
||
`docker compose down -v` 才会删除本地 MongoDB 与上传数据。
|
||
|
||
## 本地模式说明
|
||
|
||
- MongoDB、后端、前端/Nginx 共三个容器。
|
||
- 前端 `8080` 端口监听局域网；Nginx 将同源 API、WebSocket 和上传资源转发给后端。
|
||
- 后端 `3701` 端口仍只监听本机，MongoDB 不对宿主机或局域网开放。
|
||
- 如果 macOS 防火墙首次询问是否允许传入连接，需要选择“允许”。
|
||
- 未填写 AI Key 时，相关能力按现有代码降级；历史浏览等不依赖 AI Key 的能力仍可测试。
|
||
- 本地启用了 stub 登录和 stub 支付，只可用于开发验证。
|
||
- ECS 部署前必须改为强随机 JWT 密钥、关闭 stub 登录，并配置真实域名、HTTPS、备份与对象存储。
|