BitComet Docker镜像文档

1. 镜像概述和主要用途

BitComet Docker镜像是BitComet BitTorrent客户端的容器化部署方案。BitComet是一款功能全面的BitTorrent/HTTP/FTP下载客户端，支持多种下载协议和加速技术。该Docker镜像提供了便捷的部署方式，无需在主机系统直接安装图形环境，可通过VNC客户端或Web浏览器访问BitComet图形界面(GUI)，适用于服务器、无头(Headless)环境或需要快速隔离部署的场景。

2. 核心功能和特性

• 多方式GUI访问：支持通过VNC客户端或Web浏览器两种方式访问BitComet图形界面，满足不同使用***惯需求。
• 配置持久化：通过卷挂载实现BitComet配置文件持久化存储，容器重启后配置不丢失。
• 下载文件管理：支持将下载目录挂载到主机，方便管理和访问下载文件。
• 安全认证：通过环境变量配置VNC、Web访问及系统用户的认证密码，保障访问安全。
• 端口灵活映射：支持自定义BitTorrent协议端口及访问端口，适应不同网络环境。

3. 使用场景和适用范围

• 无头环境部署：在无图形界面的服务器或云主机中运行BitComet GUI，通过远程访问进行操作。
• 快速部署：无需手动配置依赖环境，通过Docker一键部署BitComet。
• 环境隔离：容器化运行避免与主机系统环境冲突，配置和数据独立管理。
• 多实例运行：支持通过不同端口和卷配置，在同一主机部署多个独立BitComet实例。

4. 使用方法和配置说明

4.1 部署准备

• 已安装Docker Engine（20.10+推荐）及Docker Compose（如使用Compose部署）。
• 主机开放所需端口（默认5900、6080、6082等，可自定义）。

4.2 部署方案

4.2.1 使用Docker Compose部署

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

services:
  bitcomet:
    container_name: bitcomet
    image: wxhere/bitcomet:latest
    volumes:
      # 挂载配置文件目录（主机路径需自定义）
      - /docker/appdata/BitComet:/home/sandbox/.config/BitComet:rw
      # 挂载下载文件目录（主机路径需自定义）
      - ~/Downloads:/home/sandbox/Downloads:rw
    ports:
      # VNC访问端口（主机端口:容器端口）
      - 5900:5900
      # Web UI访问端口
      - 6080:80
      # BitTorrent TCP端口
      - 6082:6082
      # BitTorrent UDP端口
      - 6082:6082/udp
    environment:
      - VNC_PASSWORD=123456  # VNC访问密码（需修改）
      - HTTP_PASSWORD=123456  # Web UI访问密码（需修改）
      - USER=sandbox  # 系统用户名（需修改）
      - PASSWORD=123456  # 系统用户密码（需修改）

注意：请根据实际需求修改用户名、密码、端口映射及主机目录路径。

步骤2：启动容器

在docker-compose.yml文件所在目录执行：

docker-compose up -d

（-d参数表示后台运行，首次运行可省略该参数查看启动日志）

4.2.2 使用Docker CLI部署

步骤1：拉取镜像

docker pull wxhere/bitcomet:latest

步骤2：创建并启动容器

docker run -d \
  --name=bitcomet \
  -e VNC_PASSWORD=123456 \  # VNC访问密码（需修改）
  -e HTTP_PASSWORD=123456 \  # Web UI访问密码（需修改）
  -e USER=sandbox \          # 系统用户名（需修改）
  -e PASSWORD=123456 \       # 系统用户密码（需修改）
  -p 5900:5900 \             # VNC端口映射
  -p 6080:80 \               # Web UI端口映射
  -p 6082:6082 \             # BitTorrent TCP端口映射
  -p 6082:6082/udp \         # BitTorrent UDP端口映射
  -v /docker/appdata/BitComet:/home/sandbox/.config/BitComet:rw \  # 配置文件目录（主机路径需自定义）
  -v ~/Downloads:/home/sandbox/Downloads:rw \  # 下载文件目录（主机路径需自定义）
  --restart unless-stopped \  # 容器退出后自动重启（除非手动停止）
  wxhere/bitcomet:latest

4.3 配置参数说明

4.3.1 环境变量

4.3.2 端口映射

4.3.3 卷挂载

4.4 访问方法

4.4.1 Web UI访问

1. 打开浏览器，访问地址：http://<主机IP>:<Web UI主机端口>（默认[***]）。
2. 输入用户名（默认sandbox）和Web UI密码（HTTP_PASSWORD配置值）。
3. 登录后，点击桌面的“BitComet”图标启动客户端。

4.4.2 VNC客户端访问

1. 打开VNC客户端（如RealVNC、TightVNC等）。
2. 输入连接地址：<主机IP>:<VNC主机端口>（默认127.0.0.1:5900）。
3. 输入VNC密码（VNC_PASSWORD配置值）。
4. 登录后，点击桌面的“BitComet”图标启动客户端。

4.5 注意事项

• 安全建议：生产环境中必须修改默认密码（VNC_PASSWORD、HTTP_PASSWORD、PASSWORD），避免使用弱密码。
• 端口冲突：若主机已占用默认端口，需修改主机端口映射（如5901:5900）。
• 目录权限：主机挂载目录需确保Docker用户有读写权限（可通过chmod或chown调整）。
• 镜像更新：如需更新镜像，可执行docker pull wxhere/bitcomet:latest后重启容器。