Go 本地开发编排器ddtcorex/govard

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

Go Version
License
Releases
Release downloads
CI Pipeline

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）、带试运行规划的安全同步，以及连接诊断（govard remote test）。
- 共享 SSH 网关：govard-proxy-sshd 为每个沙箱提供稳定地址（ssh -p 2222 @127.0.0.1，包含 sftp），而非临时端口。
- 基础设施主机访问：Elasticsearch/OpenSearch 位于 http://.test:9200，RabbitMQ 管理界面位于 http://.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），支持持久化会话、差异对比和重新运行。
- VSCode 集成：govard vscode setup [--global] 在容器内运行 Intelephense、PHPStan、PHPCS、PHPUnit 和 Xdebug。
- 全局服务：开箱即用的 Caddy 代理、Mailpit、PHPMyAdmin、Portainer。
- 团队安全网：快照、漂移检测、1Password（op://）密钥引用、可恢复传输。
- CLI + 桌面端：终端二进制文件和 Wails 桌面应用使用同一引擎；govard self-update 带校验和验证。

🛠️ 安装

选择一个渠道并坚持使用：

| 渠道 | 命令 | 说明 |
|---|---|---|
| npm | npm i -g @ddtcorex/govard | Node 20+，仅 CLI，支持任何操作系统 |
| Homebrew | brew install ddtcorex/tap/govard | macOS + Linuxbrew，仅 CLI |
| Docker | docker run ghcr.io/ddtcorex/govard: version | 无需安装；对 CI 友好 |
| CI | uses: ddtcorex/setup-govard@v1 | GitHub Actions，可固定版本 |
| 脚本 | curl -fsSL .../install.sh \| bash | 完整安装程序（在支持的地方安装 CLI + 桌面端） |

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

安装程序会处理系统依赖、启动全局服务并配置 SSL 信任。默认情况下，在 WebKitGTK 4.1 可用的地方（Ubuntu 22.04+），它还会安装 govard-desktop；传入 --cli-only 可显式跳过桌面端，或者在缺少 WebKitGTK 4.1 的地方让安装程序自动回退到仅 CLI。带标签的发布版本还会附带 .deb/.pkg 安装程序，包括单独的 govard-desktop__linux_.deb —— 完整选项请参阅发布页面和安装指南。不要在同一台机器上混用渠道（/usr/bin 和 /usr/local/bin 中的二进制文件会冲突）。

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

贡献者从源码构建（./install.sh --source -y，需要 Go 1.25+、Node 20+）—— 请参阅 CONTRIBUTING.md。

💻 用法

1. 初始化并启动

govard init          # 扫描项目，生成 .govard.yml
govard env up        # 渲染 compose，启动技术栈（govard up 也可以）
govard shell         # 进入应用容器
2. 远程与同步

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. 部署

govard deploy plan staging     # 整个任务列表，不连接任何地方
govard deploy check staging    # 预检：连通性、布局、权限、php、磁盘、锁
govard deploy staging --yes    # 部署本地 HEAD（或 --revision ）
govard deploy releases staging # 目标上有什么
govard deploy rollback staging # 将上一个发布版本恢复

先针对容器进行演练，或将构建拆分到 CI：

govard sandbox up --profile full --php 8.3
govard deploy --remote sandbox --yes
govard sandbox down --purge

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

4. 日常操作

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://.test:9200 | 无认证（Elasticsearch/OpenSearch） |
| RabbitMQ UI | http://.test:15672 | guest / guest |
| SSH 网关 | ssh -p 2222 @127.0.0.1 | 你的允许列表密钥（govard gateway allow-key） |

CLI 快捷方式：govard open mail|db|portainer。

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

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

🤝 贡献

构建、测试以及强制性的头脑风暴 → 编写计划 → 执行计划工作流详见 CONTRIBUTING.md 和 AGENTS.md。推送前的快速检查：make test && make build。

📜 许可证

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

由 ddtcorex 用 ❤️ 开发