BitCake 🍰

中文 | English

专门针对 PT 玩家优化的下载器 WebUI - 优先支持 Transmission - 理论上兼容 qBittorrent

感谢 jackloves111 的加入和贡献

📖 项目简介

BitCake 是一个专为 PT（Private Tracker）用户设计的现代化 Transmission 和 qBittorrent Web 界面。它提供了简洁、高效且功能丰富的种子管理体验。

✨ 特性

• 🚀 基于 Vue 3 + TypeScript + Vite 构建
• 🎯 统一接口，同时支持 Transmission 和 qBittorrent
• 📱 响应式设计，完美支持移动端访问
• 🎨 使用 Element Plus 组件库，界面美观现代
• 📊 强大的数据统计与可视化功能
• 🔧 紧凑的布局设计，信息密度更高
• 🌍 多语言支持（中文 & 英文）
• 🎨 多主题选择（清新绿、简约蓝、可爱粉）
• 🏷️ 高级种子管理，支持标签和分类
• ⚡ 批量操作和限速策略
• 📈 实时速度监控和 Tracker 统计
• 🔄 辅种管理，支持跨站做种

🚀 部署

使用预构建容器

最简单的方式是使用预构建的 Docker 镜像：

services:
  transmission:
    image: ghcr.io/wenfer/bitcake:latest
    container_name: transmission
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - USER= #可选
      - PASS= #可选
      - WHITELIST= #可选
      - PEERPORT= #可选
      - HOST_WHITELIST= #可选
    volumes:
      - /path/to/transmission/data:/config
      - /path/to/downloads:/downloads #可选
      - /path/to/watch/folder:/watch #可选
    ports:
      - 9091:9091
      - 51413:51413
      - 51413:51413/udp
    restart: unless-stopped

注意：使用此镜像时，默认 UI 已经是 BitCake，无需额外配置 WebUI 路径。

部署到 Transmission

1. 从 releases 页面 下载 Transmission 客户端版本

2. 解压内容并复制到容器目录

3. 通过 TRANSMISSION_WEB_HOME 环境变量设置 WebUI 路径：

environment:
  - TRANSMISSION_WEB_HOME=/path/to/webui

部署到 qBittorrent

1. 从 releases 页面 下载 qBittorrent 客户端版本

2. 将目录内容复制到自定义 WebUI 目录

3. 在 qBittorrent 设置中启用"使用替代 WebUI"，并指定目录路径

如果修改后无法访问 qBittorrent，可以通过以下 API 调用恢复默认 UI：

{你的qb地址}/api/v2/app/setPreferences?json=%7B"alternative_webui_enabled":false%7D

🔧 配置说明

Tracker 站点映射

BitCake 在 public 目录下包含 trackerSites.json 文件，用于将 Tracker URL 映射到站点名称。这使得在统计和列表中更容易通过站点名称识别种子。

配置支持国际化，不同语言使用独立的映射文件：

• trackerSites-zh-CN.json - 中文站点名称
• trackerSites-en-US.json - 英文站点名称

欢迎贡献更多 Tracker 映射！

登录认证

• qBittorrent：必须提供用户名和密码（使用 qBittorrent 设置的凭据）
• Transmission：如果 Transmission 启用了认证，需要提供凭据；否则可留空

退出登录

点击右上角的退出按钮即可注销。

💻 开发

环境要求

• Node.js 18+
• npm 或 yarn

环境变量

在项目根目录创建 .env 文件：

# 后端类型：'transmission' 或 'qbittorrent'
VITE_TORRENT_BACKEND=transmission

# 自定义 API 基础路径（可选）
VITE_TORRENT_API_BASE=/transmission/rpc

# 开发代理 URL（可选）
VITE_PROXY_TRANSMISSION_URL=http://localhost:9091
VITE_PROXY_QB_URL=http://localhost:8080

构建命令

# 安装依赖
npm install

# 开发服务器
npm run dev

# 构建 Transmission 版本
npm run build:transmission

# 构建 qBittorrent 版本
npm run build:qbittorrent

# 构建生产版本（通用）
npm run build

🎨 预览

主界面 - 高级筛选功能

全面的统计数据和图表

批量限速管理

🙏 致谢

• Vue.js - 渐进式 JavaScript 框架
• Element Plus - Vue 3 组件库
• ECharts - 数据可视化图表库
• Transmission - 轻量级 BT 客户端
• qBittorrent - 开源 BT 客户端

🤝 贡献

欢迎贡献代码！请随时提交 Pull Request。

📄 License

MIT License

---

用 ❤️ 为 PT 爱好者打造