Ubuntu 下关于 Transmission daemon 的安装与配置

王茂南

2828
文章

75
评论

2022年9月23日07:48:17

评论2 4736字阅读15分47秒

摘要本文会介绍 Ubuntu 下关于 Transmission daemon 的安装与配置，最终可以实现网页打开进行下载。同时包含使用 transmission-web-control 对界面进行美化。最后会包含一些常见的问题和解决办法。

文章目录(Table of Contents)

简介

Transmission 是一个强大的 BitTorrent 开源客户端，官方网站上提供了多个版本可以下载，包括：Mac、GTK+、QT、web 版本。

Transmission 支持 DHT、Magnet Link、uTP 以及 PEX 等特性。尤其是支持 Magnet Link 磁力链接下载十分重要，因为目前网上很多资源都是采用这种方式来分享的，而不是传统的 .torrent 文件

在 Ubuntu 的发行版中，Transmission 软件包下面包含多个套件，这些套件的名字很容易搞混淆，它们分别是：

transmission-gtk: GTK + 界面的 Transmission BT 客户端。
transmission-qt: QT 界面的 Transmission BT 客户端。
transmission-cli: 命令行界面的 Transmission BT 客户端，与 QT、GTK + 版本功能一样，是命令行下一个完备的 BT 客户端。
transmission-daemon: 是一个 Transmission 的后台守护程序，本身不具备操作指令，只能通过 Web 客户端或者 transmission-remote-cli 来进行控制。这个程序特别适合安装在服务器上或者嵌入式系统中，以及一些没有显示器的设备上。
transmission-remote-cli: 用来控制 transmission-daemon 的命令套件，本身不具备下载 BT 的功能，只能够配合 daemon 使用。

这些套件不必都安装上，根据我的需求（我之后只需要远程访问），所以我们只需要安装 transmission-daemon 即可。

本文的主体内容参考自，Ubuntu 下关于 Transmission daemon 的安装与配置。最后增加了一些我自己在安装过程中遇到的问题和相应的解决办法。

Transmission 的安装

打开终端，输入以下命令安装：

sudo apt-get update
sudo apt-get install transmission-daemon

安装过程中会顺带把 transmission-cli 也安装上，安装完毕后系统会多出如下一些命令行工具

transmission-cli：独立的命令行客户端。
transmission-create：用来建立.torrent 种子文件的命令行工具。
transmission-daemon：后台守护程序。
transmission-edit：用来修改.torrent 种子文件的 announce URL。
transmission-remote：控制 daemon 的程序。
transmission-show：查看.torrent 文件的信息。

安装好后，Transmission-daemon 有一些默认设置 (参考链接)。安装完毕之后，会有以下的默认配置清单：

启动初始化脚本 /etc/init.d/transmission-daemon
基本配置文件 /etc/default/transmission-daemon
详细配置文件目录 /var/lib/transmsision-daemon/info/settings.json。主要的配置文件，设置 daemon 的各项参数，包括 RPC 的用户名密码配置。它实际上是一个符号链接，指向的原始文件是 /etc/transmission-daemon/settings.json。里面的参数解释可以参考官网的配置说明。
下载存储目录 /var/lib/transmission-daemon/downloads

启动和停止 Transmission

# 启动
sudo service transmission-daemon start
# 停止
sudo service transmission-daemon stop

如果想要查看服务是否正常启动，可以使用下面的命令：

sudo service transmission-daemon status

Transmission 的配置

配置主要是通过修改 /var/lib/transmission-daemon/info/settings.json 文件中的参数来实现的。注意：在编辑 Transmission 的配置文件的时候，需要先关闭 daemon 进程，否则编辑的参数将会被恢复到原来的状态。关闭的方法见上面的「启动与关闭 Transmission」。

我们打开文件 /var/lib/transmission-daemon/info/settings.json，修改配置参数如下：

{
"download-dir": "/var/lib/transmission-daemon/Downloads", //默认下载位置
"rpc-authentication-required": true,
"rpc-bind-address": "0.0.0.0",
"rpc-enabled": true,
"rpc-host-whitelist": "", // rpc 主机白名单
"rpc-host-whitelist-enabled": true, //rpc 主机白名单是否开启，若需要任意主机都能访问，建议false
"rpc-password": "123456",
"rpc-port": 9091,
"rpc-url": "/transmission/",
"rpc-username": "transmission",
"rpc-whitelist": "*", // rpc 主机白名单
"rpc-whitelist-enabled": tr "rpc-username": "transmission", "rpc-whitelist": "*", // rpc ue //rpc 主机白名单是否开启，若需要任意主机都能访问，建议false
}

下面对其中几个比较重要的参数进一步解释：

"download-dir": "/var/lib/transmission-daemon/Downloads"，默认下载位置
"rpc-host-whitelist-enabled": false，任何主机可以访问
"rpc-whitelist-enabled": false，任何主机可以访问，设置为 true 需要在白名单的主机才可以访问，否则会出现 403 的报错。
"rpc-username": "username", 设置用户名。
"rpc-password": "password"，设置密码。需要注意的是 password 设置成了明文。当启动 daemon 之后，daemon 会自动检测密码设置。如果发现密码配置被修改了，daemon 会自动计算修改后的密码的 HASH 值，并用这个 HASH 值替换掉配置文件中的明文密码，这样会更安全。

settings.json 里面还有很多参数可以配置，包括上传 / 下载速度的限制、DHT 的配置、端口设置等等，详细的参数解释可以参考官网的配置说明。

设置到这里之后，重启 Transmission ，在浏览器中输入 http://x.x.x.x:9091/transmission/web/ 就可以显示下载界面了。