Transmission 2.94 配置文件参数中文解释

发表于 | 更新于 | 分类于

最近得到消息有个新开的 pt 站正在开放注册，于是赶紧去注册了个账号正式入坑 pt。

而玩 pt，无论是做种还是挂种都离不开 Bittorrent 客户端的支持。我是在自己的空闲服务器上挂的，选用了大名鼎鼎的 Transmission 作为客户端。

Transmission 目前最新的版本为 2.94 ，下面介绍一下它的配置文件中各个参数的作用吧。

配置文件参数

下面的参数项是直接从 Transmission 2.94 版本的默认配置文件里复制过来的，各个参数作用的解释基本是我根据官方说明翻译归纳的，应该没有啥大问题（注意 JSON 文件不能有注释，我这里使用 // 的注释形式只是为了方便对照查看 ，请勿将其粘贴到实际使用的配置文件中）。

先附上官方说明地址：https://github.com/transmission/transmission/wiki/Editing-Configuration-Files

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
{
    "alt-speed-down": 50,   //开启时段限速时下载速度的最大值，单位KB/s
    "alt-speed-enabled": false,   //是否开启时段限速，默认关闭
    "alt-speed-time-begin": 540,   //时段限速开启时间，默认值540（这个值与具体时间的转换自己去官方说明里查看，此处不过多介绍，下同）
    "alt-speed-time-day": 127,   //时段限速在哪些日子启用，默认值127（每天）
    "alt-speed-time-enabled": false,   //是否启用时段限速日期，默认不开启，如果开启，那么alt-speed-enabled一定要是false，两者之间只能启用一项，如果同时设置为true，则alt-speed-enabled有效
    "alt-speed-time-end": 1020,   //时段限速结束时间，默认值1020
    "alt-speed-up": 50,   //开启时段限速时上传速度的最大值，单位KB/s
    "bind-address-ipv4": "0.0.0.0",   //程序监听的ipv4地址绑定
    "bind-address-ipv6": "::",   //程序监听的ipv6地址绑定
    "blocklist-enabled": false,   //是否启用黑名单，默认不启用
    "blocklist-url": "http://www.example.com/blocklist",   //黑名单列表的url
    "cache-size-mb": 4,   //缓存大小，单位MB
    "dht-enabled": true,   //是否启用DHT网络（通过tracker寻找节点），默认启用
    "download-dir": "/var/lib/transmission-daemon/downloads",   //下载完成的文件保存路径
    "download-limit": 100,   //下载限速，单位KB/s
    "download-limit-enabled": 0,   //是否开启下载限速，0表示不开启
    "download-queue-enabled": true,   //是否开启下载队列，默认开启
    "download-queue-size": 5,   //下载队列数设置，默认5，表示最多只能同时下载5个任务，多余的需要等待
    "encryption": 1,   //加密设置，等于0时不加密，1是优先加密，2是必须加密
    "idle-seeding-limit": 30,   //空闲多长时间停止做种，默认30，单位分钟
    "idle-seeding-limit-enabled": false,   //是否开启空闲时间停止做种，默认关闭
    "incomplete-dir": "/var/lib/transmission-daemon/Downloads",   //未完成任务的文件保存路径
    "incomplete-dir-enabled": false,   //是否启用未下载完成文件保存路径
    "lpd-enabled": false,   //LDP网络（在本地网络寻找节点），默认关闭
    "max-peers-global": 200,
    "message-level": 1,   //日志消息等级，0=None，1=Error,2=Info,3=Debug
    "peer-congestion-algorithm": "",
    "peer-id-ttl-hours": 6,
    "peer-limit-global": 200,   //全局种子最大连接数
    "peer-limit-per-torrent": 50,   //每个种子的最大连接数
    "peer-port": 51413,   //上传下载使用的连接端口号
    "peer-port-random-high": 65535,   //随机端口号上限
    "peer-port-random-low": 49152,   //随机端口号下限
    "peer-port-random-on-start": false,   //是否启用随机端口号，默认关闭，启用后每次重启该软件都会从上面设定的范围里随机选取一个端口使用
    "peer-socket-tos": "default",   //设置传输TCP数据包的服务类型，详情参考：https://en.wikipedia.org/wiki/Type_of_service
    "pex-enabled": true,   //是否开启节点交换，详情参考：https://en.wikipedia.org/wiki/Peer_exchange
    "port-forwarding-enabled": false,   //是否启用端口转发（uPnP），如果路由支持并且也开启了uPnP，则路由会自动做端口映射
    "preallocation": 1,   //预分配磁盘空间，0=关闭，1=快速，2=完全，默认取1，防止文件下载了一半后才发现磁盘空间不够
    "prefetch-enabled": true,
    "queue-stalled-enabled": true,
    "queue-stalled-minutes": 30,
    "ratio-limit": 2,   //分享率（上传下载比率）达到多少后停止做种
    "ratio-limit-enabled": false,   //是否启用分享率达标停止做种，默认关闭
    "rename-partial-files": true,   //在未完成的文件名后添加后缀，默认开启，开启后未完成的文件会带有.part后缀
    "rpc-authentication-required": true,   //是否开启远程控制验证
    "rpc-bind-address": "0.0.0.0",   //rpc服务监听地址
    "rpc-enabled": true,   //是否开启rpc服务（远程连接）
    "rpc-host-whitelist": "",   //rpc域名白名单，值为以逗号分隔的域名列表，用于绑定域名访问的场景
    "rpc-host-whitelist-enabled": true,   //是否开启rpc域名白名单
    "rpc-password": "{cc29d57debb27f83469bbcd7fae81f64c789d3dfgw.f80LY",   //rpc连接密码，这是加密过的，将其修改为自己的密码（明文）后启动软件会自动加密
    "rpc-port": 9091,   //rpc服务监听端口
    "rpc-url": "/transmission/",   //rpc服务路径
    "rpc-username": "transmission",   //rpc连接用户名，跟上面的密码配合使用
    "rpc-whitelist": "127.0.0.1",   //rpc连接白名单，默认只允许本地连接
    "rpc-whitelist-enabled": true,   //是否开启rpc连接白名单，默认开启
    "scrape-paused-torrents-enabled": true,   //是否运行暂停种子
    "script-torrent-done-enabled": false,   //是否在torrent完成时运行脚本，默认关闭
    "script-torrent-done-filename": "",   //在torrent完成时运行的脚本路径
    "seed-queue-enabled": false,   //是否开启做种队列
    "seed-queue-size": 10,   //做种队列大小
    "speed-limit-down": 100,   //下载速度限制，单位KB/s
    "speed-limit-down-enabled": false,   //是否开启下载速度限制，默认关闭
    "speed-limit-up": 100,   //上传速度限制，单位KB/s
    "speed-limit-up-enabled": false,   //是否开其上传速度限制，默认关闭
    "start-added-torrents": true,   //在添加种子文件后立即开始任务
    "trash-original-torrent-files": false,
    "umask": 18,   //文件权限掩码，默认18即755权限，如果改成0是最高权限，下载回来的文件权限就是777
    "upload-limit": 100, 
    "upload-limit-enabled": 0,
    "upload-slots-per-torrent": 14,
    "utp-enabled": true   //UTP传输是否启用
}

注意事项

修改配置文件时还需要注意以下几点：

  • 在 Linux 系统下，修改 download-dir 和 incomplete-dir 选项时需要注意目录权限问题，使用 apt 安装 Transmission 时会自动创建一个名为 debian-transmission 的用户，你设置的目录需要让该用户有可写权限。
  • DHT 网络可能会造成 tracker 服务器记录数据出错而被认为作弊，一般的 pt 站都会建议关闭这一选项。
  • 在启用 rpc 后大部分配置项可以远程在线修改，建议配置文件中不了解作用的选项不要随意改动，想尝试其作用的话可以通过 rpc 远程连接来临时修改。

另外，在上面贴出的配置文件中有一些参数是历史遗留选项，已有新的参数替代了它们的功能，只是旧参数在配置文件中还未删去而已。这也就意味着有部分参数的功能是相同的，在启用时需要注意甄别，详情可以在官方说明页面查看。