当前位置：首页 > news >正文

哔哩哔哩Linux客户端终极指南：如何在Linux上完整体验B站

news 2026/6/7 19:47:17

哔哩哔哩Linux客户端终极指南：如何在Linux上完整体验B站

【免费下载链接】bilibili-linux基于哔哩哔哩官方客户端移植的Linux版本支持漫游项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-linux

哔哩哔哩Linux客户端是一款基于官方客户端移植的开源项目，专为Linux用户打造。它提供了完整的B站功能体验，包括视频播放、弹幕互动、直播观看等核心功能，同时加入了漫游服务和弹幕共享等特色功能，解决了Linux用户无法使用原生B站客户端的痛点。无论你是Ubuntu、Debian、Arch还是其他Linux发行版的用户，现在都可以在Linux系统上享受与Windows和macOS相同的B站体验。

🚀 快速上手：3分钟安装与启动

选择适合你的安装方式

根据你的技术水平和需求，有三种简单的方法可以快速安装哔哩哔哩Linux客户端：

方法一：AppImage一键运行（推荐新手）这是最简单的安装方式，无需编译或配置环境：

# 下载最新的AppImage文件 wget https://gitcode.com/gh_mirrors/bi/bilibili-linux/-/releases/permalink/latest/download/bilibili-linux.AppImage # 赋予执行权限 chmod +x bilibili-linux.AppImage # 启动应用 ./bilibili-linux.AppImage

AppImage文件约200MB，下载后即可直接运行，不会影响系统其他部分。

方法二：源码编译安装（功能最完整）如果你需要最新功能或进行开发，可以从源码编译：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/bi/bilibili-linux.git cd bilibili-linux # 安装依赖（需要Node.js v14+和pnpm） pnpm install # 构建应用程序 pnpm run build # 启动客户端 pnpm start

编译过程大约需要10-20分钟，具体时间取决于你的硬件配置。

方法三：包管理器安装（Arch Linux用户）Arch Linux及其衍生版本可以通过AUR安装：

# 使用yay安装 yay -S bilibili-bin # 或使用paru paru -S bilibili-bin

首次启动与基本设置

安装完成后，首次启动应用时会看到熟悉的B站界面。你可以：

登录账号：使用B站账号登录，同步你的收藏、历史记录和关注列表
界面熟悉：左侧导航栏包含首页、动态、我的等核心功能
检查更新：客户端内置自动更新功能，确保始终使用最新版本

哔哩哔哩Linux客户端播放界面，支持高清视频播放和实时弹幕互动

🎯 深度探索：核心功能详解

完整的视频播放体验

哔哩哔哩Linux客户端提供了与官方客户端完全一致的视频播放功能：

高清播放：支持1080P高清视频播放，流畅不卡顿
弹幕系统：完整的弹幕发送、显示和过滤功能
选集管理：轻松切换多章节视频的不同部分
互动功能：点赞、投币、收藏、分享等互动功能一应俱全
播放控制：支持快捷键操作，提升观看效率

弹幕共享：解决港澳台地区弹幕稀少问题

弹幕共享是项目的特色功能之一，专门解决不同地区弹幕数据隔离的问题。当你在港澳台或东南亚地区观看番剧时，可能会发现弹幕稀少，这个功能可以让你加载其他地区的弹幕数据。

使用步骤：

播放视频时，点击弹幕扩展按钮
在弹出的搜索框中输入动画名称
选择对应的剧集
选择"替换弹幕池"或"追加弹幕池"模式
点击确认加载弹幕

弹幕扩展功能界面，支持搜索动画并选择具体剧集

效果对比：

无弹幕状态：视频播放区域弹幕稀少，观看体验单调
加载弹幕后：弹幕密集，互动氛围浓厚，观看体验显著提升

加载弹幕后的密集弹幕效果，极大提升观看体验

漫游服务：突破区域限制访问

漫游功能允许用户配置自定义代理服务器，突破地区限制访问更多内容：

两种配置模式：

UPOS服务器设置：使用预设的CDN服务器（如网宿wcs）
自定义服务器设置：按地区（大陆、香港、台湾等）配置特定代理

漫游设置界面，支持多种服务器配置方式

配置文件存储在~/.config/bilibili/目录下，高级用户可以直接编辑配置文件实现更精细的控制。

完整的直播生态系统

哔哩哔哩Linux客户端完整移植了官方客户端的直播功能：

实时弹幕互动：与主播和其他观众实时交流
多分类浏览：按颜值、游戏、虚拟主播等分类查找内容
关注管理：轻松管理关注的主播列表
快速开播：支持用户一键开启直播

直播界面，支持分类浏览和关注主播管理

⚙️ 高级应用：优化配置与问题解决

性能优化与故障排除

某些Linux发行版可能会遇到GPU兼容性问题。如果遇到界面异常或性能问题，可以尝试以下解决方案：

禁用GPU硬件加速：

# 创建配置文件目录 mkdir -p ~/.config/bilibili # 创建配置文件 echo "--disable-gpu" > ~/.config/bilibili/bilibili-flags.conf echo "--disable-gpu-compositing" >> ~/.config/bilibili/bilibili-flags.conf

内存占用过高问题：

定期重启应用释放内存
在配置文件中添加内存限制参数
关闭不必要的标签页和后台进程

开发者工具与调试

对于开发者或需要调试的用户，项目提供了完整的调试支持：

登录界面调试：右键点击登录界面内层打开开发者工具
主界面调试：按下F12键打开开发者工具
源码调试：所有TypeScript源码位于src/目录，支持断点调试

多语言支持与界面定制

项目支持多语言界面切换：

在主页点击右下角设置按钮
进入"其它设定"选项
在"语言设定"区域选择目标语言

语言配置文件位于src/extension/common/translation/en.ts，支持自定义翻译和本地化。

系统兼容性与架构支持

哔哩哔哩Linux客户端支持多种Linux发行版和架构：

发行版	架构支持	安装方式
Ubuntu/Debian	x86_64, arm64	AppImage或源码编译
Arch Linux	x86_64, arm64	AUR包管理器
Fedora/RHEL	x86_64, arm64	AppImage
龙芯架构	loongarch64/loong64	源码编译

龙芯架构特别支持：

AOSC OS：loongarch64
Debian：旧世界loongarch64，新世界loong64
Gentoo：loong
Loong Arch Linux：loong64

常见问题快速解决

Q: 应用无法启动怎么办？A: 检查Node.js版本，确保使用v14.0.0+版本。如果遇到问题，可以尝试：

# 清理缓存重新安装 rm -rf node_modules pnpm cache clean pnpm install

Q: 视频无法播放怎么办？A: 检查网络连接和漫游设置。确保代理配置正确，网络连接正常。

Q: 弹幕不显示怎么办？A: 尝试切换弹幕共享服务器，或检查网络连接。也可以参考弹幕共享文档进行排查。

Q: 如何更新客户端？A: 对于源码安装用户：

cd bilibili-linux git pull origin main pnpm install pnpm run build

对于AppImage用户，只需下载最新版本的AppImage文件替换即可。

📁 项目结构与技术实现

了解项目结构有助于更好地使用和定制客户端：

bilibili-linux/ ├── src/ # 源代码目录 │ ├── extension/ # 扩展功能模块 │ │ ├── common/ # 通用功能（弹幕、API等） │ │ ├── page/ # 页面逻辑 │ │ └── ui/ # 用户界面组件 │ └── inject/ # 注入脚本 ├── res/ # 资源文件 │ ├── screenshots/ # 截图展示 │ └── icons/ # 图标资源 ├── docs/ # 文档目录 │ ├── help/ # 帮助文档 │ └── imgs/ # 文档图片 └── tools/ # 构建工具

技术栈概览：