1. 项目概述
bilibili-linux 是一个为 Linux 系统开发的第三方 B 站客户端项目,由社区开发者 msojocs 维护。作为一个长期使用 Linux 系统的用户,我发现官方一直没有推出 Linux 版的 B 站客户端,这给我们在 Linux 环境下观看 B 站视频带来了不少困扰。这个开源项目正好填补了这个空白,让我们可以在 Linux 终端或桌面环境中直接访问 B 站内容。
项目采用 AppImage 格式打包,这是一种在 Linux 系统中广泛使用的应用程序打包格式,具有很好的兼容性。它不需要复杂的安装过程,下载后赋予执行权限即可运行,非常适合在不同发行版间共享使用。
2. 安装前准备
2.1 系统环境检查
在开始安装前,我们需要确认系统环境是否符合要求:
-
操作系统:支持大多数主流 Linux 发行版,包括但不限于:
- Debian/Ubuntu 及其衍生版
- Fedora/RHEL/CentOS
- Arch Linux/Manjaro
- openSUSE
-
依赖项检查:
- FUSE(Filesystem in Userspace)支持
- 基本的图形环境(X11 或 Wayland)
- 网络连接正常
可以通过以下命令检查 FUSE 是否已安装:
bash复制lsmod | grep fuse
如果没有任何输出,则需要安装 FUSE:
bash复制# Debian/Ubuntu
sudo apt install fuse libfuse2
# RHEL/CentOS/Fedora
sudo yum install fuse
# Arch Linux
sudo pacman -S fuse
2.2 下载方式选择
项目提供了几种安装方式,我们可以根据实际情况选择:
- AppImage 直接下载:最简单的方式,适合大多数用户
- 源码编译安装:适合需要自定义功能的开发者
- 发行版特定安装脚本:针对 Debian 和 RedHat 系系统提供了专用脚本
注意:根据原文作者的反馈,
install_debian脚本在某些机器上可能无法正常运行,因此推荐使用通用的 AppImage 方式安装。
3. 详细安装步骤
3.1 通用安装方法(推荐)
这是最稳定可靠的安装方式,适用于绝大多数 Linux 发行版:
bash复制# 安装必要的依赖
sudo apt install -y libfuse-dev # Debian/Ubuntu
# 或 sudo yum install fuse-devel # RHEL/CentOS
# 下载最新版 AppImage
wget https://github.com/msojocs/bilibili-linux/releases/download/v1.17.4-1/bilibili-1.17.4-x86_64.AppImage
# 赋予执行权限
chmod a+x bilibili-1.17.4-x86_64.AppImage
# 创建符号链接到系统路径(可选)
sudo ln -sf $(pwd)/bilibili-1.17.4-x86_64.AppImage /usr/local/bin/bilibili
安装完成后,可以直接在终端输入 bilibili 启动程序,或者双击 AppImage 文件运行。
3.2 Debian 系专用安装
虽然原作者提到这个方法可能有问题,但完整流程如下:
bash复制function install_debian() {
git clone https://gitcode.com/gh_mirrors/bi/bilibili-linux
cd bilibili-linux
sudo bash ./tools/install-linux.sh
sudo rm -f /bin/bilibili
sudo ln -s $(pwd)/bin/bilibili /bin/bilibili
}
3.3 RedHat 系专用安装
对于 Fedora、CentOS 等系统:
bash复制function install_redhat() {
git clone https://gitcode.com/gh_mirrors/bi/bilibili-linux
cd bilibili-linux
sudo bash ./tools/setup-bilibili
sudo rm -f /bin/bilibili
sudo ln -s $(pwd)/bin/bilibili /bin/bilibili
}
4. 使用与配置
4.1 首次运行设置
首次启动时,程序会要求登录 B 站账号。目前支持以下登录方式:
- 扫码登录(推荐)
- 账号密码登录
- 短信验证码登录
登录成功后,界面会显示推荐视频列表,布局与手机客户端类似。
4.2 常用快捷键
方向键:导航Enter:确认/播放视频ESC:返回F:全屏切换空格:播放/暂停M:静音切换
4.3 配置文件位置
程序的配置文件通常存储在:
code复制~/.config/bilibili-linux/
里面包含了用户登录信息、观看历史、设置偏好等数据。
5. 常见问题解决
5.1 无法启动问题
问题现象:双击或命令行执行无反应
解决方案:
- 检查文件权限:
bash复制chmod a+x bilibili-*.AppImage
- 检查 FUSE 支持:
bash复制sudo modprobe fuse
- 尝试直接运行:
bash复制./bilibili-*.AppImage --no-sandbox
5.2 视频播放卡顿
可能原因:
- 网络连接问题
- 硬件加速未启用
- 视频源选择不当
解决方案:
- 检查网络连接
- 尝试更换视频源(在播放设置中)
- 关闭弹幕减轻负载
5.3 登录失败
可能原因:
- 账号密码错误
- 验证码服务不可用
- 网络限制
解决方案:
- 尝试扫码登录
- 检查系统时间是否准确
- 更换网络环境
6. 进阶使用技巧
6.1 命令行参数
程序支持多种命令行参数:
bash复制# 指定配置文件路径
./bilibili --user-data-dir=/path/to/config
# 禁用GPU加速
./bilibili --disable-gpu
# 启用调试模式
./bilibili --enable-logging
6.2 创建桌面快捷方式
为了方便启动,可以创建桌面快捷方式:
bash复制cat > ~/.local/share/applications/bilibili.desktop <<EOF
[Desktop Entry]
Name=Bilibili
Exec=/path/to/bilibili-1.17.4-x86_64.AppImage
Icon=/path/to/bilibili-icon.png
Type=Application
Categories=Network;Video;
EOF
6.3 更新与维护
当有新版本发布时,只需下载新的 AppImage 文件替换旧版本即可。配置文件通常兼容不同版本。
7. 项目贡献与开发
如果你对项目开发感兴趣,可以参与贡献:
- 报告问题:在 GitHub 项目的 Issues 页面提交 bug
- 提交代码:Fork 项目后发起 Pull Request
- 翻译改进:帮助完善多语言支持
项目使用 Electron 框架开发,熟悉前端技术的开发者可以轻松参与。
8. 替代方案比较
除了 bilibili-linux,还有其他几种在 Linux 上访问 B 站的方式:
-
网页版:直接使用浏览器访问 bilibili.com
- 优点:功能最全
- 缺点:占用资源多,体验不如客户端
-
第三方客户端:
- bilimini:轻量级客户端
- electron-bilibili:另一个 Electron 实现
-
Wine 运行 Windows 版:
- 优点:功能完整
- 缺点:性能开销大
相比之下,bilibili-linux 在资源占用、功能完整性和易用性之间取得了很好的平衡。
9. 性能优化建议
-
硬件加速:
在设置中启用硬件解码可以显著降低 CPU 使用率。 -
弹幕设置:
减少同时显示的弹幕数量可以提升性能。 -
视频质量:
根据网络状况选择合适的视频分辨率。 -
内存管理:
定期重启客户端可以释放积累的内存占用。
10. 安全注意事项
-
账号安全:
- 仅从官方 GitHub 仓库下载客户端
- 定期检查授权设备列表
-
系统安全:
- 不要使用 root 身份运行客户端
- 定期检查更新获取安全修复
-
隐私保护:
- 清理观看历史记录
- 使用后及时退出账号
在使用第三方客户端时,这些安全措施尤为重要。