Go 本地开发编排器 ddtcorex/govard

GOVARD：基于 Go 的多功能运行时与开发环境

Govard 是一款专业级本地开发编排器，用 Go 编写。它取代了老旧的 bash 工具链，改用快速的本地二进制文件来管理复杂的容器化环境，主打稳定、速度和开发者体验。

🆚 Govard 的独特之处

| 领域 | Govard 的优势 |
| 核心架构 | 原生 Go 二进制文件，直接调用 Docker SDK 做编排，不再靠 shell 脚本拼接。 |
| 框架智能识别 | 自动发现框架 + 框架专属蓝图 + 自定义技术栈向导。 |
| Magento 深度支持 | 一等公民级的 Magento/OpenMage 工作流（自动接好 env.php/local.xml、表前缀、Varnish/Redis/队列/搜索、专用 php-debug 路由）。 |
| 本地 HTTPS/DNS | 内置 Caddy + dnsmasq + 根 CA 自动信任，覆盖 .test 域名。 |
| 远程安全 | remote/sync 对敏感目标提供保护（禁止写生产、按范围授权、审计日志）。 |
| 部署 | 框架配方驱动一条中立的流水线（deploy），容器沙箱在本地预演，产物模式让 CI 任务无需安装工具链。 |
| 团队可复现性 | govard lock + lock.strict 检测不同机器间的环境漂移。 |
| 恢复工作流 | govard snapshot 在危险操作前快速给本地数据库/媒体文件打检查点。 |

🚀 核心特性

- 一等公民级部署：govard deploy 按框架配方，通过 SSH + rsync 发布一个修订版本，支持原子符号链接切换或原地发布、维护窗口、数据库备份、校验、回滚和续跑——另外还有 govard sandbox，在你本机的容器上预演整条流水线。
- 远程管理（旗舰功能）：命名远程，按范围授权（files,media,db,deploy），灵活认证（keychain、ssh-agent、keyfile），安全同步带 dry-run 预演，还有连通性诊断（govard remote test）。
- 共享 SSH 网关：govard-proxy-sshd 给每个沙箱一个稳定地址（ssh -p 2222 <project>@127.0.0.1，含 sftp），不再用临时端口。
- 基础设施主机访问：Elasticsearch/OpenSearch 走 http://<project>.test:9200，RabbitMQ 管理界面走 http://<project>.test:15672——按项目配置 Caddy 路由，无需额外配置。
- 框架发现：Magento 1/OpenMage、Magento 2、Mage-OS、Laravel、Next.js、Emdash、Drupal、Symfony、Shopware、CakePHP、PrestaShop、WordPress 和 Django，外加交互式自定义框架向导。
- 零配置调试：Xdebug 2 和 3，一键开关，按项目隔离。
- 数据库可观测性：实时查询监控（govard db top），导入/同步进度条，Redis/Valkey 管理。
- 静态分析与性能剖析：govard audit（lint、完整性检查、profiler），会话持久化，支持 diff 和重跑。
- VSCode 集成：govard vscode setup [--global] 在容器内运行 Intelephense、PHPStan、PHPCS、PHPUnit 和 Xdebug。
- 全局服务：开箱即用的 Caddy 代理、Mailpit、PHPMyAdmin、Portainer。
- 团队安全网：快照、漂移检测、1Password（op://）密钥引用、可恢复传输。
- 命令行 + 桌面端：同一套引擎，既有终端二进制，也有 Wails 桌面应用；govard self-update 带校验和验证。

🛠️ 安装

选一个渠道，坚持用下去：

| 渠道 | 命令 | 说明 |
| npm | npm i -g @ddtcorex/govard | Node 20+，仅命令行，任意操作系统 |
| Homebrew | brew install ddtcorex/tap/govard | macOS + Linuxbrew，仅命令行 |
| Docker | docker run ghcr.io/ddtcorex/govard:<version> version | 无需安装；适合 CI |
| CI | uses: ddtcorex/setup-govard@v1 | GitHub Actions，可固定版本 |
| 脚本 | curl -fsSL .../install.sh \| bash | 完整安装器（命令行 + 桌面端，视平台支持情况） |

curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash

安装器会处理系统依赖、启动全局服务、配置 SSL 信任。默认情况下，在 WebKitGTK 6.0 和 GTK 4 可用的 Linux 上（Ubuntu 24.04+、Debian 13+），它还会安装 govard-desktop；传 --cli-only 可显式跳过桌面端，或者在 WebKitGTK 6.0 缺失的环境（Ubuntu 22.04、Debian 12 以及所有非 Linux 平台）让安装器自动回退到仅命令行。带标签的发布版本还提供 .deb/.pkg 安装包，包括单独的 govard-desktop_<version>_linux_<arch>.deb —— 完整选项见发布页和安装指南。不要在同一台机器上混用渠道（/usr/bin 和 /usr/local/bin 下的二进制会冲突）。

主机侧命令无需 Docker 即可运行（govard capabilities 会列出每条命令的要求）；依赖容器的命令会以 3 退出并返回 CAPABILITY_MISSING，而不是中途失败。详情见无需 Docker 运行。

贡献者从源码构建（./install.sh --source -y，需要 Go 1.25+、Node 24+ 以及桌面端所需的 pnpm）；见 CONTRIBUTING.md。

💻 用法

1. 初始化并启动

govard init # scan the project, generate .govard.ymlbash
govard env up # 渲染 compose，启动整套服务（govard up 也可以） govard shell # 进入应用容器

2. 远程主机与同步 bash govard remote add staging --host staging.example.com --user deploy --path /var/www/app govard remote copy-id staging govard remote test staging govard sync --source staging --destination local --full --plan # 先试运行 govard sync --source staging --destination local --full

prod 远程主机默认写保护；文件/媒体同步走可断点续传的 rsync。完整文档：远程主机与同步。

3. 部署 bash govard deploy plan staging # 列出全部任务，不连接任何主机 govard deploy check staging # 预检：连通性、目录结构、权限、php、磁盘 govard deploy staging --yes # 部署本地 HEAD（或 --revision <sha>） govard deploy releases staging # 查看目标主机上有什么 govard deploy rollback staging # 回滚到上一个发布版本

先对着容器演练一遍，或者把构建拆到 CI 里： bash govard sandbox up --profile full --php 8.3 govard deploy --remote sandbox --yes govard sandbox down --purge

- 完整指南：部署
- 实战配置（Luma、Hyvä、主题、模式、webroot）：部署案例

4. 日常运维 bash govard db dump -e staging # 导出 / 导入 / 查询 / top govard debug on # 为当前项目开关 Xdebug govard snapshot create # 高风险升级前打个检查点 govard audit run # 静态分析，会话可持久化 govard tunnel start # 通过 cloudflare 暴露本地（需要装好二进制）

命令参考（快捷方式、别名、全部命令）：CLI 命令。

SSL 与 HTTPS

Govard 通过 Caddy + 本地根 CA 为每个 .test 域名提供 HTTPS，由 dnsmasq 把 .test 解析到回环地址。只需把解析器指向它一次：

| 系统 | 配置 |
| Linux（systemd-resolved） | 在 /etc/systemd/resolved.conf.d/ 下设置 DNS=127.0.0.1 + Domains=~test |
| macOS | echo "nameserver 127.0.0.1" \| sudo tee /etc/resolver/test |

然后 govard svc up 会自动信任根 CA（写入系统证书库，并尽力导入浏览器）。细节与排障：SSL 与域名。

🌍 全局服务

所有项目共享（通过 govard svc）：

| 服务 | URL | 凭据 |
| Mailpit | https://mail.govard.test | 无需认证；SMTP：mail:1025 |
| PHPMyAdmin | https://pma.govard.test | 项目数据库凭据 |
| Portainer | https://portainer.govard.test | admin / AdminGovard123$ |
| Search API | http://<project>.test:9200 | 无需认证（Elasticsearch/OpenSearch） |
| RabbitMQ UI | http://<project>.test:15672 | guest / guest |
| SSH 网关 | ssh -p 2222 <project>@127.0.0.1 | 你加入白名单的密钥（govard gateway allow-key） |

命令行快捷方式：govard open mail|db|portainer。

每个项目的管理面板都用与 Portainer 相同的账号： admin / AdminGovard123$。克隆出来的项目或旧项目实际拿到什么，见应用管理员。

📚 文档

完整文档（自动同步到 GitHub Wiki）：

- 快速上手 - 安装与第一个项目的工作流
- 命令行命令 - 快捷方式、工具、诊断、实用程序
- 配置 - .govard.yml、配置档、远程、蓝图注册表
- 部署 + 案例研究
- 远程与同步 - 设置、流程、审计日志、远程数据库操作
- SSL 与域名 - HTTPS、CA 信任、路由
- 框架 - 支持矩阵与框架说明
- 桌面应用 - 桌面界面与开发模式工作流

🤝 贡献

构建、测试，以及必须走的头脑风暴 → 编写计划 → 执行计划工作流，都在 CONTRIBUTING.md 和 AGENTS.md 里。推送前的快速检查：make test && make build。

📜 许可证

基于 MIT 许可证分发。更多信息见 LICENSE。

由 ddtcorex 用 ❤️ 开发