PanelAlpha Engine

让你的 AI 智能体跑你的服务器。
尽在掌控。

开源。自托管。谁都能上手，不只是运维。

开始使用 · 文档 · Discord

AI 操控 · 能力 · 遥测 · FAQ

English · Polski · Deutsch · Nederlands · Español · Français · Italiano · Português · Українська · العربية · 简体中文

一行命令安装 支持的系统 287 个 MCP 工具 Apache 2.0 加入 Discord

用一句话让助手部署项目

--- ## 什么是 PanelAlpha Engine？ PanelAlpha Engine 是你装在 VPS 上的软件，用来托管用 AI 构建和 vibe-coded 的项目、网站，以及你在网上找到的开源应用。装好之后，把你自己的 AI 智能体直接连到 PanelAlpha Engine，让它帮你处理部署、维护和服务器管理。你的服务器保持有序、尽在掌控。 **但最重要的是，管理自己的服务器/VPS 变得超级简单。** 你不必再当运维才能自托管！ 装好之后，PanelAlpha Engine 就给你和你的 AI 运行真实生产项目所需的一切： - 从 Git 或文件部署任意技术栈 - 即时预览地址，可选密码保护 - Staging 与 Git 工作流，线上和测试环境分开 - 自动备份与恢复 - 外部监控和内置访客统计 - 项目隔离在各自的 Docker 容器中 - 防火墙和 OWASP/WAF 防护，按项目设置访问规则 - 域名、SSL、定时任务、FTP/SFTP、数据库、日志 - 轻松接入 Cloudflare，用于 DNS、隧道和缓存 ## 工作原理

PanelAlpha Engine architecture: your AI agent, Git host, REST API clients and SSH reach the engine API on port 2011; core runs every operation and manages databases, files and isolated project containers; visitors reach projects through nginx-proxy on ports 80 and 443; backups go to an external store and Cloudflare tunnels connect into projects

## 为什么需要这个 AI 已经把软件创造从旧的限制里解放出来。更多人能把想法变成能跑的产品，小团队能做出比以前多得多的东西，开源也涌现出大量值得拿来用的项目。几乎没跟上同样速度的，是自己跑起来所需的那份工作。大多数自托管工具仍然要求你理解并管理 Docker、Web 服务器、证书、数据库、备份、防火墙，以及之后的更新。 **PanelAlpha Engine** 让在生产环境管理软件，变得和 AI 让构建软件一样容易。 - **一条命令，装一次。** 然后和你本来就在用的 AI 助手说话。 - **用普通话语提要求。** 引擎构建项目、启动它、给它 HTTPS，并持续备份。 - **AI 拿不到 root。** 它通过引擎工作，在你设定的规则内操作。 [**加入 Discord**](https://discord.gg/9twHWR7xGX)。这里是提问、展示你部署了什么、以及和构建它的人交流的主要地方。 --- ## 让你的项目跑起来 ### 第 1 步：在自己的 VPS 上安装 Engine 你需要一台**全新**的服务器，系统为 Debian 12/13 或 Ubuntu 22.04/24.04/26.04，至少 2 GB 内存和 1 核 CPU，并以 `root` 通过 SSH 登录。 **One-line app installation command** 是最快的上手方式。只需在 `--repo` 后面加上想使用的 Git 仓库，安装程序就会立即开始安装 Engine，并一次性让你的应用上线。 例如，想同时安装 Engine 并部署 n8n，只需这一条： ```bash curl --proto '=https' -fsSL https://get.panelalpha.com/engine | sh -s -- --repo https://github.com/n8n-io/n8n ``` 完成后，它会显示新网站的地址；如果你没有传 `--no-password`，还会显示打开网站用的密码。私有仓库、自定义密码，或在已经装有 Engine 的服务器上运行应用，请参阅：[One-line app installation command](docs/02-getting-started/install.md#one-line-app-installation-command)。 想把这两步分开做？用下面的命令只安装 Engine，稍后再通过你的助手部署应用（见第 2 步）： ```bash curl --proto '=https' -fsSL https://get.panelalpha.com/engine | sh ``` 就这样，服务器已经就绪。如需自定义名称、自备 TLS 证书，或服务器在 NAT 后面，请参阅：[安装选项](docs/02-getting-started/install.md)。 ### 第 2 步：连接你的 AI 智能体 安装结束时，引擎会问你用哪个助手，并打印出要在你自己电脑上执行的确切命令。以后想再接一个，在服务器上运行： ```bash pae connect ``` `pae connect` 在引擎所在的服务器上运行，不要在你的笔记本上运行。它打印出来的那一行，才是你在自己电脑上执行的。
Claude Code   Cursor   Codex   Gemini CLI   VS Code / Copilot   Grok   OpenCode   Windsurf   Pi   Hermes   OpenClaw Claude Code  ·  Cursor  ·  Codex  ·  Gemini CLI  ·  VS Code / Copilot  ·  Grok  ·  OpenCode  ·  Windsurf  ·  Pi  ·  Hermes  ·  OpenClaw
用的是别的？任何会说 MCP 的助手都可以：[连接其他助手](docs/04-connecting-your-ai/other-mcp-clients.md)。 默认权限的令牌可以删掉整个项目。你可以只发一个只读令牌，也可以单独收回某些工具：[决定助手能做什么](docs/04-connecting-your-ai/your-assistant.md#decide-what-the-assistant-may-do)。 ### 第 3 步：完成。直接说你想要什么 打开助手的聊天窗口，像对人说话那样说： ```text 把 github.com/anna/invoicer 部署到我的服务器上 ``` > 好了。可以在 `invoicer.panelalpha.online` 打开。 每个项目一创建就会拿到一个免费的 `panelalpha.online` 地址。等你准备好了，再要自己的域名，证书会一起配好。 更想自己在服务器上做？[直接从 git 部署](docs/README.md#3-put-your-project-online)。 --- ## 你可以直接开口要的事 没有命令需要背，也没有什么咒语。下面这些主要是让你看到，请求说到什么程度比较合适： | 你说 | 会发生什么 | |:---|:---| | `把 github.com/org/app 部署到这个引擎上。` | 创建项目、识别技术栈、构建并启动应用，然后给它一个带 HTTPS 的地址。 | | `把 shop.example.com 加到这个项目上，并申请证书。` | 域名挂上去，Let's Encrypt 签发一张会自动续期的证书。 | | `这个站点打不开。读一下部署日志，能修的就修。` | 助手读日志、看站点实际返回了什么、改你的代码，然后重新部署。 | | `先把它推到 staging。` | 一个有独立地址的关联副本。满意了就推上线，两个方向都能推。 | | `在这里装个 WordPress，管理员 anna。` | WordPress 装好待用，之后的事情都有 WP-CLI 可用。 | | `给这个项目建一个 MySQL 数据库，再建个用户。` | 数据库、用户和权限都办好，你不用碰 SQL。 | | `把昨天的备份恢复回来。` | 备份恢复完成，并且在那之前先把当前状态存了一份，以防万一。 | | `这个内部工具只让我们办公室访问。` | 一条防火墙规则，把该项目限制到你指定的地址。 | | `给 n8n.mydomain.com 配一个 Cloudflare 隧道。` | DNS 和隧道都配好，这也是从 NAT 后面的服务器对外提供服务的办法。 | | `上周我们有多少流量？` | 该项目以及整台服务器的用量、日志和限额。 | 更多现成的例子：[该怎么问](docs/04-connecting-your-ai/your-assistant.md#what-to-ask)。助手能够触达的完整清单：[287 个工具](docs/04-connecting-your-ai/your-assistant.md)。 ---

一台 VPS。多个项目。什么都能跑。

PHP, WordPress, Laravel, Node.js, Next.js, Nuxt, SvelteKit, Remix, Astro, Angular, React, Vite, NestJS, Express, Python, Django, Go, Rust, Java, Ruby, Rails, Docker, HTML, .NET
你自己的工具、用 AI 构建的项目，或者从网上找到的开源软件。来源并不重要，PanelAlpha Engine 都能把它跑起来。少数几个应用会被特别对待，因为通用做法会把它们弄坏：WordPress、Matomo、phpBB、Magento 和 Passbolt。见完整列表。

--- ## 别让 AI 把你的服务器弄得一团糟 给 AI 完整的 root 权限，意味着开放的端口、随意的设置，以及一个项目影响另一个项目。PanelAlpha Engine 会定下规则： - **减少出错空间。** AI 通过引擎工作，而不是直接操作服务器。 - **结构清晰。** 项目、账号和域名始终井然有序。 - **项目隔离。** 每个项目都在自己的 Docker 容器中独立运行，有各自的磁盘、内存和 CPU 限额，只开放所需的端口。 连接之前，由你决定助手可以做什么。[决定助手能做什么](docs/04-connecting-your-ai/your-assistant.md#decide-what-the-assistant-may-do) · [安全](docs/05-capabilities/security.md) --- ## 生产环境需要的一切，开箱即用 部署只是开始。持续管理从第一次安装起就已就绪： - **立即在线查看。** 每个项目都会获得一个免费的 `panelalpha.online` 主机名，自己的域名也可以随时添加。证书来自 Let's Encrypt，会自动续期。[域名与 HTTPS](docs/05-capabilities/domains-and-ssl.md) - **在 staging 上构建，准备好再上线。** 一个关联副本，尽管折腾，正常后再推上线。也能反向推送，用真实数据刷新测试副本。[项目](docs/05-capabilities/projects.md#staging) - **内置监控。** 服务器指标、按站点的日志、随时可要的 Lighthouse 报告，以及每六小时一次的检查，确认每个站点仍在提供自身内容，而不是空白页。[监控与日志](docs/05-capabilities/monitoring-and-logs.md) - **基础能力都已覆盖。** 服务器上和服务器外的备份、SSL、域名、数据库、FTP 与 SFTP 登录、定时任务和日志。[备份](docs/05-capabilities/backups.md) · [数据库](docs/05-capabilities/databases.md) · [文件与访问](docs/05-capabilities/files-and-access.md) - **每个项目都有自己的安全空间。** Docker 隔离、防火墙，以及采用 OWASP 规则的 ModSecurity。一个应用坏掉，不会拖垮其他应用。[安全](docs/05-capabilities/security.md) - **一次连接即可使用 Cloudflare。** 在所有项目中使用 DNS、隧道和缓存，也能让 NAT 后面的服务器对外提供站点。[Cloudflare](docs/05-capabilities/cloudflare.md) --- ## 部署失败时，引擎如何从中变好 大多数第一次部署都能成。跑不起来的那些，通常是仓库本身的问题。多数工具丢给你一段调用栈。这里的路径是： - **你得到的是一句话，不是调用栈。** "这个项目需要 PHP 8.2，但它是用 PHP 8.1 构建的。""构建时内存不够了。"完整的技术输出仍然在下面，谁需要谁看。 - **接下来由你的助手接手。** 它读日志，看站点实际返回了什么，把代码里能修的修掉，然后重新部署。这些工作跑在你本来就付费的 AI 订阅上，而不是 API 令牌上。 - **引擎会从中学习。** 一份匿名报告会送回 PanelAlpha。一台服务器上的一次故障，可能只是你的仓库。同一个故障出现在三十台服务器上，那就是识别逻辑或某个框架配方里的 bug，它会变成下一次更新里的修复。 - **如果错的是引擎本身**，说出来，它会自己把证据收集齐：让助手提交，或运行 `pae telemetry:bug-report <项目>`。 完整流程：[部署失败时](docs/02-getting-started/what-happens.md) · [这个报错是什么意思](docs/02-getting-started/reading-errors.md)。 --- ## 遥测 安装之后遥测是开着的。关于部署和之后健康检查的匿名报告会离开服务器，除非你关掉。它们包含站点的公开名称。 - **会发送：** 应用属于哪一类、耗时多久、项目的限额，失败时还包括出错的阶段和脱敏后的日志末尾。健康报告仅在站点后来不再提供自身内容时发送。错误报告仅在你自己提交时才有。 - **永远不会发送：** 你的源代码、项目名、令牌、密码、服务器的 IP 或主机名、私有仓库名，以及关于访问你站点的那些人的任何信息。 - **先看看报告再决定：** `pae telemetry:status` 和 `pae telemetry:show`。 要停止发送： ```bash pae telemetry:disable ``` 收集了什么、没收集什么，以及所有关闭方式：[收集了什么](docs/02-getting-started/what-is-collected.md) · [如何关闭](docs/02-getting-started/how-to-turn-it-off.md)。 --- ## FAQ
我为什么需要 PanelAlpha Engine？ 因为代码写完，应用并没有完成。你的项目还需要一个能跑起来的地方，更不用说让它保持健康、可访问、安全所需的一切。PanelAlpha Engine 给你的 AI 助手一条正经的路，去替你处理这一整层。你提出想要的结果，引擎把它变成受控的服务器操作，而不会把机器的无限权限交给 AI。 如果你已经懂 Docker、反向代理、防火墙和服务器日志，这些知识仍然有用。PanelAlpha 并不想对你隐藏基础设施，也不想把你关在外面。它给你一种更干净的操作方式：把重复的部分自动化，让 AI 承担真正的工作，同时不交出控制权。当某件事值得你亲自过问时，你可以下到任意深度；不值得时，就跳过那些例行公事。
我需要自己的服务器吗？ 需要。PanelAlpha Engine 是让 AI 智能体管理*你的*服务器的工具。你需要一台全新的 Debian 或 Ubuntu VPS，至少 2 GB 内存和 1 核 CPU，并以 `root` 通过 SSH 登录。你自己先在那台 VPS 上运行 Engine 安装。[你需要准备什么](docs/02-getting-started/install.md#before-you-start)
哪些 AI 助手能用？ 任何能用令牌连接 MCP 服务器的助手。我们为 [Claude Code](docs/04-connecting-your-ai/claude-code.md)、[Cursor](docs/04-connecting-your-ai/cursor.md)、[Codex](docs/04-connecting-your-ai/codex.md)、[Gemini CLI](docs/04-connecting-your-ai/gemini-cli.md)、[VS Code 与 Copilot](docs/04-connecting-your-ai/vs-code-copilot.md)、[Grok](docs/04-connecting-your-ai/grok.md)、[OpenCode](docs/04-connecting-your-ai/opencode.md)、[Windsurf](docs/04-connecting-your-ai/windsurf.md)、[Pi](docs/04-connecting-your-ai/pi.md)、[Hermes](docs/04-connecting-your-ai/hermes.md) 和 [OpenClaw](docs/04-connecting-your-ai/openclaw.md) 都写了分步说明，另外还有[其他任何会说 MCP 的客户端](docs/04-connecting-your-ai/other-mcp-clients.md)。
我可以用 PanelAlpha Engine 部署什么？ 目标是通用工具，什么项目都行。静态站点、WordPress、PHP、Laravel、Node、Next.js、Django、Go、Rust、Java、一个普通的 `Dockerfile` 或者一个 Compose 文件。你自己的工具、你用 AI 做的项目，以及你在网上找到的开源软件。见[项目类型](docs/07-supported-projects/project-types.md)；想先确认的话，让助手先检查一下仓库。
它免费吗？我要付什么钱？ PanelAlpha Engine 是免费开源的，采用 Apache 2.0 许可证。你付的是服务器和 AI 订阅，而这两样你已经有了。排查失败的部署走的是你助手的订阅，而不是 API 令牌。
我能限制助手的权限吗？ 能，而且值得在粘贴令牌之前就做。你可以给只读令牌，允许修改但不允许删除，只开放部分领域，或者单独收回像 `project_delete` 这样的工具。[决定助手能做什么](docs/04-connecting-your-ai/your-assistant.md#decide-what-the-assistant-may-do)
部署失败时会上报什么？ 一份匿名摘要：应用类型、出错的阶段、脱敏后的日志末尾，以及站点的公开名称。绝不包括源代码、项目名、凭据或服务器身份。你可以用 `pae telemetry:show` 打印队列里的报告，也可以把整套遥测关掉。完整细节：[遥测](docs/02-getting-started/what-is-collected.md)。
可以用它做虚拟主机（共享主机）吗？ 可以。每个项目都是独立账号，有自己的域名、数据库、文件和限额，托管服务商一直用它在生产环境运行数千个站点。
引擎把我的项目认错了，怎么办？ 提交一份错误报告，它会自己把证据收齐。让助手提交，或者在服务器上运行 `pae telemetry:bug-report <项目>`。想先看清会发送什么，加上 `--dry-run`。
--- ## 在 Discord 上找我们 **Discord 是联系我们的主要渠道。** 提问、把你部署的东西秀给我们看、分享想法，或者过来看看我们在做什么。我们就在那些对话中间，你在那里提出的事，可能变成我们接下来要构建、修复或重新思考的内容。
在 Discord 上找我们，这是联系 PanelAlpha 团队的主要渠道

不太喜欢 Discord？[我们的论坛](https://community.panelalpha.com/)同样开放。 ## 你的服务器只差一条命令 ```bash curl --proto '=https' -fsSL https://get.panelalpha.com/engine | sh ``` ## 安全 跑引擎的主机是一台单一用途的机器。安装程序会替换解析器和防火墙，请按这个前提对待它。 发现了漏洞？请**私下**披露，不要发在公开 issue 里。见 [`SECURITY.md`](SECURITY.md)，或使用 [manage.panelalpha.com/contact](https://manage.panelalpha.com/contact)。 ## 许可证 PanelAlpha Engine 是开源软件，采用 Apache 2.0 许可证。 ## 一起来构建 想参与？[`CONTRIBUTING.md`](CONTRIBUTING.md) 会带你起步。给运维人员看的文档在 [`docs/`](docs/README.md)。