Transmission 使用指南：从下载到精通

步骤 1：安装

从下载中心选择适合的版本，桌面用户推荐 Qt 或 macOS 原生版本；服务器用户推荐 transmission-daemon + transmission-web。

步骤 2：首次启动

默认配置下 Transmission 会自动开始使用，建议在偏好设置中调整下载与上传目录。所有 GUI 客户端的偏好设置入口通常位于菜单 → 编辑 → 偏好设置（macOS）或 选项 → 偏好设置（Linux / Windows）。

步骤 3：添加第一个任务

点击工具栏的「打开」按钮（部分版本显示为 +），选择本地的 .torrent 文件，或者粘贴磁力链接开始下载。添加后可调整保存路径、是否立即开始、文件优先级等。

步骤 4：管理与做种

下载完成后，Transmission 会自动开始做种（分享上传）。如需关闭上传，可在偏好设置中将「当达到分享率后停止做种」调为较高的值，或手动停止任务。

使用 transmission-create

transmission-create \
  -o my-share.torrent \
  --tracker udp://tracker.example.com:1337 \
  --announce https://tracker.example.com/announce \
  --comment "My first share via Transmission" \
  --private \
  /path/to/share/folder

主要参数说明：

• -o：输出 .torrent 文件路径
• --tracker：Tracker 服务器地址，可多次指定
• --private：生成私有种子（私有站点常用，会禁用 DHT/PEX/LPD）
• --comment：附加注释
• --piecesize：分片大小（16K / 32K / 64K / ... / 16M）

配置 RPC

编辑守护进程配置：

{
  "rpc-enabled": true,
  "rpc-bind-address": "0.0.0.0",
  "rpc-port": 9091,
  "rpc-url": "/transmission/",
  "rpc-username": "your-user",
  "rpc-password": "your-strong-password",
  "rpc-host-whitelist": "",
  "rpc-host-whitelist-enabled": false,
  "rpc-whitelist": "127.0.0.1,192.168.1.*",
  "rpc-whitelist-enabled": true
}

重启服务后，浏览器访问 http://server-ip:9091/transmission/ 即可使用 Web UI。

Transmission 支持 eMule 格式的 IP 段黑名单文件（.p2p / .gz），可在 iblocklist.com 等来源下载。

配置文件：

{
  "blocklist-enabled": true,
  "blocklist-url": "https://list.iblocklist.com/?list=...",
  "blocklist-update-interval": 604800
}

重启守护进程后生效；GUI 客户端可在偏好设置中直接启用。

1. 升级到 4.1.3，修复了 CORS / CSRF nonce 泄露漏洞
2. 设置强 RPC 密码（建议 12 位以上，含大小写与符号）
3. 启用 rpc-whitelist，仅允许特定 IP 段访问
4. 若必须公网访问，建议通过 SSH 端口转发或 WireGuard / Tailscale 等 VPN 隧道
5. 在防火墙层限制 9091 端口的访问来源
6. 定期备份 settings.json 与 torrents/、resume/ 目录