Beekeeper Studio 跨平台安装指南Windows、macOS 与 Linux 全系安装方式详解【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studioBeekeeper Studio 是一款面向 MySQL、Postgres、SQLite、SQL Server 等多种数据库的现代化 SQL 客户端官方文档将其定位为易于使用的 SQL 查询编辑器与数据库界面。本文基于仓库中 docs/installation/index.es.md 及其配套的 Windows、macOS、Linux 分平台指南系统梳理在三大操作系统上安装 Beekeeper Studio 的全部官方途径包括各安装包格式的前提条件、命令行操作、架构选择与常见坑点。读完本文你将能为 Windows、macOSIntel 与 Apple Silicon以及主流 Linux 发行版选择并完成最合适的安装方案并掌握 Wayland、Snap 沙箱、SSH 隧道访问等进阶配置技巧。一、安装概览支持哪些平台与架构Beekeeper Studio 官方支持 Windows、Linux 与 macOS 三大桌面操作系统覆盖绝大多数开发者环境。在架构方面各平台的支持情况并不完全一致平台支持架构官方推荐的安装方式Windows仅x86_64ARM64 支持计划在后续版本提供NSIS 安装包 / 便携版macOSIntel 与 Apple SiliconM1/M2/M3 等DMG 安装包Linuxx86-64与ARM64如 Raspberry PiAppImage官方推荐从仓库的打包配置可以验证上述发行矩阵在 electron-builder-config.js 中Linux 目标包含snap、deb、appImage、rpm、flatpak、pacman六种格式Windows 目标为nsis与portablemacOS 则通过 DMG 交付——这与文档中的安装途径一一对应。分平台的详细安装指南可分别参考Windows 安装指南西班牙语版macOS 安装指南Intel 与 Apple Silicon西班牙语版Linux 安装指南西班牙语版二、Windows下载即装与便携版2.1 安装版下载并运行Windows 用户只需从 Beekeeper Studio 官网下载安装程序并运行即可完成安装。当前版本仅支持x86_64架构官方明确表示 ARM64 支持将在未来版本中提供。在打包层面Windows 使用 electron-builder 的 NSIS 安装器配置见 electron-builder-config.js 中的win段win: { icon: ./public/icons/png/512x512.png, target: [nsis, portable], publish: [github], ... }其中nsis对应标准安装包portable对应便携版两个目标会在发布时一并生成。NSIS 安装器采用oneClick: false配置即提供引导式安装界面而非一键静默安装。2.2 便携版免安装直接运行官方还提供便携版Portable Version无需安装即可直接运行适合不希望向系统写入安装文件、或者需要在受限环境中使用的场景。从打包配置看便携版的产物命名为${productName}-${version}-portable.exe同样基于 x86_64 架构发布。三、macOSDMG 安装与架构选择3.1 安装步骤macOS 的安装流程很直接从官网下载.dmg安装文件打开 DMG将 Beekeeper Studio 应用拖入应用程序文件夹首次启动时如果系统拦截进入系统设置 - 隐私与安全性启用App Store 与已识别的开发者允许安装第三方分发的应用。3.2 Intel 与 Apple Silicon 的选择macOS 安装包同时提供 Intel 与 Apple Silicon 两种版本下载时应选择与机器架构匹配的安装包否则在 Apple Silicon 上会通过 Rosetta 2 转译运行性能与兼容性都会打折扣。需要特别注意的例外是Oracle DatabaseOracle 官方库与包目前不提供 Apple Silicon 版本。因此如果你需要连接 Oracle 数据库官方建议安装 Intel 版 Beekeeper Studio并在 Rosetta 2 下运行。仓库中oracledb依赖见 apps/studio/package.json也印证了这一限制的现实性。从打包配置看macOS 包启用了hardenedRuntime: true与notarize: true即开启 Apple 的运行时加固与公证流程确保在启用 Gatekeeper 的系统上也能顺利运行。四、Linux六种安装方式全解析Linux 是 Beekeeper Studio 支持最丰富的平台官方提供 AppImage、DEB、RPM、Arch/Pacman、Flatpak、Snap 六种安装途径且 x86-64 与 ARM64如 Raspberry Pi均有对应构建。官方推荐使用 AppImage理由是其在各发行版之间提供最一致的体验。4.1 AppImage免安装、自带更新AppImage 可以在大多数 Linux 发行版上直接下载运行无需任何安装步骤特别适合没有 root 权限但仍想使用 Beekeeper Studio 的用户。其最大优势是内置自动更新能力。Ubuntu 前提条件FUSE 库AppImage 依赖 FUSE 才能挂载运行Ubuntu 用户需要按版本安装对应库Ubuntu 22.04sudo apt-get install fuse libfuse2Ubuntu 22.04sudo apt install libfuse2从源码看自动更新能力由 apps/studio/src/background/update_manager.ts 中的electron-updater驱动。该模块对 AppImage 做了专门处理当检测到通过 AppImageLauncher 运行时platformInfo.isAppImageLauncher会把$APPIMAGE环境变量重写为实际路径避免自动更新时找不到文件。应用菜单集成如果希望 AppImage 出现在系统应用菜单中官方推荐安装 AppImageLauncher 工具它可以自动将 AppImage 注册到 shell 中。4.2 DEBDebian / Ubuntu 官方仓库为 Debian 与 Ubuntu 22.04 提供软件仓库DEB 构建同时覆盖 x86_64 与 ARM64。有两种接入方式方式一配置官方 APT 仓库推荐便于持续更新# 安装 GPG 密钥 curl -fsSL https://deb.beekeeperstudio.io/beekeeper.key | sudo gpg --dearmor --output /usr/share/keyrings/beekeeper.gpg \ sudo chmod gor /usr/share/keyrings/beekeeper.gpg \ echo deb [signed-by/usr/share/keyrings/beekeeper.gpg] https://deb.beekeeperstudio.io stable main \ | sudo tee /etc/apt/sources.list.d/beekeeper-studio-app.list /dev/null # 更新 apt 并安装 sudo apt update sudo apt install beekeeper-studio -y方式二直接下载 DEB 文件从最新 Release 下载.deb文件安装安装过程会自动注册软件仓库方便后续更新。仓库中 DEB 包的运行时依赖在 electron-builder-config.js 的deb.depends中列出包括libgtk-3-0、libnotify4、libnss3、libxss1、libxtst6、xdg-utils、libatspi2.0-0、libuuid1、libsecret-1-0、gnupg等若系统缺少这些库安装时会被自动处理。4.3 RPMFedora / RHEL 系RPM 构建同样提供 x86_64 与 ARM64 版本通过配置 YUM/DNF 仓库安装# 下载 .repo 文件用于管理软件更新 sudo curl -o /etc/yum.repos.d/beekeeper-studio.repo https://rpm.beekeeperstudio.io/beekeeper-studio.repo # 导入 GPG 公钥 sudo rpm --import https://rpm.beekeeperstudio.io/beekeeper.key # 验证仓库配置是否正确 dnf repolist # 安装 sudo dnf install beekeeper-studio # 或旧系统 sudo yum install beekeeper-studio4.4 Arch Linux 与衍生发行版Arch 用户可以通过pacman -U安装本地打包的 Pacman 包x86_64 与 ARM64 均有从最新 Release 下载即可。此外官方还维护了两个 AUR 包beekeeper-studio-appimageAppImage 封装beekeeper-studio-bin预编译二进制封装可用 AUR 助手安装paru -S beekeeper-studio-appimage # 或 paru -S beekeeper-studio-binpacman打包目标在仓库中配置了完整的运行时依赖见 electron-builder-config.js 的pacman.dependsc-ares、ffmpeg、gtk3、llhttp、libevent、libvpx、libxslt、libxss、minizip、nss、re2、snappy、libnotify、libappindicator-gtk3。4.5 FlatpakFlatpak.flatpak文件针对 x86_64 与 ARM64 分别提供可从最新 Release 下载。官方提示 Flathub 集成即将到来。注意沙箱文件访问限制Flatpak 默认对文件访问进行沙箱隔离。如果需要打开沙箱之外的 SQLite 数据库需要授予文件系统访问权限sudo flatpak override io.beekeeperstudio.Studio --filesystemhost关于这一问题的更多细节可参考 故障排查文档中的permission denied / unable to open database file一节。该文档说明问题通常源于 Snap 或 Flatpak 沙箱没有访问文件位置的权限——Flatpak 的文件选择器可能显示沙箱化路径如/run/user/1000/...而非真实路径上述命令即可解决。从打包配置看Flatpak 构建基于org.freedesktop.Platform23.08 运行时与org.electronjs.Electron2.BaseApp基础应用并声明了网络、X11、Wayland、GPUDRI、PulseAudio、主目录文件系统等沙箱权限finishArgs可对照理解沙箱的能力边界。4.6 Snap一行命令安装但需了解限制Snap 可通过 Snapcraft同时也是 Ubuntu Store 的一部分安装sudo snap install beekeeper-studiosnap在 Ubuntu 16.04 上预装Fedora 与 Arch 可自行安装 snapd 后使用。⚠️ 重要限制部分功能在 Snap 版中不可用由于 Snap 包的安全模型严格沙箱部分功能无法在 Snap 版中工作主要包括SSH 隧道访问 .ssh 目录需要手动授权才能读取~/.sshsudo snap connect beekeeper-studio:ssh-keys :ssh-keysSSH Agent 不可用Snap 无法访问系统的 SSH Agent。如果你依赖 SSH Agent官方建议改用deb或AppImage版本。这一限制在仓库打包配置中有直接对应Snap 构建snapcraft段使用core24base并在plugs中显式声明了ssh-keys、removable-media、mount-observe、browser-support等接口——其中ssh-keys正是需要用户手动snap connect的接口。同时代码层面 apps/studio/src/background/update_manager.ts 也会检测platformInfo.isSnap并跳过自动更新也就是说Snap 版本不提供应用内自动更新这一点与 AppImage 形成鲜明对比。已知问题字体渲染异常在较新的 Gnome 版本下Snap 版 Beekeeper Studio 存在字体渲染问题主要在文件选择界面可见如截图所示。官方建议遇到此问题时改用 AppImage 版本。4.7 Linux 通用进阶Wayland 原生支持Beekeeper Studio 完全支持 Wayland官方在 Gnome 上验证包括小数缩放fractional scaling。但在默认情况下Wayland 原生模式并未启用原因是 Nvidia 驱动与 Wayland 渲染器存在兼容性问题。如果你在使用 Wayland 小数缩放时遇到界面模糊的问题可以通过以下方式启用 Wayland 原生模式# 1. 创建配置文件 touch ~/.config/bks-flags.conf # 2. 追加启用 Wayland 的 flags echo --ozone-platform-hintauto ~/.config/bks-flags.conf echo --enable-featuresUseOzonePlatform ~/.config/bks-flags.confbks-flags.conf是 Beekeeper Studio 专用的 Chromium/Electron 启动参数文件这一思路借鉴了 VSCode 官方 AUR 包visual-studio-code-bin中code-flags的实现修改后重启应用生效。Wayland 下颜色异常的处理如果 Wayland 下出现颜色不正确的问题例如橙色偏黄、灰色近乎黑色、白色过亮、文字可读性差这是 Chromium/Electron 的 Wayland 颜色管理协议 bug 所致。修复方法是在同一配置文件中追加echo --disable-featuresWaylandWpColorManagerV1 ~/.config/bks-flags.conf然后重启 Beekeeper Studio 使配置生效。五、安装方式对比与选型建议安装方式适用平台自动更新是否需 root注意事项AppImage所有主流 Linux 发行版✅否需 libfuse2Ubuntu官方推荐DEB 仓库Debian / Ubuntu 22.04✅是覆盖 x86_64 / ARM64RPM 仓库Fedora / RHEL 系✅是覆盖 x86_64 / ARM64Pacman / AURArch 及衍生版视包而定是官方维护 AUR 包FlatpakLinux视渠道而定是沙箱需授权文件系统访问SnapUbuntu 16.04 等❌无应用内更新是SSH Agent 不可用部分功能受限NSIS 安装包Windows x86_64✅是引导式安装便携版Windows x86_64手动更新否免安装DMGmacOS Intel / Apple Silicon✅否Oracle 连接需 Intel 版 Rosetta 2结合官方文档与源码给出如下选型建议Linux 用户优先选 AppImage官方明确推荐跨发行版体验最一致且唯一同时具备免 root、自带自动更新双重优势需要 SSH Agent 或完整 SSH 隧道能力时避开 Snap改用deb或 AppImage连接 Oracle 数据库的 macOS 用户安装 Intel 版并通过 Rosetta 2 运行受限环境无 root / 便携需求Windows 便携版、Linux AppImage 是最轻量的选择。六、安装后验证与延伸阅读安装完成后可以通过仓库中的端到端测试了解应用的关键功能验证路径例如 appLaunch.test.ts 验证应用启动、newConnection.test.ts 覆盖新建数据库连接流程它们可以帮助你在新装好的环境中快速确认各项能力是否正常。如需进一步了解 Beekeeper Studio 支持的数据类型、连接配置与日常使用可继续阅读仓库文档支持的数据库列表连接指南配置说明故障排查手册【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考