baairon/torlink · 上手攻略

  • 仓库：baairon/torlink
  • 链接：https://github.com/baairon/torlink
  • 分类：engineering · tool
  • 作者：Jay
  • 更新：2026-07-07

这是什么

torlink 是一款运行在终端里的 torrent 搜索与下载工具，主打零配置、零设置。输入一次搜索词，同时查询多个精选可信来源，结果实时流入，按文件大小和做种人数标注，让你一眼看出哪个能快速下载。选中后直接下载到本地，任务在后台运行，完成后自动开始做种。

核心定位：解决找 torrent 过程中的痛苦——假按钮、弹窗广告、死链、零做种——用一个干净的全键盘终端界面一次性搞定。

解决什么问题

传统 torrent 搜索体验很差： - 搜索引擎结果满是假下载按钮、恶意弹窗 - 各个站点结果分散，要一个个手动查 - 无法判断文件是否还有做种、下载速度如何 - 跨站搜索浪费时间，很多结果早已死链

torlink 的价值：一次搜索、多源并发、实时排名，键盘操作，无需鼠标，无需配置。

快速安装

前置条件

  • Node.js（仅此一个依赖） bash node --version # 确认已安装即可

运行（零安装）

npx torlnk

⚠️ 注意命令名是 torlnk（六个字母），不是 torlink。

首次运行会直接打开 TUI 界面，无需任何配置。

核心用法

搜索

打开界面后，直接在搜索框输入关键词按回车。结果实时从所有来源流入，每条结果标注： - 大小（文件体积） - 做种人数（peer / seeder 数量）

用方向键选中，按 d 下载到默认目录，或按 D 选择自定义保存位置。

下载管理

  • 下载中的任务显示在顶部，包含进度、速度和剩余时间
  • 完成的任务自动移入 "Recently downloaded" 区域
  • 中断的任务下次启动自动续传
  • 所有下载默认保存到系统下载目录，按 o 更改默认目录

做种（Seeding）

  • 下载完成后默认自动开始做种，帮助社区
  • 按 p 可以暂停/停止任意做种任务，随时可恢复
  • 完全可控，不想做种随时停

浏览模式

空搜索直接回车，进入 curated library 浏览模式，可按分类（Games / Movies / TV / Anime）浏览精选内容。

按 ? 可随时调出完整快捷键列表。

内置来源

分类 来源
Games FitGirl（仅此一个，游戏可执行代码风险高，只选可信打包站）
Movies YTS、The Pirate Bay、1337x
TV EZTV、The Pirate Bay、1337x
Anime Nyaa、SubsPlease
  • 如果某个来源挂了，搜索会继续不中断，并提示哪个来源离线
  • Games 类别仅来自 FitGirl 是出于安全考虑（游戏文件可能含恶意代码）

本地开发

# 克隆仓库
git clone https://github.com/baairon/torlink.git
cd torlink

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 构建并运行
npm run build
npx torlnk

隐私与安全

  • 文件直接保存到你的磁盘，不经过任何中央服务器
  • torlink 只和 torrent 网络直连，不经过代理
  • 下载完成后自动做种，做种与否完全由你控制（随时可暂停/停止）
  • Games 只来自 FitGirl 一个可信源，避免下载到含恶意代码的打包文件

典型适用场景

  • 个人媒体库建设：快速搜索下载电影、剧集、动漫
  • 软件获取：通过 FitGirl 获取可信的游戏打包版本
  • 注重隐私的用户：不想用浏览器、插件、广告追踪
  • 键盘操作爱好者：全程无需鼠标，全键盘完成

坑与注意

  1. 命令是 torlnk 不是 torlink——六个字母，注意拼写。
  2. 下载速度取决于做种人数：peer 数量显示在每条结果旁，优先选做种多的。
  3. 空搜索回车可以直接浏览 curated library，无需每次都输入关键词。
  4. 做种默认开启：如果带宽敏感或不想分享，完成后记得去 Seeding 面板按 p 暂停。
  5. ** Games 只来自 FitGirl**：如果想下载其他来源的游戏，torlink 目前不支持，这是有意限制。
  6. Node.js 版本需保持较新（建议 Node 18+），低版本可能遇到兼容问题。
  7. 终端需要支持 Unicode 字符显示，部分纯 ASCII 终端可能渲染不完整。

与同类对比

工具 类型 配置难度 来源数 键盘操作 做种管理
torlink 终端 TUI ⭐ 零配置 多个精选 ✅ 全键盘 ✅ 内置
BT Panel / 迅雷 GUI 客户端 中 单一 ❌ 鼠标 ⚠️ 基础
jackett + Radarr 自动化生态 高（需搭服务） 可配置 ❌ ✅
浏览器搜索引擎 网页 无 不可控 ❌ ❌

核心差异：torlink 是零配置终端工具，和 torrent 网络直连，没有中间服务器，速度最快、隐私最好。

一句话推荐结论

如果你需要快速、干净、不折腾地搜索和下载 torrent，torlink 是目前最优雅的终端方案——零配置、键盘操作、即时流式结果、自动做种，一气呵成。

相关资源

  • GitHub：https://github.com/baairon/torlink
  • npm：https://www.npmjs.com/package/torlnk（包名即命令名）