potentialmidas/tradetally

TradeTally Docker部署指南

使用Docker和Docker Compose快速部署TradeTally。

快速开始

前提条件

• Docker Engine 20.10+
• Docker Compose 2.0+

1. 下载部署文件

创建新目录并下载所需文件：

bash
mkdir tradetally
cd tradetally

# 下载生产环境docker-compose文件
curl -O https://raw.githubusercontent.com/GeneBO98/tradetally/refs/heads/main/docker-compose.yaml

# 下载环境变量模板
curl -O https://raw.githubusercontent.com/GeneBO98/tradetally/main/.env.example

# 重命名为.env
mv .env.example .env

2. 配置环境

编辑.env文件设置您的配置：

bash
nano .env  # 或 vim .env

重要配置项：

• JWT_SECRET：更改为安全的随机字符串
• DB_PASSWORD：设置强数据库密码
• API密钥（可选，但建议配置以获得完整功能）

3. 部署

bash
# 启动应用
docker-compose -f docker-compose.yaml up -d

# 检查状态
docker-compose -f docker-compose.yaml ps

# 查看日志
docker-compose -f docker-compose.yaml logs -f app

4. 初始化数据库（仅首次）

数据库将自动创建。验证方法：

bash
# 检查数据库是否就绪
docker exec tradetally-db pg_isready -U trader -d tradetally

# 如需手动执行 schema（仅当表不存在时）：
# docker exec -i tradetally-db psql -U trader -d tradetally < schema.sql

5. 访问应用

• TradeTally：http://localhost:8080

默认登录

通过注册页面创建您的第一个用户账户。

管理命令

查看日志

bash
docker-compose -f docker-compose.yaml logs -f app
docker-compose -f docker-compose.yaml logs -f postgres

更新应用

bash
# 拉取最新镜像
docker-compose -f docker-compose.yaml pull app

# 重启应用（保留数据库）
docker-compose -f docker-compose.yaml up -d app

备份数据库

bash
docker exec tradetally-db pg_dump -U trader tradetally > tradetally_backup_$(date +%Y%m%d).sql

恢复数据库

bash
docker exec -i tradetally-db psql -U trader tradetally < tradetally_backup.sql

停止服务

bash
# 停止所有服务（保留数据）
docker-compose -f docker-compose.yaml down

# 停止并删除卷（警告：会删除所有数据）
docker-compose -f docker-compose.yaml down -v

目录结构

部署后，目录结构如下：

tradetally/
├── docker-compose.production.yaml
├── .env
├── logs/          （自动创建）
└── data/          （自动创建）

故障排除

应用无法启动

bash
# 检查日志
docker-compose -f docker-compose.yaml logs app

# 检查数据库连接
docker exec tradetally-app ping postgres

数据库连接问题

bash
# 检查数据库状态
docker-compose -f docker-compose.yaml ps postgres

# 检查数据库日志
docker-compose -f docker-compose.yaml logs postgres

性能问题

• 确保服务器至少有2GB内存
• 检查Docker卷的磁盘空间
• 使用 docker stats 监控

安全注意事项

1. 更改.env中的默认密码
2. 使用防火墙限制对5432和8080端口的访问
3. 配置SSL/TLS，生产环境建议使用nginx等反向代理
4. 定期备份数据库
5. 保持Docker镜像更新

支持

问题与支持：

• GitHub Issues：https://github.com/GeneBO98/tradetally/issues

API密钥（可选）

如需完整的CUSIP解析功能：

1. OpenFIGI API：[***]
2. finnhub.io API：[***]
3. Google *** API：https://console.cloud.google.com/

将这些添加到.env文件中，分别为OPENFIGI_API_KEY和GEMINI_API_KEY。