Deluge 2.2.0 配置参数详解

目标：逐项讲解 Deluge 2.2.0 的核心配置文件 core.conf 全部参数（默认值与含义）、Web UI 配置域 web.conf 与 RPC 认证文件 auth，并给出一套生产可用的做种服务器配置模板。已在 Ubuntu 22.04（x86_64）上实测通过（Deluge 2.2.0 + libtorrent 2.0.13.0，参数表为守护进程实际落盘值）。

一、环境信息

• 操作系统：Ubuntu 22.04（x86_64）
• 软件版本：Deluge 2.2.0（官方最新稳定版，2025-04-28 发布）、libtorrent 2.0.13.0
• 配置文件位置（systemd 专用用户 deluge 托管，官方推荐形态）：/var/lib/deluge/.config/deluge/
  • root 直装时为 /root/.config/deluge/
  • 容器化部署（linuxserver/deluge）时为挂载点 /config
• 涉及文件：core.conf（核心参数）、web.conf（Web UI 参数）、auth（RPC 账号）、hostlist.conf（客户端连接记录）
• 下载目录示例：/downloads（core.conf 默认 download_location）

二、前置条件

1. Deluge 2.2.0 已部署并运行：裸机安装走发行版包或 PyPI，容器化部署见《Deluge 2.2.0 Docker Compose 部署指南》（https://www.quzuo.net/document/oJe1CN3VNd1z）；
2. 守护进程至少完整启动过一次（core.conf 首启自动生成全部默认键）；
3. 具备管理入口之一：deluge-console（用法见《Deluge 2.2.0 常用 CLI 命令与工具详解》（https://www.quzuo.net/document/BzvdX4hSROM9））或 Web UI。

三、参数查看与修改方式

Deluge 的配置查看与修改有三条路径，效果等价、适用场景不同：

3.1 方式一：deluge-console 的 config 命令（推荐，在线生效）

deluge-console -d 127.0.0.1 -p 58846 -U localclient -P e876e4ca92f9f08b3ee5cab5e590bbd84d1210ec "config download_location listen_ports max_connections_global dht"

dht: True
download_location: /downloads
listen_ports: (6881, 6891)
max_connections_global: 200

修改单值（实测回显，改完立即生效并由守护进程写回 core.conf）：

deluge-console -d 127.0.0.1 -p 58846 -U localclient -P e876e4ca92f9f08b3ee5cab5e590bbd84d1210ec "config -s max_download_speed 2048"

Setting "max_download_speed" to: 2048.0
Configuration value successfully updated.

3.2 方式二：Web UI 首选项

浏览器登录 Web UI → 顶部工具栏「Preferences」→ 分类页（Bandwidth/Network/Queue/Downloads/Cache/Proxy/Encryption 等）可视化调整，保存即生效。适合人工调参，键与 core.conf 一一对应。

3.3 方式三：直接编辑 core.conf（仅限停机维护）

core.conf 为 JSON 片段拼接格式（文件头 {"file": 1, "format": 1} + 参数体），首启实测落盘节选：

{
    "file": 1,
    "format": 1
}{
    "add_paused": false,
    "allow_remote": false,
    "auto_manage_prefer_seeds": false,
    "auto_managed": true,
    "cache_expiry": 60,
    "cache_size": 512,
    ...
}

⚠️ 注意：守护进程持有配置的内存态，运行期间手改文件会在其落盘时被覆盖。手改必须先 systemctl stop deluged，改完再 start；日常调参一律走 config -s。

四、参数总览（core.conf 全键实测默认值）

下表为首启实测落盘的全部参数（其中 max_download_speed 实测为 -1.0，后经 config -s 演示改为 2048.0； listen_random_port 为随机分配值，每机不同）：

💡 说明：表中 path_chooser_* 五键属 GTK 桌面端路径选择器，服务器场景不生效但会随配置落盘；info_sent/send_info 与匿名遥测相关，隐私敏感环境将 send_info 保持 false 即可。

五、核心参数分类详解

5.1 路径与存储

实测验证（改下载目录后生效回显）：

deluge-console [连接参数] "config download_location"

download_location: /downloads

5.2 网络与端口

💡 技术拓展：入站端口的「固定 vs 随机」两种取法对比——

取法	特点	适用场景
固定端口（random_port: false，listen_ports 生效）	防火墙/路由器映射规则稳定	有公网入口或端口映射需求
随机端口（random_port: true）	每次启动换端口，监听冲突概率低	NAT 后无映射需求的内网下载机

本文因需要公网可达性验证连通性，采用固定端口方案。

5.3 连接与速率限制

💡 技术拓展：「全局限速 vs 每任务限速」两种粒度的取舍——

粒度	特点	适用场景
全局（max_download_speed 等）	一条总闸，配置简单	单机带宽独占，只保网络可用性
每任务（*_per_torrent）	任务级公平/倾斜控制	PT 保种任务要与普通下载区分优先级

两者叠加生效（取更严者）；本文全局限速 2048KiB/s + 每任务不限的实测组合，兼顾办公网与下载共存。

5.4 队列与做种控制

💡 技术拓展：「做种何时停」的三类常见策略——

策略	机制	适用人群
固定分享率（stop_seed_at_ratio + stop_seed_ratio）	传够 N 倍即停	公网站点，回报社区
固定时长（seed_time_limit）	做种满 N 分钟即停	有周期性清理习惯的机器
永久做种（全部 false）	人工管理	PT 站保种（站点考核比率）

本文模板面向 PT 保种，采用永久做种。

5.5 协议特性开关

💡 技术拓展：BT 流量加密策略对比（应对 ISP 对 BT 协议的限速/干扰）——

策略	特点	适用场景
禁用（2）	兼容性最好，协议特征全裸	内网/无干扰环境
启用（1，默认）	能加密则加密，握手后可协商降级	通用环境
强制（0）	全程强制加密，拒连明文节点	ISP 深度包检测干扰 BT 的环境

加密有 CPU 开销且会排除不支持加密的老节点；本文保留默认「启用 + 二者兼容」。

5.6 磁盘缓存

实测命中率观测入口是 cache 命令（回显见《Deluge 2.2.0 常用 CLI 命令与工具详解》5.9 节），调参前后对比 read/write_hit_ratio。

5.7 代理与匿名（proxy 对象）

实测默认值（JSON 对象）：

"proxy": {
    "anonymous_mode": false,
    "force_proxy": false,
    "hostname": "",
    "password": "",
    "port": 8080,
    "proxy_hostnames": true,
    "proxy_peer_connections": true,
    "proxy_tracker_connections": true,
    "type": 0,
    "username": ""
}

5.8 界面与杂项

六、Web UI 配置域（web.conf 实测全键）

web.conf 由 deluge-web 首启自动生成，改密后实测内容节选（密码相关为哈希存储）：

"base": "/",
"cert": "ssl/daemon.cert",
"default_daemon": "",
"enabled_plugins": [],
"first_login": true,
"https": false,
"interface": "0.0.0.0",
"language": "",
"pkey": "ssl/daemon.pkey",
"port": 8112,
"pwd_salt": "7278339d7d9163731466d8d78acca6a7649985ee",
"pwd_sha1": "4923dd760b1592f172f7775040b55558365b710e",
"session_timeout": 3600,
"sessions": { ... },
"show_session_speed": false,
"show_sidebar": true,
"sidebar_multiple_filters": true,
"sidebar_show_zero": false,
"theme": "gray"

⚠️ 注意：web.conf 的 sessions 会随登录累积，安全审计时可定期清理；pwd_sha1+pwd_salt 为单向摘要，但 SHA1 抗碰撞强度有限，生产务必用长口令。

七、RPC 认证文件 auth

auth 文件一行一账号，格式 用户名:口令:级别，首启实测内容：

localclient:e876e4ca92f9f08b3ee5cab5e590bbd84d1210ec:10

• localclient：仅限本机 127.0.0.1 连接使用，级别 10（管理员）；
• 追加远程账号格式如 admin:q1w2e3r4:5（示例演示口令，生产请用强口令；级别 5 为普通用户，仅能看自己的任务）；
• 配合 core.conf 的 allow_remote: true 与放行 daemon_port 即可跨机管理；
• 修改 auth 后需重启 deluged 生效。

八、生产配置模板（做种服务器）

适用场景：8GB 内存、SSD 数据盘、300Mbps 带宽独占的 PT 保种/长期做种服务器，任务量 50–200。全部用 config -s 在线下发（连接参数同前，逐条执行）：

deluge-console [连接参数] "config -s download_location /data/downloads"
deluge-console [连接参数] "config -s max_download_speed 30720"
deluge-console [连接参数] "config -s max_upload_speed 24576"
deluge-console [连接参数] "config -s max_connections_global 800"
deluge-console [连接参数] "config -s max_upload_slots_global 20"
deluge-console [连接参数] "config -s max_active_downloading 5"
deluge-console [连接参数] "config -s max_active_seeding 200"
deluge-console [连接参数] "config -s max_active_limit 220"
deluge-console [连接参数] "config -s stop_seed_at_ratio False"
deluge-console [连接参数] "config -s remove_seed_at_ratio False"
deluge-console [连接参数] "config -s pre_allocate_storage True"
deluge-console [连接参数] "config -s cache_size 8192"
deluge-console [连接参数] "config -s cache_expiry 120"
deluge-console [连接参数] "config -s random_port False"
deluge-console [连接参数] "config -s dht False"

参数解读：

• 限速按 300Mbps 的 80% 落在 30720KiB/s（下载）/24576KiB/s（上传），留出协议余量；
• 做种配额放大到 200（活跃做种），下载 5 个防止抢占磁盘 IO；
• 保种场景关闭比率终止与 DHT（PT 站点禁止 DHT/PEX 泄露私有种子，utpex/lsd 同理建议一并关闭）；
• 缓存 8192 块（128MiB）+ 120 秒过期，降低 SSD 写放大；
• 固定入站端口便于防火墙与监控规则固化。

回验（实测形态）：

deluge-console [连接参数] "config max_download_speed max_upload_speed cache_size"

cache_size: 8192
max_download_speed: 30720.0
max_upload_speed: 24576.0

九、常见问题

Q1：手改 core.conf 后配置"跳回"旧值？ 守护进程落盘覆盖了文件。改配置必须停机改或直接用 config -s（在线生效且落盘）。

Q2：config -s 报值类型错误？ 布尔值用 True/False 首字母大写；速率是数值（KiB/s）；端口范围是二值列表，用 Web UI 修改更直观。

Q3：改了 daemon_port 连不上了？ 确认放行新端口（防火墙 + 端口映射），所有客户端（console/Web/桌面端）的连接地址都要改端口；systemd 形态先 stop 再 start。

Q4：Web UI 忘记密码？ 停 deluge-web，删除 web.conf，启动后用默认密码 deluge 登录并重新改密（auth 文件不受影响）。

Q5：为什么默认配置下载/上传都是 -1 还是被"限速"了？ 活跃任务配额（max_active_*）与全局连接数（默认 200）会隐性限流，感知"慢"时先查 status 的连接数与队列状态，再调带宽类参数。

十、参考链接

1. Deluge 官方文档站：https://deluge.readthedocs.io/
2. 官方 Changelog（2.2.0）：https://deluge.readthedocs.io/en/latest/changelog.html
3. 官方 systemd 服务指南（配置目录与托管形态依据）：https://deluge.readthedocs.io/en/latest/how-to/systemd-service.html
4. 本专栏系列：《Deluge 介绍与选型指南》（https://www.quzuo.net/document/s8y3AQ7QBBDF）、《Deluge 2.2.0 Docker Compose 部署指南》（https://www.quzuo.net/document/oJe1CN3VNd1z）、《Deluge 2.2.0 常用 CLI 命令与工具详解》（https://www.quzuo.net/document/BzvdX4hSROM9）。