概述

Stacks 是一个专为 Anna's Archive 打造的容器化下载队列管理器。
它提供一个简洁的网页界面，可自动排队、管理与下载图书文件。
支持 Anna’s Archive 的高速下载 API，并能在高速下载不可用时自动切换镜像站，确保稳定下载。

主要功能

• 安全的 Web 控制台：密码保护 + 会话管理
• 下载队列管理：一键加入下载队列
• 高速下载支持：支持 Anna’s Archive 会员快速下载
• 自动镜像切换：快速下载失败时自动转用镜像站
• 实时仪表盘：查看下载状态、队列进度、历史记录
• 浏览器集成：Tampermonkey 脚本让你在 AA 页面一键添加到 Stacks
• Docker 部署方便：开箱即用
• 漂亮 UI：Dracula 主题 + 实时进度显示
• 断点续传
• 下载历史记录与重试机制

快速开始

Docker 安装

Stacks 提供官方 Docker 镜像，可通过 Docker Compose 或 Docker CLI 快速部署。

Docker Compose 部署方式

环境要求

• 已安装 Docker & Docker Compose
• （可选）Anna’s Archive 会员高速下载 KEY
• （可选）FlareSolverr（解决 Cloudflare/DDoS 保护）

1. 创建 docker-compose.yaml

将下面内容复制到 docker-compose.yaml：

networks:
  default:
    name: stacks

services:
  stacks:
    image: zelest/stacks:latest
    container_name: stacks
    stop_signal: SIGTERM
    stop_grace_period: 30s
    ports:
      - "7788:7788" # 左侧端口可自行修改
    volumes:
      - /path/to/config:/opt/stacks/config
      - /path/to/download:/opt/stacks/download
      - /path/to/logs:/opt/stacks/logs
    restart: unless-stopped
    environment:
      - USERNAME=admin
      - PASSWORD=stacks
      # - RESET_ADMIN=true # 取消注释可重置 admin 密码
      - SOLVERR_URL=flaresolverr:8191
      - TZ=UTC

  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    ports:
      - "8191:8191"
    environment:
      - LOG_LEVEL=info
    restart: unless-stopped

2. 修改配置路径

将 /path/to/... 替换成你本机的实际路径。

3. 修改默认密码（非常重要）

修改 PASSWORD=stacks 为一个强密码。

4. 启动服务

docker compose up

Docker CLI 部署方式

如果不使用 Compose，可使用纯 CLI：

1. 创建文件夹

mkdir -p /path/to/config /path/to/download /path/to/logs

2. 创建 Docker 网络

docker network create stacks

3. 运行 FlareSolverr

docker run -d \
  --name flaresolverr \
  --network stacks \
  -p 8191:8191 \
  -e LOG_LEVEL=info \
  --restart unless-stopped \
  ghcr.io/flaresolverr/flaresolverr:latest

4. 运行 Stacks

docker run -d \
  --name stacks \
  --network stacks \
  --stop-signal SIGTERM \
  -p 7788:7788 \
  -v /path/to/config:/opt/stacks/config \
  -v /path/to/download:/opt/stacks/download \
  -v /path/to/logs:/opt/stacks/logs \
  -e USERNAME=admin \
  -e PASSWORD=stacks \
  -e SOLVERR_URL=flaresolverr:8191 \
  -e TZ=UTC \
  --restart unless-stopped \
  zelest/stacks:latest

重要说明

• USERNAME 与 PASSWORD 仅在 首次运行 生效
• 端口 7788 可自行更换
• 请务必不要直接暴露到公网，至少要更改高强度密码
• 重置密码方式：

-e RESET_ADMIN=true

首次设置指南

1. 打开浏览器访问 http://localhost:7788
2. 使用默认账号登录
3. 进入 Settings（设置）
4. 修改你的管理员密码
5. 复制 API Key（用于 Tampermonkey 脚本）
6. （可选）配置 Anna’s Archive 高速下载 key
7. 调整延迟、重试等下载设置
8. 保存设置
9. 安装 Tampermonkey 脚本（参考 docs/tampermonkey.md）

安全性

Stacks 内置多层安全机制：

• Bcrypt 盐值密码加密
• 安全 Session：HTTPOnly + SameSite
• 登录尝试限制：5 次失败 → 锁定 10 分钟
• API Key 验证机制
• 自动生成的密钥与会话信息

安全最佳实践

1. 首次登录后立即修改密码
2. 使用强密码
3. API Key 不要外泄
4. 不要直接暴露到公网（建议使用 HTTPS 代理或 VPN）

进一步阅读

• API 文档（docs/api.md）
• 自行编译镜像（docs/development.md）
• 配置说明（docs/configuration.md）
• Tampermonkey 安装指南（docs/tampermonkey.md）
• 使用教程（docs/usage.md）