digital-me-history/DOCKER-LOCAL.md

历史数字我：本地 Docker Compose

启动

1. 启动 Docker Desktop，或执行 colima start。
2. 在本目录执行：

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：

ipconfig getifaddr en0

后端健康检查：http://localhost:8080/health

常用命令

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、备份与对象存储。