HQBase

关于 HQBase

HQBase 为团队提供了一个处理共享邮箱的统一工作空间，同时将应用程序、邮件和 Cloudflare 凭据保存在客户自己的基础设施中。它包含：

• 共享邮箱和团队访问控制。

• 多域名设置、草稿和审计历史。

• 安装、更新、备份和恢复操作。

• 一个受 OAuth 保护的远程 MCP 服务器。

请参阅产品文档了解安装、日常使用、架构和运维操作。

Related MCP server: Gmail MCP Connector

本地开发

启动应用程序

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

在运行可选的种子命令之前，请将以下值添加到 .dev.vars：

• BETTER_AUTH_SECRET

• HQBASE_LOCAL_SEED_PASSWORD，长度为 8 到 128 个字符

种子命令只写入本地 D1，不会联系 Cloudflare OAuth。打开 http://127.0.0.1:5173/ 并使用该密码以 owner@hqbase.test 身份登录。Vite 在 5173 端口提供前端服务并支持热重载，同时将 API 请求代理到 8787 端口的 Wrangler Worker。

要使用首次运行设置流程，请省略种子命令并打开 http://localhost:5173/setup。

重置本地数据

要丢弃所有本地 D1 数据、重建架构并重新创建演示工作区：

pnpm db:reset:local
pnpm db:seed:local

重置命令具有破坏性且仅限本地。它不会更改已部署的数据库。

预览设置界面

用于仅演示的入职工作：

pnpm dev:setup-ui

打开 http://127.0.0.1:5173/__ui/setup。

验证更改

运行完整的本地质量门：

pnpm check
pnpm deploy:dry-run

在更改 wrangler.jsonc 后运行 pnpm cf:typegen。

推送到 main 分支会运行相同的质量门和部署试运行。部署到暂存环境是手动的，并且也在签名发布工作流中运行。发布保持草稿状态，直到之前的稳定版本升级到完全匹配的签名候选版本并通过其检查。客户安装和更新在部署前会验证签名清单和工件摘要。

文档

hqbase.io/docs 是用户和运维指南、产品规范以及维护者流程的公开来源。

贡献

在提交拉取请求之前，请阅读贡献指南。

安全

要报告漏洞，请按照安全策略中的私有流程操作。

许可证

HQBase 在 GNU Affero 通用公共许可证 v3.0 仅限下提供。