如何在Linux系统上安装哔哩哔哩客户端：完整指南 🚀

哔哩哔哩Linux版是基于官方客户端移植的开源项目，专为Linux用户打造，支持漫游、弹幕共享和自定义托盘菜单等特色功能。通过简洁的安装步骤，你可以快速在Linux系统上体验完整的B站服务。

📋 准备工作：安装前的必要依赖

在开始安装前，请确保系统已安装以下工具：

• Git：用于克隆项目代码
• Node.js：运行JavaScript环境
• pnpm：高效的包管理工具

🔧 一键安装步骤：从克隆到启动

步骤1：克隆项目代码

git clone https://gitcode.com/gh_mirrors/bi/bilibili-linux.git
cd bilibili-linux

步骤2：安装项目依赖

pnpm install

步骤3：构建并启动应用

pnpm run build && pnpm start

💻 AppImage快速运行方案

对于追求便捷的用户，推荐使用AppImage格式：

1. 下载最新版本（访问项目发布页获取链接）
2. 赋予执行权限：

   chmod +x bilibili-linux-x86_64.AppImage
   

3. 双击或终端运行即可启动

⚙️ 个性化配置指南

基础设置入口

应用启动后，通过顶部菜单栏进入「设置」面板，可配置：

• 播放画质与缓存路径
• 弹幕显示速度与透明度
• 托盘图标样式（支持深色/浅色模式）

图：设置面板提供丰富的个性化选项

高级配置文件

自定义配置文件路径：~/config/bilibili/bilibili-flags.conf
示例配置：

--disable-gpu-acceleration
--roaming-server=auto

✨ 特色功能体验

1. 无缝漫游服务

通过「区域限制」功能（docs/区域限制.MD），一键切换访问地区内容，突破地域限制。

图：漫游设置让你畅享多区域内容

2. 增强弹幕系统

支持弹幕共享和自定义样式，相关实现代码位于：src/extension/common/danmaku.ts

3. 直播与播放体验

专为Linux优化的视频渲染引擎，支持1080P+高清播放和画中画模式。

图：高清视频播放界面

📚 官方文档与资源

• 完整使用指南：docs/
• 自定义托盘菜单：docs/自定义托盘菜单.MD
• 开发贡献指南：CONTRIBUTING.md（如有）

❓ 常见问题解决

启动失败怎么办？

1. 检查Node.js版本（需v14+）
2. 清除依赖缓存：pnpm cache clean
3. 查看日志文件：~/.config/bilibili/logs/main.log

弹幕不显示？

确认已开启「弹幕显示」选项，并检查网络连接。高级设置可调整弹幕API接口：src/extension/common/dandan-api.ts

🎉 结语

哔哩哔哩Linux版为开源社区提供了高效、稳定的B站体验方案。无论是日常追番、观看直播还是学习教程，这款客户端都能满足你的需求。立即按照上述步骤安装，开启Linux平台的B站之旅吧！

如果遇到问题，欢迎通过项目Issue区反馈，或查阅docs/help/目录下的帮助文档获取支持。