前言

如果你跟我一樣，大部分時間都泡在終端機裡——裝套件、寫程式、管理伺服器——那麼每次要下種子檔時，非得切到瀏覽器或打開一個臃腫的 GUI 客戶端，總覺得有點斷了「流」。

前陣子在 Reddit 上看到一個 Side Project 分享，作者 build 了一個叫 Torrra 的終端機種子工具，短短時間就拿到了 178 顆星。我點進去看了看，發現它不僅功能完整，而且設計理念非常貼合終端機使用者的習慣。這篇文章就來好好介紹一下這個工具。

- 廣告 -

什麼是 Torrra？

Torrra 是一個用 Python 寫的命令行工具，核心定位很明確：「不用離開 CLI 就能搜尋、下載、管理種子檔」。

它整合了三個關鍵組件：

  • Jackett / Prowlarr 作為索引器（Indexer），幫你從各大種子站搜尋資源
  • Libtorrent 作為底層下載引擎，負責實際的 P2P 傳輸
  • Textual 框架打造的 TUI（文字使用者介面），提供漂亮的終端機畫面

簡單來說，Torrra 把「搜尋種子 → 選擇檔案 → 開始下載 → 管理進度」這整個流程，全部收斂在一個終端機視窗裡完成。

核心功能

一鍵搜尋多站資源

一般用種子，最麻煩的就是要一個一個站去搜——YTS 有這部嗎？EZTV 有嗎？FitGirl 重製版在哪？Torrra 透過 Jackett 或 Prowlarr 串接所有已設定的索引器，一次搜尋、全部回報。你只需要輸入關鍵字，剩下的它幫你搞定。

直觀的 TUI 介面

Torrra 不是那種滿是參數的古老 CLI，它用 Textual 框架打造了一個響應式的文字使用者介面。搜尋結果以列表形式呈現，你可以用方向鍵或 vi 風格的 j / k 來瀏覽，按 Enter 直接下載選中的項目。

下載管理中，進度條、速度、做種比例一目了然，按 p 暫停、r 繼續，操作直覺。

支援兩種模式

  1. 全螢幕 TUI 模式：輸入 torrra 啟動，享受完整的終端機視覺體驗
  2. 純命令行模式：直接 torrra search <關鍵字> 搜尋，或 torrra download <磁力連結> 下載，適合寫在腳本裡自動執行

主題切換與快取

喜歡暗色主題還是亮色主題？Ctrl+T 切換。搜尋結果有快取機制，重複搜尋幾乎瞬間完成，但也可以用 --no-cache 強制取得最新結果。

安裝方式

Torrra 的安裝途徑相當多元，基本上不管你用什麼系統都能搞定：

# PyPI 標準安裝（推薦）
pip install torrra

# Arch Linux
yay -S torrra

# Homebrew（macOS / Linux）
brew install torrra

# Docker
docker pull stabldev/torrra

不過，Torrra 本身只負責搜尋和介面的部分，底層下載引擎依賴 Libtorrent，而搜尋則需要 Jackett 或 Prowlarr 作為中介。所以完整架設需要這兩樣東西。

設定流程

第一步：架好 Jackett 或 Prowlarr

Jackett 和 Prowlarr 都是種子索引器的聚合工具，它們會幫你管理一堆種子站的 API，然後提供統一的查詢介面。

如果你還沒有，最簡單的方式就是用 Docker 跑：

docker run -d \
  --name jackett \
  -p 9117:9117 \
  -v /path/to/config:/config \
  -v /path/to/logs:/logs \
  ghcr.io/jackett/jackett

Prowlarr 的設定方式類似，它是 Jackett 的後繼者，介面更現代。

第二步：初始化 Torrra

裝好 Torrra 之後，用 torrra jackett 或 torrra prowlarr 初始化，輸入你的索引器 URL 和 API Key 即可：

torrra jackett --url http://localhost:9117 --api-key YOUR_API_KEY

設定會自動儲存到 config.toml，之後每次啟動就不用再傳參數了。

第三步：開始搜尋

torrra search "Dune Part Two"

搜尋結果會以列表顯示，包含大小、種子數、下載人數等資訊。選中你想要的項目，按 Enter 就開始下載了。

與其他 CLI 種子工具比較

市面上其實有不少終端機種子工具，Torrra 的差異化在哪裡？

工具搜尋下載管理需要索引器特點
Torrra✅ 多站聚合✅ TUI 介面是（Jackett/Prowlarr）搜尋+下載一體化，介面漂亮
Transmission-cli❌✅ 命令行否輕量、穩定，但搜尋要自己抓 magnet link
rTorrent❌✅ ncurses 介面否功能強大、資源佔用低，但設定複雜
aria2❌✅ 純命令行否支援多種協定（HTTP/FTP/BitTorrent），適合腳本
WebTorrent-cli❌✅ 命令行否基於 WebRTC，支援即時串流

Torrra 的優勢在於把搜尋和下載整合在同一個工具裡。其他工具大多只管下載，搜尋要自己從瀏覽器拿到 magnet link 再貼進去。Torrra 則幫你省去了切換瀏覽器的步驟，整個流程在終端機內完成。

當然，代價是你需要額外跑一個 Jackett 或 Prowlarr 服務。如果你已經在跑 PIAF（Personal Indexing And Fetching）全家桶，那這個成本幾乎為零。

適合誰用？

  • 終端機重度使用者：日常就用 CLI，不想為了下種子切到瀏覽器
  • Server / VPS 管理員：伺服器上沒 GUI，需要一個好用的遠端種子管理工具
  • Prowlarr / Jackett 用戶：已經在用了索引器，想補上「搜尋→下載」的最後一塊拼圖
  • 自動化愛好者：CLI 模式可以直接寫進 cron job 或腳本，實現自動搜尋下載

小結

Torrra 是一個理念很清晰的小工具——它不做太多事，但把「搜尋、下載、管理」這三件事做得乾淨俐落。對於終端機控來說，這種「不用離開終端機」的體驗，往往就是決定用不用的關鍵。

專案目前還在快速發展中，MIT 授權、文件齊全（ReadTheDocs ）、Docker 支援完整，是個值得關注的 Side Project。

如果你也是終端機重度使用者，或者正在尋找一個輕量、美觀的 CLI 種子工具，Torrra 值得裝來試試。

- 廣告 -