BitComet(比特彗星)高效好用的BT下载软件，BT资源的下载利器

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== 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 版本：

<code> # 查找 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 
</code>

**第2步** 下载 BitComet

Linux 版 BitComet 的 AppImage 文件可以从[[https://www.bitcomet.com/index.htm|官网页面]]下载。

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

=== 使用图形界面 ===

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

=== 使用命令行终端(Terminal) ===

  - 打开 terminal 窗口
  - 切换当前目录到 AppImage 文件所在目录： <code> cd <my directory> </code>
  - 设置 AppImage 文件可执行权限：<code>chmod +x BitComet.AppImage</code>
  - 运行 AppImage 文件：<code>./BitComet.AppImage</code>

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

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

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

== 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 下载源
<code>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 下载源
</code>

 - 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”相关的错误信息，请访问[[https://docs.appimage.org/user-guide/troubleshooting/fuse.html|此页面]] 

===== Deb 格式 =====

**第1步** 下载 BitComet

Linux 版 BitComet 的 deb 打包文件可以从[[https://download.bitcomet.com/linux/|官网]]下载。

**第2步** 安装 deb 打包文件

  - 打开 terminal 窗口
  - 切换当前目录到 deb 文件所在目录： <code> cd <my directory> </code>
  - 安装 deb 文件：<code>sudo apt install ./BitComet-2.12.0-x86_64.deb</code>

**第3步** 运行程序

运行GUI图形界面主程序： <code>BitComet</code>
运行WebUI界面的命令行模式主程序： <code>bitcometd</code>

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

===== 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
            volumes:
                # 将容器中的配置文件目录映射到主机目录中
                - /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 \
	  -e VNC_PASSWORD=123456 \
	  -e HTTP_PASSWORD=123456 \
	  -e USER=sandbox \
	  -e PASSWORD=123456 \
	  -p 5900:5900 \
	  -p 6080:80 \
	  -p 6882:6882 \
	  -p 6882:6882/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
            image: wxhere/bitcomet-webui:latest
            volumes:
                # 将容器中的配置文件目录映射到主机目录中
                - /docker/appdata/BitComet:/root/.config/BitComet:rw
                # 将容器中的下载目录映射到主机目录中
                - ~/Downloads:/root/Downloads:rw
            ports:
                # Web GUI 访问端口
                - 6080:8080
                # 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 \
          -e BITCOMET_WEBUI_PORT=8080 \
          -e BITCOMET_BT_PORT=6082 \
          -e WEBUI_USERNAME=test \
          -e WEBUI_PASSWORD=test \
	  -p 6080:8080 \
	  -p 6882:6882 \
	  -p 6882:6882/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