Linux 版 BitComet 安装指南

Linux 版 BitComet 使用 AppImage 格式及 deb 格式打包，也提供 Docker 镜像。

AppImage 格式

AppImage 打包文件无需管理员权限安装即可直接运行。
关于 AppImage 格式的详细信息可以参阅 https://www.appimage.org/

第1步 检查 Linux 发行版版本（可选）

Linux 发行版	支持的版本
Ubuntu	18.04
Debian	12.1
Fedora	38
openSUSE	Leap 15.5 / Tumbleweed
CentOS	Stream 9
深度 Deepin	23
优麒麟 Ubuntu Kylin	22.04
开放麒麟 openKylin	1.0.1
其它	GLIBCXX_3.4.22 或更高

在 Linux 发行版中运行 BitComet 的唯一要求是 libstdc++.so 中的 GLIBCXX 版本。
如果 Linux 发行版中的 GLIBCXX 版本低于 GLIBCXX_3.4.22，BitComet将无法运行。

如果您的 Linux 发行版未在表中列出，可以通过以下命令找到 Linux 发行版中已安装的 GLIBCXX 版本：

# 查找 libstdc++.so.6 文件
find /usr/ -name libstdc++.so.6

# 获取 GLIBCXX 版本，通常可使用
strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX

# 或者
strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX

第2步 下载 BitComet

Linux 版 BitComet 的 AppImage 文件可以从官网页面下载。

第3步 设置 AppImage 文件可执行权限后，直接运行

使用图形界面

打开您的文件管理器，定位到 AppImage 文件所在目录
右键单击 AppImage 文件，选择“属性”
切换到权限页面，点击“允许将文件作为程序运行”复选框
关闭对话框
双击 AppImage 文件，运行程序

使用命令行终端(Terminal)

打开 terminal 窗口
切换当前目录到 AppImage 文件所在目录：

cd <my directory>

设置 AppImage 文件可执行权限：

chmod +x BitComet.AppImage

运行 AppImage 文件：

./BitComet.AppImage

第4步 如果运行 AppImage 文件失败，请安装缺少的依赖库（与发行版相关）

如果您的 Linux 发行版不包含 BitComet 所依赖的一些第三方库，请尝试手动安装它们。

打开 terminal 窗口
切换当前目录到 AppImage 文件所在目录：

cd <my directory>

再次尝试运行 AppImage 文件：

./BitComet.AppImage

根据错误信息安装缺少的依赖库：

Ubuntu / Debian 发行版

库	查看已安装版本及安装依赖库的命令
libfuse2	apt list \| grep libfuse sudo apt install libfuse2
libwebkit2gtk-4.0	apt list \| grep libwebkit2gtk sudo apt install libwebkit2gtk-4.0-37

注： Ubuntu 24.04 及以上版本需要添加 22.04 的 apt 下载源

sudo nano /etc/apt/sources.list.d/ubuntu.sources
# Suites: xxx xxx xxx 后面加上 jammy
# Suites: xxx-security 后面加上 jammy-security
# 存盘退出
sudo apt update
sudo apt install libwebkit2gtk-4.0-37
# 如有必要可恢复 apt 下载源

sudo nano /etc/apt/sources.list.d/ubuntu.sources

Fedora / RedHat / CentOS 发行版

库	查看已安装版本及安装依赖库的命令
libfuse2	yum list fuse* sudo yum --enablerepo=epel install fuse-sshfs sudo usermod -a -G fuse $(whoami)
libwebkit2gtk-4.0	yum list webkit2gtk* sudo yum install webkit2gtk-4.0.x86_64

openSUSE 发行版

库	查看已安装版本及安装依赖库的命令
libfuse2	zypper search -i libfuse sudo zypper install fuse libfuse2
libwebkit2gtk-4.0	zypper search -i webkit2gtk sudo zypper install webkit2gtk-4_0-37

更多与“FUSE”相关的错误信息，请访问此页面

Deb 格式

第1步 下载 BitComet

Linux 版 BitComet 的 deb 打包文件可以从官网下载。

第2步 安装 deb 打包文件

打开 terminal 窗口
切换当前目录到 deb 文件所在目录：

cd <my directory>

安装 deb 文件：

sudo apt install ./BitComet-2.12.0-x86_64.deb

第3步 运行程序

运行GUI图形界面主程序：

BitComet

运行WebUI界面的命令行模式主程序：

bitcometd

**注：**两种模式的主程序在同一时间只能运行一个实例。

Docker 镜像（GUI图形界面模式）

图形界面模式的 BitComet Docker 镜像列表：https://hub.docker.com/r/wxhere/bitcomet/tags

部署方法 1: 使用 docker-compose

第1步: 保存 docker-compose.yml 文件到本地系统：

services:
    sandbox:
        container_name: bitcomet
        image: wxhere/bitcomet:latest
        ulimits:
          nofile:
            soft: 65536
            hard: 65536
        volumes:
            # 将 BitComet 配置文件保存在主机上
            - /docker/appdata/BitComet:/home/sandbox/.config/BitComet:rw
            # 将下载文件保存在主机上
            - ~/Downloads:/home/sandbox/Downloads:rw
        ports:
            # VNC GUI 端口
            - 5900:5900
            # Web GUI 端口
            - 6080:80
            # BitTorrent 端口
            - 6082:6082
            - 6082:6082/udp
        environment:
            - VNC_PASSWORD=123456
            - HTTP_PASSWORD=123456
            - USER=sandbox
            - PASSWORD=123456

注意：请按照您自己的需求更改用户名、密码和端口映射

第2步: 拉取 docker 镜像，创建容器并运行：

docker-compose -f docker-compose.yml up
第3步: 在浏览器中打开 BitComet 网页界面：

http://127.0.0.1:6080 用户名: sandbox 密码: 123456

或使用 VNC 客户端连接到 VNC 桌面：

端口: 5900
用户名: sandbox
密码: 123456

第4步: 点击桌面上的 BitComet 图标，启动程序（如果已关闭）。

部署方法 2: 使用 Docker 命令行

第1步: 拉取 docker 镜像：

docker pull wxhere/bitcomet:latest
第2步: 创建容器并运行：

docker run -d \
  --name=bitcomet \
  --ulimit nofile=65536:65536 \
  -e VNC_PASSWORD=123456 \
  -e HTTP_PASSWORD=123456 \
  -e USER=sandbox \
  -e PASSWORD=123456 \
  -p 5900:5900 \
  -p 6080:80 \
  -p 6082:6082 \
  -p 6082:6082/udp \
  -v /docker/appdata/BitComet:/home/sandbox/.config/BitComet:rw \
  -v ~/Downloads:/home/sandbox/Downloads:rw \
  --restart unless-stopped \
  wxhere/bitcomet:latest

注意：请按照您自己的需求更改用户名、密码和端口映射

第3步: 【同方法1】在浏览器中打开 BitComet 网页界面：

http://127.0.0.1:6080 用户名: sandbox 密码: 123456

或使用 VNC 客户端连接到 VNC 桌面：

端口: 5900
用户名: sandbox
密码: 123456

第4步: 【同方法1】点击桌面上的 BitComet 图标，启动程序（如果已关闭）。

Docker 镜像（WebUI界面模式）

WebUI界面模式的 BitComet Docker 镜像列表：https://hub.docker.com/r/wxhere/bitcomet-webui/tags

部署方法 1: 使用 docker-compose

第1步: 保存 docker-compose.yml 文件到本地系统：

services:
    sandbox:
        container_name: bitcomet-webui
        image: wxhere/bitcomet-webui:latest
        ulimits:
          nofile:
            soft: 65536
            hard: 65536
        volumes:
            # 将 BitComet 配置文件保存在主机上
            - /docker/appdata/BitComet:/root/.config/BitComet:rw
            # 将下载文件保存在主机上
            - ~/Downloads:/root/Downloads:rw
        ports:
            # BitComet WebUI 端口
            - 6080:80
            # BitTorrent 端口
            - 6082:6082
            - 6082:6082/udp
        environment:
            - BITCOMET_WEBUI_PORT=8080
            - BITCOMET_BT_PORT=6082
            - WEBUI_USERNAME=test
            - WEBUI_PASSWORD=test

注意：请按照您自己的需求更改用户名、密码和端口映射

第2步: 拉取 docker 镜像，创建容器并运行：

docker-compose -f docker-compose.yml up
第3步: 在浏览器中打开 BitComet 网页界面：

http://127.0.0.1:6080 用户名: test 密码: test

部署方法 2: 使用 Docker 命令行

第1步: 拉取 docker 镜像：

docker pull wxhere/bitcomet-webui:latest
第2步: 创建容器并运行：

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

注意：请按照您自己的需求更改用户名、密码和端口映射

第3步: 【同方法1】在浏览器中打开 BitComet 网页界面：

http://127.0.0.1:6080 用户名: test 密码: test