快速开始
本页带你从一个空部署目录启动 TradingCopilot，并完成最小可用验证。完成后，你应该能打开 Web 控制台、看到服务健康状态，并继续进行首次初始化。
前置条件
| 项目 | 要求 |
|---|---|
| Docker | 支持 Docker Compose v2 |
| 网络 | 能拉取镜像，并能访问你计划使用的 AI、Telegram、RSS/Atom 和行情服务 |
| 磁盘 | 至少预留 20 GB，生产环境按消息、日志和行情数据增长扩容 |
| 浏览器 | 推荐使用现代 Chromium、Firefox 或 Safari |
生产环境建议先准备域名、HTTPS 反向代理和备份目录。试用环境可以先使用 http://localhost:8000。
准备目录
建议为 TradingCopilot 使用独立目录，避免和其他项目混放：
bash
mkdir -p tradingcopilot
cd tradingcopilot放入项目提供的 docker-compose.yml 和示例配置后再启动。首次启动会生成运行时配置和数据目录。
你可以从原始项目仓库获取部署文件：
- 原始项目：TradingCopilotDevs/TradingCopilot
- 官方 Compose 文件：docker-compose.yml
启动流程
启动服务：
bash
docker compose up -d查看容器：
bash
docker compose ps持续查看应用日志：
bash
docker compose logs -f app访问系统
默认访问地址：
text
http://localhost:8000如果部署在服务器上，应通过你的反向代理域名访问，例如：
text
https://tc.example.com同时把 PUBLIC_BASE_URL 设置为这个外部地址。
最小验证
启动后按顺序验证：
docker compose ps中app、postgres、redis都处于运行状态。- 浏览器能打开 Web 控制台。
- 首次访问提示初始化管理员，或已存在管理员时显示登录页。
docker compose logs app中没有持续重复的数据库、Redis 或配置错误。env/app.env已生成，并包含APP_SECRET_KEY与JWT_SECRET_KEY。
停止和重启
停止服务但保留数据：
bash
docker compose down重启应用容器：
bash
docker compose restart app更新镜像并重新启动：
bash
docker compose pull
docker compose up -d升级前应先阅读 生产部署 和 安全与数据，确认数据库和 env/ 已备份。
常见启动问题
| 症状 | 优先检查 |
|---|---|
| 页面打不开 | 端口映射、反向代理、容器是否运行 |
app 反复重启 | 数据库连接、Redis 连接、环境变量格式 |
| 登录后接口报错 | PUBLIC_BASE_URL、CORS_ORIGINS、JWT secret |
| 外部服务不可用 | 服务器网络出口、代理、提供商凭据 |