XBuckle

主题

无界面运行 ​

Serve

大多数人直接打开桌面应用即可。
如果你只想在后台跑本机服务（CI、脚本、常驻），可以用同一份安装包加参数，不必打开窗口。

端口仍以当前项目配置为准；下表是新建未改时的默认值。

默认端口用途
3100HTTP / 应用对接
3101AI（MCP）
5432数据库
6379缓存
1025邮件捕获

怎么选 ​

方式适合谁
双击打开桌面应用绝大多数用户
安装包 --serve已安装、只要后台服务
源码 npm run serve改 XBuckle 本身的贡献者

安装包：只起服务 ​

与 GUI 是同一份应用，加参数即可：

macOS

bash
/Applications/XBuckle.app/Contents/MacOS/XBuckle --serve

或：

bash
open -a XBuckle --args --serve
# 若 open 不传参，用直接执行 Contents/MacOS/XBuckle

也可用环境变量

bash
XBUCKLE_SERVE=1 /Applications/XBuckle.app/Contents/MacOS/XBuckle
# 兼容旧名：XBUCKLE_HEADLESS=1

行为：

  • 不创建窗口；macOS 下隐藏 Dock 图标
  • 仍读写正常的 Electron userData（与 GUI 同一份 handler 状态）
  • Ctrl+C / SIGTERM 退出

生产环境怎么理解「生产」 ​

XBuckle 不是 线上业务后端。这里的「发布后生产」指：

  • 把 XBuckle 分发给开发者 / CI，在他们机器上当本地云
  • 业务生产（Origin 线上）仍走云 Supabase / Workers

推荐拓扑：

text
开发者本机 / CI
  ├─ xbuckle --serve   (或 npm run serve)
  └─ origin frontend → http://127.0.0.1:3100

可用 launchd / systemd / 进程管理器把 XBuckle --serve 做成登录自启，不必开 GUI。

健康检查 ​

bash
curl -sf http://127.0.0.1:3100/health

与 acceptance:server 的区别 ​

  • acceptance:server：给黄金测试用，默认挂 fixtures/functions
  • serve / --serve：给日常开发与发布后无 UI 使用；functions 目录由你设置 XBUCKLE_FUNCTIONS_DIR