arch-wiki-md-repo
Version:
All arch-wiki articles in markdown format, updated every two days.
289 lines (184 loc) • 15.7 kB
Markdown
**翻译状态：** 本文是英文页面 [Transmission](/index.php/Transmission "Transmission") 的[翻译](/index.php/ArchWiki_Translation_Team_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "ArchWiki Translation Team (简体中文)")，最后翻译时间：2018-04-09，点击[这里](https://wiki.archlinux.org/index.php?title=Transmission&diff=0&oldid=507716)可以查看翻译后英文页面的改动。
[Transmission](http://www.transmissionbt.com/) 是一个轻量级、跨平台的 BitTorrent 客户端。
## Contents
* [1 安装](#.E5.AE.89.E8.A3.85)
* [2 图形界面的配置](#.E5.9B.BE.E5.BD.A2.E7.95.8C.E9.9D.A2.E7.9A.84.E9.85.8D.E7.BD.AE)
* [3 Transmission 守护程序和命令行](#Transmission_.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E5.92.8C.E5.91.BD.E4.BB.A4.E8.A1.8C)
* [3.1 守护程序的启动与停止](#.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E7.9A.84.E5.90.AF.E5.8A.A8.E4.B8.8E.E5.81.9C.E6.AD.A2)
* [3.2 减少多余的日志](#.E5.87.8F.E5.B0.91.E5.A4.9A.E4.BD.99.E7.9A.84.E6.97.A5.E5.BF.97)
* [3.3 仅当连接到网络时运行](#.E4.BB.85.E5.BD.93.E8.BF.9E.E6.8E.A5.E5.88.B0.E7.BD.91.E7.BB.9C.E6.97.B6.E8.BF.90.E8.A1.8C)
* [3.3.1 Netctl](#Netctl)
* [3.3.2 Wicd](#Wicd)
* [3.4 选择一个用户](#.E9.80.89.E6.8B.A9.E4.B8.80.E4.B8.AA.E7.94.A8.E6.88.B7)
* [3.5 配置守护程序](#.E9.85.8D.E7.BD.AE.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F)
* [3.5.1 Host 白名单](#Host_.E7.99.BD.E5.90.8D.E5.8D.95)
* [3.5.2 监视目录](#.E7.9B.91.E8.A7.86.E7.9B.AE.E5.BD.95)
* [3.5.3 启用 IPv6](#.E5.90.AF.E7.94.A8_IPv6)
* [3.5.4 CLI 使用示范](#CLI_.E4.BD.BF.E7.94.A8.E7.A4.BA.E8.8C.83)
* [4 Web 界面](#Web_.E7.95.8C.E9.9D.A2)
* [4.1 GUI 方式](#GUI_.E6.96.B9.E5.BC.8F)
* [4.2 CLI 方式](#CLI_.E6.96.B9.E5.BC.8F)
* [5 故障排除](#.E6.95.85.E9.9A.9C.E6.8E.92.E9.99.A4)
* [5.1 无法使用网络连接至守护程序](#.E6.97.A0.E6.B3.95.E4.BD.BF.E7.94.A8.E7.BD.91.E7.BB.9C.E8.BF.9E.E6.8E.A5.E8.87.B3.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F)
* [5.2 无法显示 Web 界面](#.E6.97.A0.E6.B3.95.E6.98.BE.E7.A4.BA_Web_.E7.95.8C.E9.9D.A2)
* [6 更多信息](#.E6.9B.B4.E5.A4.9A.E4.BF.A1.E6.81.AF)
## 安装
有多种可选的软件包：
* [transmission-cli](https://www.archlinux.org/packages/?name=transmission-cli) - 包括命令行工具、守护程序和 [#Web 界面](#Web_.E7.95.8C.E9.9D.A2)。
* [transmission-gtk](https://www.archlinux.org/packages/?name=transmission-gtk) - GTK+ 3 图形界面.
* [transmission-qt](https://www.archlinux.org/packages/?name=transmission-qt) - Qt5 图形界面.
* [tremc-git](https://aur.archlinux.org/packages/tremc-git/) - 用于守护程序的 Curses 界面。
**注意:** GTK+ 客户端无法连接至守护程序，想用守护程序的用户可以考虑带图形界面的 Qt 包，或是带 Curses 界面的 tremc 包。
## 图形界面的配置
两种带 GUI 的版本 *transmission-gtk* 和 *transmission-qt* 都可以在没有后端守护程序的情况下独立运行。
GUI 版本都被配置为开箱即用，但用户可能仍需要更改一些设置。GUI 配置文件的默认路径是 `~/.config/transmission`。
在 Transmission 的网站上，有一份各种选项如何配置的教程： [https://github.com/transmission/transmission/wiki/Editing-Configuration-Files](https://github.com/transmission/transmission/wiki/Editing-Configuration-Files).
## Transmission 守护程序和命令行
*transmission-cli* 支持的命令包括：
*transmission-daemon*: 启动守护程序。
*transmission-remote*: 调用本地或远程守护程序的 [命令行界面](https://en.wikipedia.org/wiki/Command-line_interface "wikipedia:Command-line interface")，后面跟着希望守护程序运行的命令。
*transmission-show*: 返回指定种子文件的信息。
*transmission-create*: 创建一个新的种子文件。
*transmission-edit*: 新增、删除或替换一个 tracker 服务器的 announce URL。
*transmission-cli*: ([已弃用](https://github.com/transmission/transmission/commit/950387ab5a443629598f93c057f41150707866ab)) 启动一个非守护程序的本地 *transmission* 实例，用于手动下载一个种子。
*tremc*: (需要 [tremc-git](https://aur.archlinux.org/packages/tremc-git/)) 为本地或远程守护程序启动一个 [curses](https://en.wikipedia.org/wiki/curses_(programming_library) 界面。
### 守护程序的启动与停止
就像 [#选择一个用户](#.E9.80.89.E6.8B.A9.E4.B8.80.E4.B8.AA.E7.94.A8.E6.88.B7) 里面的说明那样，transmission 的守护程序可以按以下方式运行：
* 作为 *transmission* 用户运行，只要 [用 systemd](/index.php/Systemd_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E4.BD.BF.E7.94.A8.E5.8D.95.E5.85.83 "Systemd (简体中文)") start/enable `transmission.service` 服务即可。
你可以按照 [#选择一个用户](#.E9.80.89.E6.8B.A9.E4.B8.80.E4.B8.AA.E7.94.A8.E6.88.B7) 里的说明更改默认用户。
* 用你自己的账户，只要在账户下运行： `$ transmission-daemon` 守护程序可以这样来停止： `$ killall transmission-daemon`
启动守护程序将会创建一个初始的 *transmission* 配置文件。详情参阅 [#配置守护程序](#.E9.85.8D.E7.BD.AE.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F)。
另一种停止 transmission 的方法是使用 *transmission-remote* 命令：
```
$ transmission-remote --exit
```
### 减少多余的日志
运行 transmission-daemon 可能会产生许多不需要的日志条目。只要用一个小脚本包装一下再启动就可以过滤日志输出。以下示例可以提供一些启发：
`transwrap.sh`
```
#!/bin/zsh
killall transmission-daemon 2> /dev/null
transmission-daemon --foreground --log-info 2>&1 | while read line; do
echo $line |
grep -v "announcer.c:\|platform.c:\|announce done (tr-dht.c:" |
grep -v "Saved.*variant.c:" |
while read line; do
echo $line | grep -q "Queued for verification (verify.c:" &&
notify-send --app-name="Transmission Started" "${line#* * }"
echo $line | grep -q "changed from .Incomplete. to .Complete." &&
notify-send --app-name="Transmission Complete" "${line#* * }"
echo $line | systemd-cat --identifier="TransWrap" --priority=5
done 2>&1 > /dev/null
done&disown
```
### 仅当连接到网络时运行
#### Netctl
你可能只想在连接某些网络时运行 transmission。下面的脚本会先检查连接是否在授权的网络列表中，是的话再继续启动 transmission-daemon。
`/etc/netctl/hooks/90-transmission.sh`
```
#!/bin/bash
# The SSIDs for which we enable this.
declare -A ssids=(
["network_1"]=y
["network_2"]=y
)
if [[ ${ssids[$SSID]} ]]; then
case $ACTION in
CONNECT|REESTABLISHED)
# Need to wait, otherwise doesn't seem to bind to 9091.
sleep 30
systemctl start transmission
;;
*)
systemctl stop transmission
;;
esac
fi
```
#### Wicd
在文件夹 `/etc/wicd/scripts/postconnect` 里创建一个 [启动脚本](#.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E7.9A.84.E5.90.AF.E5.8A.A8.E4.B8.8E.E5.81.9C.E6.AD.A2)，并且在文件夹 `/etc/wicd/scripts/predisconnect` 里创建一个 [停止脚本](#.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E7.9A.84.E5.90.AF.E5.8A.A8.E4.B8.8E.E5.81.9C.E6.AD.A2)。记得给它们运行权限，例如：
`/etc/wicd/scripts/postconnect/transmission`
```
#!/bin/bash
systemctl start transmission
```
`/etc/wicd/scripts/predisconnect/transmission`
```
#!/bin/bash
systemctl stop transmission
```
### 选择一个用户
选择你想如何运行 `transmission`：
* 作为独立用户运行，默认用户是 `transmission`（推荐，因为安全性更高）。
默认情况下，*transmission* 会创建名为 `transmission` 的用户和组（它的主目录的文件位于 `/var/lib/transmission/`），并且用这个“账户”运行。这是一种安全措施，因为这样 *transmission* 及其下载的文件将无法访问 `/var/lib/transmission/` 目录之外的文件。配置、操作和访问下载的文件需要使用 “root” 权限完成（比如用 [sudo](/index.php/Sudo "Sudo")）。
* 在你自己的账户下运行。
设置这种方式需要 [重写](/index.php/Systemd_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E4.BF.AE.E6.94.B9.E7.8E.B0.E5.AD.98.E5.8D.95.E5.85.83.E6.96.87.E4.BB.B6 "Systemd (简体中文)") 已提供的服务文件并在其中指定你的用户名：
`/etc/systemd/system/transmission.service.d/username.conf`
```
[Service]
User=*your_username*
```
### 配置守护程序
[启动守护程序](#.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E7.9A.84.E5.90.AF.E5.8A.A8.E4.B8.8E.E5.81.9C.E6.AD.A2) 来创建缺省的配置文件。
* 如果用 `transmission` 这个用户来运行 Transmission，配置文件会存放在 `/var/lib/transmission/.config/transmission-daemon/settings.json`。
* 如果用你自己的账户运行 Transmission，配置文件会存放在 `~/.config/transmission-daemon/settings.json`。
使用一个 Transmission 客户端或者用自带的 web 界面（在支持的浏览器中用 [http://localhost:9091](http://localhost:9091) 来访问）可以自定义守护程序。
在 Transmission 的网站上，有一份各种选项如何配置的教程：[https://github.com/transmission/transmission/wiki/Editing-Configuration-Files](https://github.com/transmission/transmission/wiki/Editing-Configuration-Files)
**注意:** 如果你想用一个文本编辑器手动编辑配置文件，请先 [停止守护程序](#.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E7.9A.84.E5.90.AF.E5.8A.A8.E4.B8.8E.E5.81.9C.E6.AD.A2)；否则当它停止时将会覆盖配置文件。
**注意:** 另一种方式是，可以用 SIGHUP 信号指示守护程序重新加载其配置，运行 `kill -s SIGHUP `pidof transmission-daemon`` 即可。
一个给那些用 `transmission` 账户运行的用户的建议是，用适当的权限创建一个共享的下载目录，这样就能同时允许 `transmission` 账户和其他账户访问下载文件，也能相应地更新配置文件。例如：
```
# mkdir /mnt/data/torrents
# chown -R facade:transmission /mnt/data/torrents
# chmod -R 775 /mnt/data/torrents
```
现在 `/mnt/data/torrents` 目录可供系统账户 `facade` 和 `transmission` 用户所属的 `transmission` 组访问。非常不鼓励使这个目录可读写（即不要将目录 *chmod* 到 *777*），而是应该将个别用户/组的部分权限授予部分目录。
**注意:** 如果 `/mnt/data/torrents` 位于一个可移除的设备上，比如这是一个 `/etc/fstab` 条目且带有 `nofail` 选项，那么 Transmission 会报告说没有找到文件。要解决这个问题，可以在 `/etc/systemd/system/transmission.service.d/transmission.conf` 文件的 `[Unit]` 一节中加入 `RequiresMountsFor=/mnt/data/torrents`。
另一种方法是把你的账户加入 `transmission` 用户组 (`#usermod -a -G transmission yourusername`)，然后修改 `/var/lib/transmission` 和 `/var/lib/transmission/Downloads` 目录的权限设置，以允许 `transmission` 组成员对这两个目录的 `rwx` 访问权。
#### Host 白名单
如果你想用远程主机的主机名来访问位于该主机上的 Transmission 守护程序，你需要把主机名加入 `settings.json` 文件中的 `rpc-host-whitelist` 字段中。 否则你会在连接主机时收到一条 "421 Misdirected Request" 错误。
如果你用该服务器的 IP 地址来访问守护程序，这一步可以省略。
#### 监视目录
如果你想 *自动添加某个文件夹中的 .torrent 文件*，但是配置文件中的 `watch-dir` 和 `watch-dir-enabled` 选项都不起作用，可以带 `-c /path/to/watch/dir` 参数启动 transmission 守护程序。
如果你在用 systemd，按照 [systemd (简体中文)#修改现存单元文件](/index.php/Systemd_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E4.BF.AE.E6.94.B9.E7.8E.B0.E5.AD.98.E5.8D.95.E5.85.83.E6.96.87.E4.BB.B6 "Systemd (简体中文)") 里面的描述编辑 `transmission.service` 单元文件。
#### 启用 IPv6
默认情况下，守护程序仅监听 IPv4 连接。要同时监听 IPv6 连接，安装 [transmission-cli-ipv6](https://aur.archlinux.org/packages/transmission-cli-ipv6/) (或者 [transmission-cli-git](https://aur.archlinux.org/packages/transmission-cli-git/)，或者等 Transmission 3.0 发布)，然后把 `settings.json` 里的 `rpc-bind-address` 选项改为 `"::"`。
#### CLI 使用示范
如果你想删除所有已完成的种子，可以用下面的命令（用你自己的用户名和密码）：
```
# transmission-remote -n 'username:password' -l | grep 100% | awk '{print $1}'| paste -d, -s | xargs -i transmission-remote -t {} -r
```
## Web 界面
### GUI 方式
当 Transmission 安装完毕后就可以轻易架起 web 界面。你只需要单击 **edit** 菜单，选择 **preferences**。单击 **Remote** 选项卡并启用 **Allow remote access**。
此处你可以修改默认的监听端口 9091。
单击 **Use authentication** 并填写用户名和密码就可以启用身份认证。
要提高安全性，可以启用 **Only allow these IP addresses** 限制来自任意 IP 的访问。
现在你可以单击 **Open web client** （用你的默认浏览器打开）或手动访问 `http://*TARGET_IP_ADDRESS*:*PORT*` 来启动 web 界面。
如果没有修改监听端口，默认是 9091。在这种情况下访问链接是 `[http://localhost:9091](http://localhost:9091)`。
**注意:** 记住，必须安装 [transmission-cli](https://www.archlinux.org/packages/?name=transmission-cli)。
### CLI 方式
设置 web 界面甚至不需要借助图形界面，因为守护程序提供了类似的选项。你无需指定任何参数即可访问 web 界面，可参阅 [#守护程序的启动与停止](#.E5.AE.88.E6.8A.A4.E7.A8.8B.E5.BA.8F.E7.9A.84.E5.90.AF.E5.8A.A8.E4.B8.8E.E5.81.9C.E6.AD.A2)。
不过，你仍然可以指定在前一节中看到的所有选项：
`$ transmission-daemon --auth --username arch --password linux --port 9091 --allowed "127.0.0.1"`
等同于
`$ transmission-daemon -t -u arch -v linux -p 9091 -a "127.0.0.1"`
## 故障排除
#### 无法使用网络连接至守护程序
在 `network.service` 初始化后守护程序就会开始运行。但是，如果启用了 `dhcpcd` 服务而不是特定设备的服务（比如 `dhcpcd@enp1s0.service`），可能 Transmission 会因为启动过早而无法绑定到相应的网络接口。于是 web 界面无法访问。一种可能的解决方案是在 systemd 单元的 [配置文件](/index.php/Systemd_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E4.BF.AE.E6.94.B9.E7.8E.B0.E5.AD.98.E5.8D.95.E5.85.83.E6.96.87.E4.BB.B6 "Systemd (简体中文)") 里增加 `Requires` 行。
`/etc/systemd/system/transmission.service.d/fixdep.conf`
```
[Unit]
Requires=network.target
```
#### 无法显示 Web 界面
```
404: Not Found
Couldn't find Transmission's web interface files!
Users: to tell Transmission where to look, set the TRANSMISSION_WEB_HOME environment variable to the folder where the web interface's index.html is located.
Package Builders: to set a custom default at compile time, #define PACKAGE_DATA_DIR in libtransmission/platform.c or tweak tr_getClutchDir () by hand.
```
即使你用图形界面，也需要安装 [transmission-cli](https://www.archlinux.org/packages/?name=transmission-cli) 来支持 web 界面。
## 更多信息
* [Transmission 维基](https://trac.transmissionbt.com/wiki)
* [HeadlessUsage](https://trac.transmissionbt.com/wiki/HeadlessUsage/General)