桌面版
基于 MyGo 构建的 OpenBee 原生应用,支持 macOS、Windows 和 Linux。标准版内置 OpenBee 服务端,一台电脑上装它就够了。
用包管理器安装,或从 GitHub Releases 下载对应平台的文件。
| 平台 | 包管理器 | 发布文件 |
|---|---|---|
| macOS,M 系列芯片 | brew install --cask theopenbee/tap/openbee-desktop |
openbee-desktop-<version>-darwin-arm64.dmg 或 .zip |
| macOS,Intel 芯片 | 同上 | openbee-desktop-<version>-darwin-amd64.dmg 或 .zip |
| Windows | scoop bucket add theopenbee https://github.com/theopenbee/scoop-bucketscoop install theopenbee/openbee-desktop |
openbee-desktop-<version>-windows-<arch>-setup.exe |
| Linux | — | openbee-desktop-<version>-linux-<arch>.deb 或 .tar.gz |
发布包暂未做代码签名,系统会要求你手动放行一次:
- macOS: 右键点击应用,选择“打开”。macOS 15 及以上请在“系统设置 → 隐私与安全性”中点击“仍要打开”。也可以运行
xattr -dr com.apple.quarantine /Applications/OpenBee.app。 - Windows: SmartScreen 提示“Windows 已保护你的电脑”时,点击“更多信息”,再点击“仍要运行”。
然后创建管理员账号,之后打开会自动登录。
- 它使用
~/.openbee/config.yaml在http://localhost:19876启动,与openbee server用的是同一套文件。这个地址同样可以打开 Web 控制台。 - 应用运行时它一直运行,退出应用后停止。在 macOS 和 Windows 上关闭窗口,应用仍留在菜单栏或托盘;在 Linux 上关闭窗口即退出。
- 如果该端口上已有 OpenBee 服务在运行,应用会直接使用它,不再自己启动。
- 日志在 macOS 上位于
~/Library/Logs/OpenBee/server.log,其他平台位于应用数据目录的logs文件夹。
应用启动 10 秒后会检查 GitHub Releases 有没有新版本,之后每天检查一次。有新版本时会显示更新说明,可以选择安装、稍后提醒或跳过这个版本。勾选“以后自动下载并安装更新”后就不再询问。检查更新… 会立即检查:macOS 上在应用菜单里,Windows 和 Linux 上在“文件”菜单里。
更新在后台下载,重启应用后生效。使用内置服务端时,重启应用也会重启服务端。
只有通过发布页安装包或 Homebrew 安装的应用会自动更新。通过 Scoop、.deb 安装的应用,以及单文件版 openbee-desktop-<version>-windows-<arch>.exe,需要下载新版本来更新。
连接其他服务端
Section titled “连接其他服务端”要连接远程服务端,在应用菜单中选择 更换服务器。
如果完全用不到内置服务端,发布页还提供纯客户端版 openbee-desktop-client-<version>-…。Homebrew 和 Scoop 安装的始终是内置服务端的版本。
先安装 jq,Go 1.27 会自动下载。
make desktop # 当前平台,内置服务端,产物在 desktop/build/make desktop-all # macOS、Windows 和 Linux,内置服务端make desktop-client # 当前平台,纯客户端make desktop-client-all # macOS、Windows 和 Linux,纯客户端make desktop 和 make desktop-all 会先用 pnpm 构建 Web 界面,因为服务端内嵌了它。