Ployz

Ployz

租用一台服务器，获得一片云。
在你拥有的服务器上创建预览环境。从一台全新服务器到启用 https，只需一条命令。

网站 · 快速开始 · Agent · 状态 · 自托管

Ployz 将你租用的 Linux 服务器变成部署平台。它会构建你的应用，为其分配一个 https 地址，并在旁边运行应用所需的数据库和工作进程。每个拉取请求都可以拥有自己的环境。从一台服务器开始，需要时再添加更多服务器。

在你租用的服务器上，体验你喜欢的托管平台工作流。


_{六个托管平台。Ployz 与其中任何一家都没有关联。}

有何不同

• 每个拉取请求都有自己的环境。 每个预览环境都会在自己的 https 地址上运行拉取请求中的代码。复制数据库服务后，预览环境就会获得自己的空数据库，并由你的设置命令填充初始数据。若数据库服务保持共享，预览环境就会使用生产数据。合并后，生产环境会获得这些代码，预览环境的设置也会相应更改。Ployz · ready to merge 检查会先在拉取请求中列出这些更改。
• 部署前先审核。 在仪表板、CLI 或 Agent 中进行的编辑都会先作为草稿等待处理。你检查差异，然后再部署。
• CLI 能完成仪表板能做的事。 使用 --json 时，命令会输出 JSON。可能删除服务、卷或域名的更改会暂停，直到有人批准。Agent 无法批准。
• 服务器之间共享一个专用网络。 使用 ployz server add 添加服务器。你的服务器共享一个 WireGuard 网络，服务最多可在这些服务器上运行 50 个副本。带有卷的服务会运行在存放其数据的服务器上，默认运行一个副本。
• 应用不会因 Ployz Cloud 停摆而停止运行。 即使 Ployz Cloud 停机或不再提供服务，你的应用仍会在服务器上继续运行。引擎和仪表板均为开源软件。

与 Agent 搭配使用

将以下内容粘贴到你的编码 Agent 中。

Set me up for Ployz: https://ployz.dev/agents.md

它会安装 CLI 和 Ployz skill，帮你登录并注册 Ployz MCP 工具。从此以后，它会运行与你相同的命令。

> Copy production with its own worker, deploy it there, then stage it back.
$ ployz env branch try-worker --copy worker   # Made Branch shop/try-worker of production.
$ ployz deploy --env try-worker               # 2 deployed · across 1 server
$ ployz env sync --env try-worker --to        # Synced try-worker → shop/production.

这项更改会在生产环境中等待你审核并部署。

快速开始

你需要一台运行 systemd 的 Linux 服务器，并能通过 SSH 以 root 身份访问。请参阅服务器要求。

1. 安装 CLI。

   curl -fsSL https://ployz.sh | sh
   

2. 登录 Ployz Cloud。

   ployz login
   

3. 在应用目录中，将 Ployz 指向你的服务器。

   ployz up --server root@your-server
   

   Ployz 会在服务器上安装自身、构建你的应用，并输出其 https 地址。

4. 每次推送时都进行部署，并为每个拉取请求创建一个拥有独立初始数据数据库的预览环境。

   ployz github connect                # install the Ployz GitHub App
   ployz set shop.repository=you/shop  # build from GitHub instead of uploads
   ployz deploy
   ployz env pr you/shop --on --from production --copy postgres --setup 'shop=pnpm db:seed'
   

   ployz up 会使用应用目录的名称作为服务名，此处为 shop。预览环境会复制你已添加的 postgres 服务。

工作原理

每台服务器都会在 Docker 旁运行一个小型 Ployz 守护进程。你的服务器共享一个 WireGuard 网络，并互相保持最新状态。每台服务器都会通过 Caddy 自行提供 https 服务，因此无需租用负载均衡器。仪表板和 CLI 会告知服务器要运行什么。部署后，你的应用不依赖它们。生成的 ployz.app 地址使用 Ployz 的 DNS。指向你的服务器的 A 记录自定义域名则不使用 Ployz 的 DNS。

状态

我可以迁移生产应用吗？ 可以，只要你能接受以下限制。如果你现在需要托管式备份和自动故障转移，请再等等。Ployz 还很新，并且变化很快。请先完成生产环境检查清单。

• 操作系统由你维护。 Ployz 不会安装操作系统更新。
• 目前还没有异地备份。 卷镜像会在另一台服务器上保留一份副本。请定期转储数据库，并将转储文件保存在服务器之外，或者继续使用托管数据库。
• 没有自动故障转移。 如果服务器宕机，仅在该服务器上运行的服务就会停止。在其他服务器上的副本会继续运行。
• 没有 Docker Compose 文件。 请将每个容器分别添加为独立服务。
• 仅支持通过电子邮件发送告警。 服务停止或崩溃时，Ployz Cloud 会给你发送电子邮件。

即将推出： 异地备份、自动回滚，以及在不停机的情况下将数据库迁移到更大的服务器。

定价

Ployz 可免费在你自己的服务器上使用，包含自定义域名。付费的 Ployz Cloud 套餐即将推出。服务器费用由你的托管服务提供商向你收取。

自托管控制面板

自行运行控制面板，而不是使用 Ployz Cloud。请参阅 dashboard/README.md。

Ployz 的构建方式

Ployz 的大部分内容由 Agent 编写。我负责设计它们运行的循环，并对最终产物负责。

每项更改都会作为一个小型 PR 提交。Agent 必须通过在真实服务器上按你的实际使用方式运行 Ployz 来证明更改有效。如果它无法向我证明这一点，就不会合并。低风险 PR 在检查通过后即可合并。编排器、网络以及任何会接触你数据的内容，都必须先由人工审核。

当 Agent 出错时，我们会把错误转化为 lint 规则或测试。每次错误都会让系统更加严格，而这正是我信任它的原因。

贡献

请通过 GitHub Issues 提交错误报告和功能请求。

此代码库包含两个项目。core/ 是用 Rust 编写的引擎、命令行和守护进程。dashboard/ 是用 TypeScript 编写的 Ployz Cloud。各自的 README 都说明了如何构建项目。

许可证

core/ 中的引擎采用 Apache-2.0 许可证。dashboard/ 中的控制面板采用 AGPL-3.0 许可证。