Deluge Docker镜像文档

镜像概述和主要用途

Deluge是一款开源跨平台的BitTorrent客户端，其Docker镜像提供了便捷的部署方式，无需复杂环境配置即可快速启动服务。该镜像包含Deluge核心程序及必要依赖，支持图形界面（GTK）和Web界面访问，适用于个人或小型团队通过P2P协议进行文件下载与共享，具备灵活的配置选项和安全特性。

核心功能和特性

• 多界面支持：提供Web界面（默认端口8112）、GTK图形界面及控制台界面，满足不同使用场景需求。
• 插件扩展系统：支持丰富的插件生态，可扩展功能如统计分析、RSS订阅、远程控制等。
• 种子管理：支持种子添加、暂停/恢复、优先级设置、标签分类及批量操作。
• 安全特性：集成DHT、PEX协议支持，提供传输加密（RC4）、IP过滤及匿名模式选项。
• 资源控制：可配置全局/单种带宽限制、连接数限制及下载/上传速度调度。
• 跨平台兼容：基于Docker容器化部署，兼容Linux、Windows、macOS等主流操作系统。
• 数据持久化：支持配置文件、下载文件及状态数据的持久化存储，确保服务重启后数据不丢失。

使用场景和适用范围

• 个人文件下载：适用于个人用户通过BitTorrent协议下载电影、软件、文档等资源。
• 小型团队资源共享：支持团队内部通过种子共享项目文件、备份数据等，提高资源分发效率。
• 隔离环境运行：通过Docker容器隔离BitTorrent服务与主机系统，降低安全风险。
• 低资源设备部署：轻量级设计，可在NAS、树莓派等低功耗设备上稳定运行。

使用方法和配置说明

基本运行命令

通过docker run快速启动Deluge服务：

docker run -d \
  --name=deluge \
  -p 8112:8112 \  # Web界面端口
  -p 6881:6881 \  # BT监听端口(TCP)
  -p 6881:6881/udp \  # BT监听端口(UDP)
  -v /path/to/deluge/config:/config \  # 配置文件持久化
  -v /path/to/downloads:/downloads \  # 下载文件存储目录
  -e PUID=1000 \  # 运行用户ID(避免权限问题)
  -e PGID=1000 \  # 运行用户组ID
  -e TZ=Asia/Shanghai \  # 时区设置
  linuxserver/deluge  # 推荐使用linuxserver维护的官方镜像

Docker Compose配置示例

创建docker-compose.yml文件简化部署：

version: "3"
services:
  deluge:
    image: linuxserver/deluge
    container_name: deluge
    restart: unless-stopped
    ports:
      - "8112:8112"    # Web界面
      - "6881:6881"    # TCP监听
      - "6881:6881/udp"# UDP监听
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/config       # 配置目录(本地路径)
      - ./downloads:/downloads # 下载目录(本地路径)

启动命令：docker-compose up -d

环境变量说明

数据持久化配置

为确保配置和下载文件不丢失，需挂载以下目录：

• /config：存储Deluge配置文件、插件、种子状态等数据，建议本地目录挂载(如./config:/config)。
• /downloads：存储下载完成的文件，建议挂载至容量充足的本地目录或网络存储(如./downloads:/downloads)。

Web界面访问与初始配置

1. 启动容器后，通过http://<主机IP>:8112访问Web界面。
2. 首次登录默认密码为deluge，登录后需立即修改密码（路径：Preferences > Interface > Password）。
3. 配置下载目录：进入Preferences > Downloads，设置"Download to"路径为/downloads(与容器内挂载路径一致)。
4. 端口转发：若需远程访问，需在路由器中转发容器映射的TCP/UDP端口(默认6881)。

高级配置：插件安装

1. 下载插件文件（.egg格式）至本地./config/plugins目录。
2. 重启容器：docker restart deluge。
3. 在Web界面Preferences > Plugins中启用已安装插件。

注意事项

• 确保主机防火墙开放容器映射的端口(8112、6881等)。
• 避免使用默认密码，及时更新Web界面登录凭证。
• 下载文件需遵守当地法律法规，尊重版权。
• 定期备份/config目录，防止配置丢失。