通过docker-compose安装

version: '3.8'

services:
  personal-ledger:
    # GitHub Container Registry 镜像
    image: ghcr.io/sky121666/sky-personalledger:latest
    # 或本地构建: build: .
    
    container_name: personal-ledger
    restart: unless-stopped
    
    ports:
      - "8080:8080"
    
    volumes:
      # 持久化数据目录 (数据库 + 上传文件 + 备份)
      - ./data:/data
    
    environment:
      # ========== 必须修改 ==========
      # JWT 密钥 (至少32位随机字符串)
      - LEDGER_JWT_SECRET=please-change-this-to-a-random-secret-key
      
      # ========== 安全配置 (可选) ==========
      # 自定义入口路径 (设置后只能通过 /your-path 访问)
      # - LEDGER_SECURITY_BASE_PATH=/my-secret-path
      
      # API Token (移动端访问验证，留空不验证)
      # - LEDGER_SECURITY_API_TOKEN=sk-your-api-token
      
      # ========== JWT 配置 ==========
      - LEDGER_JWT_ACCESS_EXPIRE=15       # Access Token 过期(分钟)
      - LEDGER_JWT_REFRESH_EXPIRE=43200   # Refresh Token 过期(分钟，默认30天)
      
      # ========== 存储配置 ==========
      - LEDGER_STORAGE_MAX_FILE_SIZE=10   # 最大上传文件(MB)
      # - LEDGER_STORAGE_ALLOWED_TYPES=jpg,jpeg,png,gif,webp,pdf
      
      # ========== 日志配置 ==========
      - LEDGER_LOG_LEVEL=info             # debug/info/warn/error
      # - LEDGER_LOG_FORMAT=json          # json/text
      
      # ========== 限流配置 ==========
      - LEDGER_SERVER_MODE=debug #完全禁用限流
      # - LEDGER_RATE_LIMIT_MAX_REQUESTS=2000  # 每分钟最大请求数
      # - LEDGER_RATE_LIMIT_WINDOW_SECS=60     # 限流时间窗口(秒)
      
      # ========== 时区 ==========
      - TZ=Asia/Shanghai

# 数据目录结构:
# ./data/
#   ├── ledger.db        # SQLite 数据库
#   ├── uploads/         # 上传的文件
#   └── backups/         # 备份文件