OpenGMB

OpenGMB

OpenGMB 是一款用于管理 Google Business Profiles 的开源软件：评论、帖子、商家资料编辑、审批、效果数据、报告和排名跟踪。本仓库是社区版。你可以在自己的服务器上运行它，使用自己的 API 密钥，并通过一个所有者登录账号管理所需数量的客户和地点。

它使用官方 Google Business Profile API。除非有人批准，否则任何内容都不会上线，所有者可通过一项设置控制审批行为。帖子和商家资料编辑始终需要审批。回复也需要审批，除非所有者启用对 4 星或 5 星评论的自动审批。对 1 至 3 星评论的回复始终需要人工审批。每条回复、帖子和编辑都会先经过规则检查，然后才能由任何人批准。

OpenGMB 由 Synectus 开发，与 Google 无关，也未获 Google 认可。

社区版包含的内容

• 一个所有者登录账号下可管理多个客户和多个地点，并支持地点分组。
• 帖子、评论、评论回复和审批收件箱，并提供在审批前检查文本的防护规则。
• 效果数据、报告和可分享给客户的报告链接。
• 报告支持白标品牌。
• 地理网格和排名跟踪，使用你自己的 DataForSEO 账号。
• AI 草稿和建议，使用你自己的 Anthropic 密钥。没有积分。
• MCP 服务和 API 令牌，因此 Claude 或其他 MCP 客户端可以操作你的商家资料。令牌可以是只读或读写。
• REST API（v1）、Webhook，以及 Zapier 应用的源代码。
• 评论邀请链接和二维码，以及公开的地点页面。
• 双重身份验证登录和审计日志。

没有注册页面、计费或积分系统。首次启动时，你需要在 env 文件中设置所有者的电子邮件和密码。

本仓库不包含的内容

OpenGMB 采用开放核心模式。托管版本 OpenGMB 增加了团队和角色、客户门户、按月积分计划计费、自定义域名和托管服务；在托管服务中，我们负责运行服务器、管理 Google 连接和更新。如果你不想自己运行服务器，请使用该版本。

快速开始

你需要 Docker Engine 24 或更高版本并安装 Compose 插件，构建镜像时约需 4 GB 可用内存；如果要使用 Google 登录，还需要一个公开的 HTTPS 主机名。

cd deploy/selfhost
cp .env.example .env     # fill in the required values; the comments explain each one
docker compose up -d --build

首次启动前，在 .env 中设置 OWNER_EMAIL 和 OWNER_PASSWORD。然后打开 http://localhost:8080（或你的 WEB_URL）并登录。必须启用双重身份验证：应用会在首次登录时要求你注册身份验证器应用，并且只显示一次备用代码，请妥善保存。Google 客户端默认以 mock 模式运行：在 Settings、Google 下，点击 "Use the sample Google account"，即可导入示例地点并在应用中体验各项功能，无需任何 Google 密钥。修改 .env 后，再次运行 docker compose up -d（restart 会保留旧环境）。要正式上线，你需要自行申请 Google 批准你自己的 Google Cloud 项目使用 Business Profile API，这可能需要数天。SETUP.md 介绍了每个步骤。

本仓库包含的内容

路径	内容
apps/web	Next.js 应用
apps/mcp	MCP 服务（Streamable HTTP）
apps/worker	后台任务：评论同步、发布、报告、Pub/Sub 推送
packages/core	身份验证、租户管理、审计日志、操作注册表、Google 客户端、防护规则
packages/db	Drizzle 架构和迁移（Postgres）
deploy/selfhost	自托管部署栈（Docker Compose）：用于运行 OpenGMB
integrations/zapier	Zapier 应用源代码

仓库根目录的 docker-compose.yml 仅用于贡献者的开发 Postgres。它不是自托管部署栈：请运行 deploy/selfhost 中的配置。

内部软件包名称使用 @opengmb/ 前缀。

参与贡献和报告问题

提交拉取请求前，请阅读 CONTRIBUTING.md。如需报告漏洞，请按 SECURITY.md 中的说明私下提交。

许可证

代码基于 MIT 许可证发布。请参阅 LICENSE。第三方声明见 THIRD_PARTY_NOTICES.md。

商标

许可证适用于代码，不适用于 OpenGMB 名称或徽标，它们是 Synectus Private Limited 的商标，因此分支项目需要使用自己的名称和徽标。请参阅 TRADEMARKS.md。