Linux B站客户端终极指南：从零安装到高级配置的完整教程
项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-linux 相关服务：泰国站群服务器
bilibili-linux是一款专为Linux系统打造的开源视频工具，为Linux用户提供原生的哔哩哔哩客户端体验。这款Linux视频客户端基于官方客户端移植开发，支持视频播放、直播观看、弹幕系统等核心功能，特别针对Linux系统特性进行了优化，同时提供网络漫游功能帮助用户突破区域限制访问更多内容。无论你是Ubuntu、Arch Linux还是其他Linux发行版的用户，都能通过本指南轻松掌握这款开源视频工具的使用方法。
📦 选择最适合你的安装方式
Ubuntu一键安装步骤
对于Ubuntu/Debian用户，最简便的安装方法是使用预编译的deb包。首先确保系统已更新到最新状态：
sudo apt update
sudo apt upgrade -y
然后从项目仓库下载最新版本的deb包并安装：
# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/bi/bilibili-linux
# 进入项目目录
cd bilibili-linux
# 安装依赖并构建
pnpm install
pnpm run build
# 打包为deb安装包
pnpm run pkg-linux
构建完成后，你会在dist目录中找到生成的deb安装包，双击即可安装，或者在终端中使用：
sudo dpkg -i bilibili-linux_*.deb
Arch Linux最快配置方法
Arch Linux用户可以通过AUR仓库快速安装：
# 使用yay或paru安装
yay -S bilibili-bin
# 或者手动构建
git clone https://aur.archlinux.org/bilibili-bin.git
cd bilibili-bin
makepkg -si
对于追求最新功能的用户，建议从源码编译安装：
# 安装基础依赖
sudo pacman -S nodejs npm git
# 克隆源码
git clone https://gitcode.com/gh_mirrors/bi/bilibili-linux
cd bilibili-linux
# 安装pnpm包管理器
npm install -g pnpm
# 安装项目依赖并构建
pnpm install
pnpm run build
不同发行版安装方式对比
| 发行版 | 推荐安装方式 | 难度等级 | 更新频率 |
|---|---|---|---|
| Ubuntu/Debian | 源码编译或deb包 | ⭐⭐ | 高 |
| Arch Linux | AUR包或源码编译 | ⭐⭐ | 最高 |
| Fedora | 源码编译 | ⭐⭐⭐ | 中 |
| openSUSE | 源码编译 | ⭐⭐⭐ | 中 |
| CentOS | 源码编译 | ⭐⭐⭐⭐ | 低 |
💡 小贴士：对于新手用户，建议使用预编译包安装；对于开发者和技术爱好者，源码编译能获得最新功能和更好的自定义选项。
🎯 核心功能深度体验
简洁美观的主界面设计
启动bilibili-linux后，你会看到一个简洁美观的主界面。左侧是功能导航栏，包含首页、动态、我的等核心入口，顶部是分类标签栏，支持快速切换推荐、热门、直播等内容分类。
主界面采用卡片式设计，每个视频卡片都清晰展示封面图、播放量、弹幕数、时长和UP主信息。推荐算法会根据你的观看习惯智能推荐内容，让你轻松发现感兴趣的视频。
强大的视频播放体验
点击任意视频进入播放界面，你会体验到完整的B站播放功能：
播放器支持多种清晰度选择，从360P到1080P满足不同网络环境需求。右侧面板显示视频详细信息，包括标题、UP主、播放数据、点赞投币收藏等互动功能，以及选集管理。
播放控制快捷键速查表：
- 空格键：播放/暂停
- 方向键←→：快退/快进5秒
- 方向键↑↓：音量调节
- F11：全屏切换
- Ctrl+D：弹幕开关
- 数字键1-9：跳转到视频10%-90%位置
实时直播互动功能
对于喜欢观看直播的用户，bilibili-linux提供了完整的直播体验：
直播界面左侧显示你关注的主播列表，中间是直播分类标签，右侧是直播内容卡片。每个直播卡片都实时显示在线人数，让你了解直播热度。进入直播间后，你可以发送弹幕与主播互动，支持多种画质选择确保流畅观看。
智能弹幕系统
bilibili-linux的弹幕系统是其亮点功能之一，支持B站官方弹幕和第三方弹弹Play弹幕源：
弹幕功能特色：
- 多源支持：可以同时使用B站官方弹幕和弹弹Play弹幕
- 智能匹配：通过关键词搜索自动匹配视频对应的弹幕资源
- 样式自定义：支持调整字体大小、透明度、显示区域和滚动速度
- 弹幕池管理：可选择替换或追加弹幕池，灵活控制弹幕数量
要启用弹弹Play弹幕，只需在播放界面点击"弹幕Ext"按钮，搜索视频关键词，选择匹配的弹幕集即可。
🔧 高级配置与优化技巧
网络漫游功能配置
bilibili-linux内置了强大的网络漫游功能，帮助用户突破区域限制访问更多内容：
配置步骤：
- 点击左侧导航栏的"设置"图标
- 选择"漫游"标签页
- 配置upos服务器（推荐选择"wcs（网宿）"）
- 根据需要设置PAC代理地址
- 在自定义服务器区域按地区填写服务器地址
- 点击"保存"按钮应用设置
常用服务器地址参考：
- 大陆：api.qiu.moe
- 香港：可留空使用默认
- 台湾：可留空使用默认
- 泰国/东南亚：可留空使用默认
性能优化设置
如果你的电脑配置较低或遇到播放卡顿问题，可以尝试以下优化：
# 创建配置文件目录
mkdir -p ~/.config/bilibili
# 创建性能优化配置文件
echo "--disable-gpu" > ~/.config/bilibili/bilibili-flags.conf
echo "--disable-software-rasterizer" >> ~/.config/bilibili/bilibili-flags.conf
性能优化建议：
- 降低画质：在网络状况不佳时选择"流畅"或"标清"画质
- 关闭弹幕：大量弹幕会消耗GPU资源，关闭可提升性能
- 禁用硬件加速：在设置中勾选"禁用GPU加速"选项
- 清理缓存：定期清理客户端缓存文件
开发者工具开启
bilibili-linux支持开发者工具，方便开发者调试和扩展：
- 登录界面开启：在登录界面右键点击打开开发者工具
- 主界面开启：按下F12键（如果没反应，需要先在登录界面开启一次）
- 命令行启动：添加
--remote-debugging-port=9222参数启动
🛠️ 常见问题解决方案
启动失败问题排查
如果客户端无法启动，可以按以下步骤排查：
# 1. 检查依赖是否完整
ldd bin/bilibili | grep "not found"
# 2. 查看错误日志
journalctl -xe | grep bilibili
# 3. 清理配置文件重新启动
rm -rf ~/.config/bilibili/
常见启动问题：
- 依赖缺失：安装libgconf-2-4、libnss3、libatk-bridge2.0-0等库
- 权限问题：确保对安装目录有读写权限
- 配置文件损坏：删除~/.config/bilibili/目录重新启动
视频播放问题处理
遇到视频无法播放或卡顿的情况：
- 检查网络连接：确保网络通畅，尝试切换网络环境
- 更换服务器：在漫游设置中更换upos服务器
- 更新客户端：检查是否有新版本可用
- 清除缓存：删除缓存文件重新加载
更新与维护
bilibili-linux支持自动更新功能：
更新方式：
- 自动更新：在设置中开启"自动更新"选项
- 手动检查：点击"检查更新"按钮
- 命令行更新：重新运行安装脚本或重新构建
版本信息：当前最新版本为1.17.6.4728，基于Electron 37.3.1构建，支持x64和arm64架构。
🚀 进阶功能探索
空降助手功能
bilibili-linux内置了空降助手功能，可以自动识别视频中的关键位置并快速跳转。要使用此功能，你需要：
-
安装Python3和必要的模块：
pip3 install faster_whisper torch -
在设置中配置AI识别TOKEN（可从bigmodel.cn获取免费Token）
-
启用空降助手后，观看视频时会自动识别关键时间点
多语言支持
客户端支持多种语言切换：
- 点击主页右下角的设置按钮
- 进入"其它设定"
- 在"语言设定"区域选择你需要的语言
支持的语言包括简体中文、繁体中文和英文，满足不同地区用户的需求。
快捷键大全
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 播放控制 | 空格键 | 播放/暂停切换 |
| 音量调节 | ↑↓方向键 | 增加/减少音量 |
| 进度控制 | ←→方向键 | 快退/快进5秒 |
| 全屏模式 | F11 | 切换全屏显示 |
| 弹幕开关 | Ctrl+D | 显示/隐藏弹幕 |
| 画质切换 | Ctrl+1-5 | 快速切换不同清晰度 |
| 播放速度 | Ctrl+[或] | 降低/提高播放速度 |
| 视频截图 | Ctrl+S | 保存当前画面 |
| 静音切换 | M键 | 快速静音/取消静音 |
📚 项目资源与文档
官方文档参考
bilibili-linux项目提供了丰富的文档资源，帮助你更好地使用和开发：
- 弹幕共享文档：docs/help/弹幕共享.MD
- AI转录文档：docs/AiTranscribe.MD
- 区域限制说明：docs/区域限制.MD
- 自定义托盘菜单：docs/自定义托盘菜单.MD
开发资源
如果你是开发者，可以探索以下资源：
- 源码目录：src/ 包含所有TypeScript源代码
- 工具脚本：tools/ 包含构建和调试工具
- 资源文件：res/ 包含图标、截图和配置文件
- 扩展功能：public/extension/ 包含浏览器扩展相关文件
社区支持
项目在GitCode上活跃维护，遇到问题可以：
- 查看Issues页面寻找解决方案
- 提交新的Issue报告问题
- 参与讨论和功能建议
🎉 开始你的Linux B站之旅
通过本指南，你已经全面掌握了bilibili-linux这款开源视频工具的安装、配置和高级使用技巧。无论你是想在Linux系统上观看B站视频、参与直播互动，还是需要突破区域限制访问更多内容，这款Linux B站客户端都能满足你的需求。
最后的小建议：
- 定期更新客户端以获得新功能和性能改进
- 根据网络状况灵活调整画质设置
- 善用快捷键提升操作效率
- 探索弹幕扩展功能获得更好的观看体验
现在就开始你的Linux B站之旅吧！如果在使用过程中遇到任何问题，记得参考本文的故障排除部分，或查看项目文档获取更多帮助。祝你观影愉快！
项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-linux 
