BitComet Web UI Docker镜像文档

镜像概述

BitComet Web UI Docker镜像允许用户通过任何浏览器访问BitComet的Web界面，实现对BitComet下载任务的便捷管理。镜像支持通过Docker Compose或Docker CLI快速部署，适用于需要远程或本地管理下载任务的场景。

镜像标签列表：[***]

注：BitComet GUI版本的Docker镜像可访问：[***]

核心功能与特性

• Web界面访问：通过任何浏览器访问BitComet Web UI，无需安装桌面客户端
• BitTorrent协议支持：内置BitTorrent协议支持，包含TCP和UDP端口配置
• 配置持久化：通过卷挂载实现BitComet配置文件持久化存储
• 下载文件持久化：下载文件存储目录可挂载至主机，确保数据不丢失
• 环境变量配置：支持通过环境变量自定义WebUI端口、BitTorrent端口、用户名和密码

使用场景

• 家庭服务器或NAS设备：在无桌面环境的服务器上部署，通过浏览器远程管理下载任务
• 多设备访问：在局域网内通过不同设备（电脑、手机、平板）访问Web界面
• 轻量级部署：无需安装完整BitComet客户端，通过Docker容器快速启动和管理

部署方法

部署方法1：使用docker-compose

步骤1：创建docker-compose.yml文件

将以下内容保存到本地系统的docker-compose.yml文件中：

yaml
services:
    sandbox:
        container_name: bitcomet-webui
        image: wxhere/bitcomet-webui:latest
        volumes:
            # 挂载主机目录至容器，用于存储配置文件
            - /docker/appdata/BitComet:/root/.config/BitComet:rw
            # 挂载主机目录至容器，用于存储下载文件
            - ~/Downloads:/root/Downloads:rw
        ports:
            # BitComet WebUI端口
            - 6080:80
            # BitTorrent端口（TCP和UDP）
            - 6082:6082
            - 6082:6082/udp
        environment:
            - BITCOMET_WEBUI_PORT=8080
            - BITCOMET_BT_PORT=6082
            - WEBUI_USERNAME=test
            - WEBUI_PASSWORD=test

注意：请根据实际需求修改用户名、密码和端口映射。

步骤2：拉取镜像并启动容器

执行以下命令拉取镜像、创建并运行容器：

bash
docker-compose -f docker-compose.yml up

步骤3：通过浏览器访问Web UI

在浏览器中打开以下地址，使用配置的用户名和密码登录：

• 访问地址：[***]
• 用户名：test
• 密码：test

部署方法2：使用Docker CLI

步骤1：拉取镜像

执行以下命令拉取最新版本镜像：

bash
docker pull wxhere/bitcomet-webui:latest

步骤2：创建并运行容器

执行以下命令创建并启动容器：

bash
docker run -d \
  --name=bitcomet-webui \
  -e BITCOMET_WEBUI_PORT=8080 \
  -e BITCOMET_BT_PORT=6082 \
  -e WEBUI_USERNAME=test \
  -e WEBUI_PASSWORD=test \
  -p 6080:8080 \
  -p 6882:6082 \
  -p 6882:6082/udp \
  -v /docker/appdata/BitComet:/root/.config/BitComet:rw \
  -v ~/Downloads:/root/Downloads:rw \
  --restart unless-stopped \
  wxhere/bitcomet-webui:latest

注意：请根据实际需求修改用户名、密码和端口映射。

步骤3：通过浏览器访问Web UI

在浏览器中打开以下地址，使用配置的用户名和密码登录：

• 访问地址：[***]
• 用户名：test
• 密码：test

配置说明

环境变量

卷挂载

端口映射