Linux 版 BitComet 安装指南

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

AppImage 格式

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

^ 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

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

使用图形界面

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

使用命令行终端(Terminal)

  1. 打开 terminal 窗口
  2. 切换当前目录到 AppImage 文件所在目录： ``` cd 
1. 设置 AppImage 文件可执行权限：```
chmod +x BitComet.AppImage
  1. 运行 AppImage 文件：``` ./BitComet.AppImage

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

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

1. 打开 terminal 窗口
1. 切换当前目录到 AppImage 文件所在目录： ```
cd <my directory>
  1. 再次尝试运行 AppImage 文件：``` ./BitComet.AppImage
1. 根据错误信息安装缺少的依赖库：

##### Ubuntu / Debian 发行版

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

- *注：** Ubuntu 24.04 及以上版本需要添加 22.04 的 apt 下载源
```bash
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 下载源
  1. 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 格式

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

  1. 打开 terminal 窗口
  2. 切换当前目录到 deb 文件所在目录： ``` cd 
1. 安装 deb 文件：```
sudo apt install ./BitComet-2.12.0-x86_64.deb

运行GUI图形界面主程序： ``` BitComet

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

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

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

部署方法 1: 使用 docker-compose

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

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

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

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

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

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

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

Docker 镜像（WebUI界面模式）

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

部署方法 1: 使用 docker-compose

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

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

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