Linux 版 BitComet 安装指南

Linux 版 BitComet 提供 AppImage、Flatpak 及 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”相关的错误信息，请访问此页面

Flatpak 格式

BitComet 从 2.22.0 版开始提供 Flatpak 安装包。目前安装包仅支持 x86_64 Linux 系统，ARM64、龙芯等其他架构不能直接安装。

第1步 安装 Flatpak

Ubuntu / Debian

sudo apt update
sudo apt install flatpak

Linux Mint 通常已预装 Flatpak。如果系统中没有 flatpak 命令，可使用上述 Ubuntu / Debian 命令安装。

Fedora

Fedora Workstation 通常已预装 Flatpak。如果尚未安装，请执行：

sudo dnf install flatpak

Arch Linux / Manjaro

sudo pacman -S flatpak

openSUSE Leap / Tumbleweed

sudo zypper install flatpak

安装 Flatpak 后，建议注销并重新登录，以便桌面环境加载应用菜单和其他桌面集成功能。仅通过命令行运行 BitComet 时通常不需要此步骤。

第2步 添加 Flathub 软件源

为当前用户添加 Flathub：

flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

可以使用以下命令确认 Flathub 已配置：

flatpak remotes --user

第3步 下载并安装 BitComet

从官网下载 BitComet-x.y.z-x86_64.flatpak，打开命令行终端并进入安装包所在目录，然后执行：

flatpak install --user ./BitComet-x.y.z-x86_64.flatpak

首次安装时不要添加 --no-deps。Flatpak 会自动从 Flathub 下载所需的 org.gnome.Platform//50 运行时。该运行时可能占用数百 MB 存储空间，但当前用户安装的其他 Flatpak 应用可以共享它。

第4步 运行 BitComet

安装完成后，可以从应用菜单启动 BitComet，也可以执行：

flatpak run com.bitcomet.BitComet

安装新版本

下载新版 .flatpak 文件后，再次执行安装命令，并将 x.y.z 替换为实际版本号：

flatpak install --user ./BitComet-x.y.z-x86_64.flatpak

BitComet 安装包是本地分发的单文件 bundle，因此应用本身不会通过 flatpak update 从 Flathub 自动更新。Flatpak 仍可更新由 Flathub 提供的运行时：

flatpak update --user

查看信息和权限

flatpak info com.bitcomet.BitComet
flatpak info --show-permissions com.bitcomet.BitComet

当前沙箱允许网络访问、音频、Wayland/X11 显示、桌面通知、GPU 加速以及访问当前用户的下载目录。其他文件系统位置默认不开放。

卸载 BitComet

flatpak uninstall --user com.bitcomet.BitComet

如需清理不再被任何当前用户安装的 Flatpak 应用使用的运行时，请执行：

flatpak uninstall --user --unused

常见问题

应用菜单中没有 BitComet

先注销并重新登录，然后确认 BitComet 已安装：

flatpak list --app --user

即使应用菜单尚未刷新，也可以使用 flatpak run com.bitcomet.BitComet 启动。

提示找不到 org.gnome.Platform//50

确认已为当前用户添加 Flathub，然后手动安装运行时：

flatpak remotes --user
flatpak install --user flathub org.gnome.Platform//50

随后重新执行 BitComet 安装命令。

文件选择窗口中的下载目录为空

Flatpak 通过 XDG 用户目录配置定位宿主机的下载目录。使用以下命令检查当前设置：

xdg-user-dir DOWNLOAD

如果命令输出的不是正确的下载目录，请安装 xdg-user-dirs、更新目录设置，然后重新启动 BitComet。安装包使用标准 XDG 下载目录，以兼容不同用户名和 Linux 发行版。

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