# 📦 生财有迹 (Wealth Tracker) 部署说明

## ✅ 部署状态

| 项目 | 状态 |
|------|------|
| **容器名称** | wealth-tracker |
| **运行状态** | ✅ 正常运行 |
| **访问地址** | http://localhost:6888 |
| **数据卷** | ./data:/app/data |
| **重启策略** | unless-stopped |

---

## 🚀 快速启动

### 启动服务
```bash
cd /root/.hermes/workspace/wealth-tracker
docker compose up -d
```

### 停止服务
```bash
docker compose down
```

### 重启服务
```bash
docker compose restart
```

### 查看日志
```bash
docker compose logs -f wealth-tracker
```

---

## 🔧 配置说明

### 环境变量

| 变量名 | 值 | 说明 |
|--------|-----|------|
| `ALLOW_PASSWORD` | `true` | 启用密码保护功能 |
| `CAN_BE_RESET` | `true` | 允许重置数据库 |
| `PEPPER_SECRET` | `wealth_tracker_secret_key_2026` | 密码加密密钥 |

### 端口映射

| 主机端口 | 容器端口 | 说明 |
|---------|---------|------|
| 6888 | 8888 | Web 访问端口 |

### 数据持久化

| 主机路径 | 容器路径 | 说明 |
|---------|---------|------|
| `./data` | `/app/data` | SQLite 数据库存储 |

---

## 🔐 安全配置

### 首次访问

1. 打开浏览器访问：http://localhost:6888
2. 首次使用需设置管理员密码
3. 密码将加密存储在 SQLite 数据库中

### 修改密码

如需重置密码，可执行：
```bash
# 停止容器
docker compose down

# 删除数据库文件（谨慎操作，会清空所有数据）
rm -rf ./data/*

# 重新启动
docker compose up -d
```

---

## 📊 监控命令

### 查看容器状态
```bash
docker ps --filter name=wealth-tracker
```

### 查看资源使用
```bash
docker stats wealth-tracker
```

### 进入容器
```bash
docker exec -it wealth-tracker /bin/sh
```

### 查看数据库文件
```bash
ls -la ./data/
```

---

## 🌐 远程访问

若需在服务器上部署并允许远程访问：

### 方案一：直接暴露端口
```yaml
# docker-compose.override.yml
ports:
  - '0.0.0.0:8888:8888'  # 允许所有 IP 访问
```

### 方案二：Nginx 反向代理（推荐）

1. 修改 docker-compose 只监听本地：
```yaml
ports:
  - '127.0.0.1:8888:8888'
```

2. 配置 Nginx：
```nginx
server {
    listen 443 ssl;
    server_name wealth.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://127.0.0.1:8888;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

---

## 🔄 更新升级

```bash
# 拉取最新镜像
docker pull nicejade/wealth-tracker:latest

# 停止并删除旧容器
docker compose down

# 使用新镜像启动
docker compose up -d

# 验证版本
curl http://localhost:8888/api/version
```

---

## ⚠️ 注意事项

1. **数据备份**：定期备份 `./data` 目录
2. **密码安全**：请修改 `PEPPER_SECRET` 为随机字符串
3. **防火墙**：若远程访问，请确保防火墙开放 8888 端口
4. **HTTPS**：生产环境建议使用 Nginx 反向代理并配置 SSL

---

## 📞 技术支持

- **项目地址**: https://github.com/nicejade/wealth-tracker
- **在线演示**: https://fund.lovejade.cn/
- **文档**: https://fine.niceshare.site/projects/wealth-tracker/

---

**部署时间**: 2026-04-17  
**部署位置**: /root/.hermes/workspace/wealth-tracker  
**Docker 版本**: Docker Compose v5.1.1