BATorrent

有颜值的 BitTorrent 客户端 — 电影封面、六款主题、零广告。

BATorrent — 打开即用，封面自动加载

大多数 BT 客户端长得像报税表。这一个把你的下载呈现为 **一墙电影、剧集和游戏封面** — 就像你在 Netflix 或 Steam 上看到的那样 — 还能用六款主题（或你自己的壁纸）来装扮它。底层是久经考验的 **libtorrent** 引擎，所以它不是中看不中用的玩具：而是一个恰好还有点品味的真正客户端。 > **无广告。无遥测。无「Pro」版。无需账号。** 它唯一会自行发起的请求是 GitHub 更新检查，而且可以关闭。源代码就在这里 — 阅读 [`updater.cpp`](src/services/integrations/updater.cpp)，自己来验证。 ## 为什么会有这个项目我是巴西的一名独立开发者。我想要一个认真对待隐私、在每个桌面平台上原生运行、而且看起来不像 2009 年做的 BT 客户端 — 既然找不到，我就自己做了一个。它免费且采用 **MIT 许可**：没有附加条件，不会日后偷偷加入遥测，也不会被悄悄卖给一家加塞广告的公司。支持八种语言，因为「好用」不应该意味着「只有英文」。 ## 外观

在内置主题之间切换

Cover-art grid

List view

Sakura theme

- **自动封面** — 它读取种子名称，把真实海报（电影和剧集来自 TMDB，游戏来自 IGDB）拉取到网格视图。一键切换到紧凑列表。 - **六款主题** — Dark、Light、Midnight、Sakura、Dark Star，以及一个完全 **自定义** 的主题（你自己的背景 + 强调色），每款都可选动漫风格的点缀插画。 - 实时速度图、按状态着色的进度、带实时速度和剩余时间的托盘弹窗 — 这些细节让它*感觉*完整。 ## 它到底能做什么 | | | |---|---| | 🔒 **隐私优先** | 绑定到 VPN 网络接口 + **断网保护（kill switch）**（隧道断开即切断所有流量）、面向私有站（PT）的 PT 模式、Tor 预设、匿名握手、屏蔽迅雷/QQ 等吸血客户端 | | 🔎 **查找与添加** | 内置搜索（含开放的 CIS/RuTor 源，无需登录）、智能粘贴（Ctrl+V 识别 magnet / `.torrent` / `thunder://` / 哈希）、带正则过滤的 RSS 自动下载、拖放 | | 📱 **随处掌控** | 浏览器 WebUI + **二维码配对** — 用手机扫一扫，无需手输 IP。二维码在本地生成，你的地址绝不离开本机 | | 📺 **观看与整理** | 边下边播、自动解压压缩包、分类 + 标签、完成时刷新 Plex/Jellyfin/Emby 媒体库 | | 🔔 **保持知情** | 原生桌面通知、Telegram 提醒、Discord Rich Presence（「正在下载 X · 67%」） |

……以及长尾功能（点击展开）

单文件优先级 · 顺序下载 · 自动注入 Tracker · 内容布局控制 · 排除文件正则 · 临时下载目录 · 带做种时长窗口的「已完成」状态 · 文件出错时自动暂停 · 全局 + 单种子的分享率/时间限制 · 带宽计划（按小时 + 按星期）· 从 qBittorrent 导入 · 创建 `.torrent` 文件 · 种子检查器 · IP 屏蔽列表 · 协议加密 · Gitee 更新镜像 · 完成后自动关机 · Windows Defender 排除 · 完整备份/恢复 · 最近删除历史 · 强制开始 · 内置日志查看器 + 诊断 + IP 泄漏测试 · 按区域设置格式化 · 键盘快捷键。

## 引擎大多数 BT 客户端链接的是原版 libtorrent。BATorrent 附带一个经过**小幅打补丁的分支**，从而改变公共 API 触及不到的引擎行为： - **更快的管线爬升。** 在高带宽、高延迟的线路上，原版的请求管线每次只增长一步；本分支让它按几何级增长，用极少的往返就能填满粗管道。在项目自带的 A/B 基准中，快速线路上实测约 **+27%**，且没有原版那种批次间的卡顿，也从不倒退。 - **同国 peer 优先。** 一个离线 GeoIP 数据库（db-ip Lite）按国家标记每个 peer，本分支的 peer 排序在有选择时优先连接你所在国家的 peer——这通常意味着更低的延迟和更少被限速的跨境线路。两者都是分支的编译期特性（原版构建中关闭），并以带版本的补丁形式应用于 [`third_party/patches/`](third_party/patches)，而非内嵌副本。 ## 获取 | 平台 | | | |---|---|---| | **Windows** | [Microsoft Store](https://apps.microsoft.com/detail/9n4l3tq24rc6) · [安装版](https://github.com/BATorrent-app/BATorrent/releases/latest) · [便携版](https://github.com/BATorrent-app/BATorrent/releases/latest) | Windows 10+ | | **macOS** | **`brew install --cask Mateuscruz19/batorrent/batorrent`** · [`.dmg`](https://github.com/BATorrent-app/BATorrent/releases/latest) | macOS 12+ · Apple Silicon | | **Linux** | [AppImage](https://github.com/BATorrent-app/BATorrent/releases/latest) | glibc 2.35+ | 然后把 `.torrent` 文件或 magnet 链接拖到窗口里就行。就这么简单。 _{**macOS：** 尚未进行公证（Apple 的开发者计划需付费）。Homebrew 最省心 — `brew` 会移除隔离标记，应用直接打开，不会弹 Gatekeeper 提示。若用 `.dmg`，首次请右键 → **打开**。}

从源码构建与工程说明

### 依赖 C++17 · CMake 3.16+ · Qt 6（`Widgets`、`Network`、`Svg`、`Multimedia`）· libtorrent-rasterbar 2.0+ · Boost · Qt6Keychain（可选）。 ```bash # Debian / Ubuntu sudo apt install build-essential cmake qt6-base-dev qt6-svg-dev qt6-multimedia-dev \ libtorrent-rasterbar-dev libboost-dev libssl-dev cmake -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j && ./build/BATorrent ``` （macOS：`brew install qt libtorrent-rasterbar boost openssl`。Windows：Qt 安装器 + `vcpkg install libtorrent:x64-windows`。） ### 质量与安全

- **测试** — 每次 CI 构建都运行 Catch2 测试套件（单元、安全、内存）；新的后端行为都会配测试。 - **Sanitizers** — 在 AddressSanitizer + UndefinedBehaviorSanitizer 下干净通过（0 泄漏 / use-after-free / UB）。 - **审查** — 每次发布前都会检查内存/线程安全、WebUI 鉴权、注入、路径穿越、输入校验和密钥处理。密钥保存在系统钥匙串中，绝不明文存储；只有在你设置密码后，WebUI 才会对网络开放。