panelalpha/panelalpha-engine
panelalpha/panelalpha-engine has 36 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-10 01:14 UTC. Last push 2026-10-29.
The easiest way to self-host projects on your own server. Connect your AI agent and let it deploy, maintain and manage multiple projects on any stack, while keeping your server organized and under control. Easy for anyone, not just sysadmins.
实测星标增长
- 24小时
- 0
- 7天
- 0
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
README.zh-CN.md
原文让你的 AI 智能体跑你的服务器。
尽在掌控。
开源。自托管。谁都能上手,不只是运维。
开始使用 · 文档 · Discord
English · Polski · Deutsch · Nederlands · Español · Français · Italiano · Português · Українська · العربية · 简体中文

什么是 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、隧道和缓存
工作原理

为什么需要这个
AI 已经把软件创造从旧的限制里解放出来。更多人能把想法变成能跑的产品,小团队能做出比以前多得多的东西,开源也涌现出大量值得拿来用的项目。几乎没跟上同样速度的,是自己跑起来所需的那份工作。大多数自托管工具仍然要求你理解并管理 Docker、Web 服务器、证书、数据库、备份、防火墙,以及之后的更新。
PanelAlpha Engine 让在生产环境管理软件,变得和 AI 让构建软件一样容易。
- 一条命令,装一次。 然后和你本来就在用的 AI 助手说话。
- 用普通话语提要求。 引擎构建项目、启动它、给它 HTTPS,并持续备份。
- AI 拿不到 root。 它通过引擎工作,在你设定的规则内操作。
加入 Discord。这里是提问、展示你部署了什么、以及和构建它的人交流的主要地方。
让你的项目跑起来
第 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,只需这一条:
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。
想把这两步分开做?用下面的命令只安装 Engine,稍后再通过你的助手部署应用(见第 2 步):
curl --proto '=https' -fsSL https://get.panelalpha.com/engine | sh
就这样,服务器已经就绪。如需自定义名称、自备 TLS 证书,或服务器在 NAT 后面,请参阅:安装选项。
第 2 步:连接你的 AI 智能体
安装结束时,引擎会问你用哪个助手,并打印出要在你自己电脑上执行的确切命令。以后想再接一个,在服务器上运行:
pae connect
pae connect 在引擎所在的服务器上运行,不要在你的笔记本上运行。它打印出来的那一行,才是你在自己电脑上执行的。
Claude Code · Cursor · Codex · Gemini CLI · VS Code / Copilot · Grok · OpenCode · Windsurf · Pi · Hermes · OpenClaw
用的是别的?任何会说 MCP 的助手都可以:连接其他助手。
默认权限的令牌可以删掉整个项目。你可以只发一个只读令牌,也可以单独收回某些工具:决定助手能做什么。
第 3 步:完成。直接说你想要什么
打开助手的聊天窗口,像对人说话那样说:
把 github.com/anna/invoicer 部署到我的服务器上
好了。可以在
invoicer.panelalpha.online打开。
每个项目一创建就会拿到一个免费的 panelalpha.online 地址。等你准备好了,再要自己的域名,证书会一起配好。
更想自己在服务器上做?直接从 git 部署。
你可以直接开口要的事
没有命令需要背,也没有什么咒语。下面这些主要是让你看到,请求说到什么程度比较合适:
| 你说 | 会发生什么 |
|---|---|
把 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 后面的服务器对外提供服务的办法。 |
上周我们有多少流量? |
该项目以及整台服务器的用量、日志和限额。 |
更多现成的例子:该怎么问。助手能够触达的完整清单:287 个工具。
一台 VPS。多个项目。什么都能跑。
你自己的工具、用 AI 构建的项目,或者从网上找到的开源软件。来源并不重要,PanelAlpha Engine 都能把它跑起来。少数几个应用会被特别对待,因为通用做法会把它们弄坏:WordPress、Matomo、phpBB、Magento 和 Passbolt。见完整列表。
别让 AI 把你的服务器弄得一团糟
给 AI 完整的 root 权限,意味着开放的端口、随意的设置,以及一个项目影响另一个项目。PanelAlpha Engine 会定下规则:
- 减少出错空间。 AI 通过引擎工作,而不是直接操作服务器。
- 结构清晰。 项目、账号和域名始终井然有序。
- 项目隔离。 每个项目都在自己的 Docker 容器中独立运行,有各自的磁盘、内存和 CPU 限额,只开放所需的端口。
连接之前,由你决定助手可以做什么。决定助手能做什么 · 安全
生产环境需要的一切,开箱即用
部署只是开始。持续管理从第一次安装起就已就绪:
- 立即在线查看。 每个项目都会获得一个免费的
panelalpha.online主机名,自己的域名也可以随时添加。证书来自 Let's Encrypt,会自动续期。域名与 HTTPS - 在 staging 上构建,准备好再上线。 一个关联副本,尽管折腾,正常后再推上线。也能反向推送,用真实数据刷新测试副本。项目
- 内置监控。 服务器指标、按站点的日志、随时可要的 Lighthouse 报告,以及每六小时一次的检查,确认每个站点仍在提供自身内容,而不是空白页。监控与日志
- 基础能力都已覆盖。 服务器上和服务器外的备份、SSL、域名、数据库、FTP 与 SFTP 登录、定时任务和日志。备份 · 数据库 · 文件与访问
- 每个项目都有自己的安全空间。 Docker 隔离、防火墙,以及采用 OWASP 规则的 ModSecurity。一个应用坏掉,不会拖垮其他应用。安全
- 一次连接即可使用 Cloudflare。 在所有项目中使用 DNS、隧道和缓存,也能让 NAT 后面的服务器对外提供站点。Cloudflare
部署失败时,引擎如何从中变好
大多数第一次部署都能成。跑不起来的那些,通常是仓库本身的问题。多数工具丢给你一段调用栈。这里的路径是:
- 你得到的是一句话,不是调用栈。 "这个项目需要 PHP 8.2,但它是用 PHP 8.1 构建的。""构建时内存不够了。"完整的技术输出仍然在下面,谁需要谁看。
- 接下来由你的助手接手。 它读日志,看站点实际返回了什么,把代码里能修的修掉,然后重新部署。这些工作跑在你本来就付费的 AI 订阅上,而不是 API 令牌上。
- 引擎会从中学习。 一份匿名报告会送回 PanelAlpha。一台服务器上的一次故障,可能只是你的仓库。同一个故障出现在三十台服务器上,那就是识别逻辑或某个框架配方里的 bug,它会变成下一次更新里的修复。
- 如果错的是引擎本身,说出来,它会自己把证据收集齐:让助手提交,或运行
pae telemetry:bug-report <项目>。
遥测
安装之后遥测是开着的。关于部署和之后健康检查的匿名报告会离开服务器,除非你关掉。它们包含站点的公开名称。
- 会发送: 应用属于哪一类、耗时多久、项目的限额,失败时还包括出错的阶段和脱敏后的日志末尾。健康报告仅在站点后来不再提供自身内容时发送。错误报告仅在你自己提交时才有。
- 永远不会发送: 你的源代码、项目名、令牌、密码、服务器的 IP 或主机名、私有仓库名,以及关于访问你站点的那些人的任何信息。
- 先看看报告再决定:
pae telemetry:status和pae telemetry:show。
要停止发送:
pae telemetry:disable
收集了什么、没收集什么,以及所有关闭方式:收集了什么 · 如何关闭。
FAQ
我为什么需要 PanelAlpha Engine?
因为代码写完,应用并没有完成。你的项目还需要一个能跑起来的地方,更不用说让它保持健康、可访问、安全所需的一切。PanelAlpha Engine 给你的 AI 助手一条正经的路,去替你处理这一整层。你提出想要的结果,引擎把它变成受控的服务器操作,而不会把机器的无限权限交给 AI。
如果你已经懂 Docker、反向代理、防火墙和服务器日志,这些知识仍然有用。PanelAlpha 并不想对你隐藏基础设施,也不想把你关在外面。它给你一种更干净的操作方式:把重复的部分自动化,让 AI 承担真正的工作,同时不交出控制权。当某件事值得你亲自过问时,你可以下到任意深度;不值得时,就跳过那些例行公事。
我需要自己的服务器吗?
需要。PanelAlpha Engine 是让 AI 智能体管理你的服务器的工具。你需要一台全新的 Debian 或 Ubuntu VPS,至少 2 GB 内存和 1 核 CPU,并以 root 通过 SSH 登录。你自己先在那台 VPS 上运行 Engine 安装。你需要准备什么
哪些 AI 助手能用?
任何能用令牌连接 MCP 服务器的助手。我们为 Claude Code、Cursor、Codex、Gemini CLI、VS Code 与 Copilot、Grok、OpenCode、Windsurf、Pi、Hermes 和 OpenClaw 都写了分步说明,另外还有其他任何会说 MCP 的客户端。
我可以用 PanelAlpha Engine 部署什么?
目标是通用工具,什么项目都行。静态站点、WordPress、PHP、Laravel、Node、Next.js、Django、Go、Rust、Java、一个普通的 Dockerfile 或者一个 Compose 文件。你自己的工具、你用 AI 做的项目,以及你在网上找到的开源软件。见项目类型;想先确认的话,让助手先检查一下仓库。
它免费吗?我要付什么钱?
PanelAlpha Engine 是免费开源的,采用 Apache 2.0 许可证。你付的是服务器和 AI 订阅,而这两样你已经有了。排查失败的部署走的是你助手的订阅,而不是 API 令牌。
我能限制助手的权限吗?
能,而且值得在粘贴令牌之前就做。你可以给只读令牌,允许修改但不允许删除,只开放部分领域,或者单独收回像 project_delete 这样的工具。决定助手能做什么
部署失败时会上报什么?
一份匿名摘要:应用类型、出错的阶段、脱敏后的日志末尾,以及站点的公开名称。绝不包括源代码、项目名、凭据或服务器身份。你可以用 pae telemetry:show 打印队列里的报告,也可以把整套遥测关掉。完整细节:遥测。
可以用它做虚拟主机(共享主机)吗?
可以。每个项目都是独立账号,有自己的域名、数据库、文件和限额,托管服务商一直用它在生产环境运行数千个站点。
引擎把我的项目认错了,怎么办?
提交一份错误报告,它会自己把证据收齐。让助手提交,或者在服务器上运行 pae telemetry:bug-report <项目>。想先看清会发送什么,加上 --dry-run。
在 Discord 上找我们
Discord 是联系我们的主要渠道。 提问、把你部署的东西秀给我们看、分享想法,或者过来看看我们在做什么。我们就在那些对话中间,你在那里提出的事,可能变成我们接下来要构建、修复或重新思考的内容。
不太喜欢 Discord?我们的论坛同样开放。
你的服务器只差一条命令
curl --proto '=https' -fsSL https://get.panelalpha.com/engine | sh
安全
跑引擎的主机是一台单一用途的机器。安装程序会替换解析器和防火墙,请按这个前提对待它。
发现了漏洞?请私下披露,不要发在公开 issue 里。见 SECURITY.md,或使用 manage.panelalpha.com/contact。
许可证
PanelAlpha Engine 是开源软件,采用 Apache 2.0 许可证。
一起来构建
想参与?CONTRIBUTING.md 会带你起步。给运维人员看的文档在 docs/。