linuxserver/deluge

LinuxServer.io 容器特点

LinuxServer.io 团队发布的容器具有以下特性：

• 应用定期及时更新
• 简化的用户权限映射（PGID、PUID）
• 基于 s6 overlay 的自定义基础镜像
• 每周基础系统更新，通过共享层减少存储空间、 downtime 和带宽消耗
• 常规安全更新

Deluge 简介

Deluge 是一款轻量级、开源、跨平台的 BitTorrent 客户端，支持：

• 全加密传输
• Web 管理界面
• 插件扩展系统
• 更多功能...

支持的架构

通过 Docker 清单实现多平台支持，拉取 lscr.io/linuxserver/deluge:latest 即可自动匹配对应架构，也可通过标签指定具体架构：

版本标签

镜像提供以下标签，请注意不稳定/开发标签的使用风险：

应用设置

1. Web 管理界面：访问 [***] admin/deluge`。
2. 修改密码（推荐）：登录后进入「Preferences→Interface→Password」修改。
3. 端口配置：进入「Preferences→Network」，将入站端口改为 6881（或容器映射的端口），避免随机端口占用。

使用方法

Docker Compose（推荐）

创建 docker-compose.yml 文件，内容如下：

yaml
---  
services:  
  deluge:  
    image: lscr.io/linuxserver/deluge:latest  
    container_name: deluge  
    environment:  
      - PUID=1000        # 用户ID（见下方说明）  
      - PGID=1000        # 组ID（见下方说明）  
      - TZ=Etc/UTC       # 时区（如 Asia/Shanghai）  
      - DELUGE_LOGLEVEL=error  # 日志级别（可选，默认 info/warning）  
    volumes:  
      - /path/to/deluge/config:/config  # 配置文件目录（替换为实际路径）  
      - /path/to/downloads:/downloads   # 下载目录（替换为实际路径）  
    ports:  
      - 8112:8112        # Web界面端口  
      - 6881:6881        # BT入站端口（TCP）  
      - 6881:6881/udp    # BT入站端口（UDP）  
      - 58846:58846      # 轻客户端连接端口（可选）  
    restart: unless-stopped  

启动容器：

bash
docker-compose up -d  

Docker CLI

直接运行命令：

bash
docker run -d \  
  --name=deluge \  
  -e PUID=1000 \  
  -e PGID=1000 \  
  -e TZ=Etc/UTC \  
  -e DELUGE_LOGLEVEL=error `# 可选` \  
  -p 8112:8112 \  
  -p 6881:6881 \  
  -p 6881:6881/udp \  
  -p 58846:58846 `# 可选` \  
  -v /path/to/deluge/config:/config \  
  -v /path/to/downloads:/downloads \  
  --restart unless-stopped \  
  lscr.io/linuxserver/deluge:latest  

参数说明

用户/组标识符（PUID/PGID）

挂载主机目录时，需确保目录所有者的 UID/GID 与容器内的 PUID/PGID 一致，避免权限错误。通过以下命令获取当前用户的 UID/GID：

bash
id 用户名  

示例输出：

text
uid=1000(用户名) gid=1000(用户名) 组=1000(用户名)  

支持与维护

容器管理命令

• 进入容器终端：

  bash
  docker exec -it deluge /bin/bash  
  

• 实时查看日志：

  bash
  docker logs -f deluge  
  

• 查看容器版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' deluge  
  

更新容器

Docker Compose

bash
# 更新镜像  
docker-compose pull deluge  

# 重启容器  
docker-compose up -d deluge  

# 清理旧镜像  
docker image prune  

Docker CLI

bash
# 更新镜像  
docker pull lscr.io/linuxserver/deluge:latest  

# 停止并删除旧容器  
docker stop deluge && docker rm deluge  

# 启动新容器（使用原参数，配置会保留）  
docker run -d [原参数...] lscr.io/linuxserver/deluge:latest  

本地构建

如需自定义镜像，可克隆源码并构建：

bash
git clone [***]  
cd docker-deluge  
docker build --no-cache --pull -t lscr.io/linuxserver/deluge:latest .  

版本历史

• 23.08.25：更新 GeoIP 提供商，添加每周自动更新任务
• 12.01.25：libtorrentv1 分支基于 Alpine 3.21 重构
• 26.08.24：新增 libtorrentv1 标签
• 07.12.23：添加轻客户端连接端口 58846（可选）
• 22.02.22：基于 Alpine 重构，支持首次启动自动配置，添加 GeoIP

相关链接

• LinuxServer.io 官网
• Deluge ***网站
• 容器源码（GitHub）
• 社区支持（***）