serveroshq/panel

项目介绍

ServerOS panel 是 ServerOS 体系里的 Web 面板。服务器仍然留在你自己的服务商账户下，面板把它们集中到一个界面里：部署应用、站点和数据库，查看 CPU、内存和磁盘，安装更新，安排备份，做可用性检查和可选的状态页，并把各服务日志收在一起。工作流可以按计划、按 push 或手动执行部署、检查和晋级步骤；团队部分提供成员、角色、两步验证和操作日志。

每台被管理的机器运行 serverosd 守护进程（AGPL-3.0），由它主动连接面板的 8443 端口。面板本身是 Laravel/PHP 应用，另外提供 API 和 MCP server，方便其他工具或助手操作服务器。

它适合已经拥有 Linux 服务器、希望有一个共享控制台但不想迁移服务商或账户的运维者。

快速使用

自托管需要一台装有 Docker 的 Linux 服务器，开放 80、443 和 8443 端口，并准备一个域名和两条 A 记录：一条指向面板主机名，一条通配子域记录（工作区使用子域名）。

在服务器上执行：

curl -fsSL https://raw.githubusercontent.com/serveroshq/panel/main/docker/self-hosted/install.sh | sudo bash -s -- --domain=panel.example.com --email=you@example.com

安装脚本会在缺少 Docker 时安装它，运行官方镜像 ghcr.io/serveroshq/panel，并打印一个 setup code。打开 https://panel.example.com，输入该代码，按引导填写邮箱并创建首个账户。若代码丢失，执行 serveros-panel setup-code 可再次查看。

之后在 Machines › Connect machine 里生成连接命令，到每台服务器上执行，serverosd 会回连面板。自托管文档 还说明了自行构建社区版、不使用 Docker 的安装方式、升级、备份、接入机器，以及匿名每日上报的关闭方法。

开发环境

本地开发需要 PHP 8.4、Composer、Node 22 和 npm，默认使用 SQLite。执行 composer setup 安装依赖、生成 .env 和密钥、迁移并构建，再执行 composer dev 同时启动面板、队列 worker、日志和 Vite。由于工作区在子域名上提供，需要在 .env 中设置 APP_URL、APP_DOMAIN 和 SESSION_DOMAIN，然后打开 http://serveros.localhost:8000。CONTRIBUTING.md 列出了测试和 CI 检查，Linux 下也可用 docker/dev 在 Docker 中运行整套环境。

版本与许可

从本仓库构建的社区版是 AGPL-3.0，免费使用。官方镜像还打包了 serveroshq/panel-ee，未添加许可证密钥时不启用，行为与社区版一致；添加密钥后可启用单点登录、SCIM、自定义角色、自有域名等付费功能，无需重装。serveros.com 则把同一面板作为付费托管服务提供。ServerOS 名称和 logo 是商标，不受 AGPL 覆盖。

使用约束

• 生产自托管需要 Docker、上述开放端口，以及面板主机名和通配子域两条 DNS 记录；没有通配记录时基于子域名的工作区无法正常工作。
• 官方镜像包含按独立条款授权的 panel-ee 专有组件，只有本仓库中的代码是 AGPL-3.0。
• 被管理的机器需要运行 serverosd 守护进程，并能在 8443 端口连到面板。
• 首次贡献者需要在 PR 评论中签署 CLA。

HotRepo 点评

ServerOS panel 于 2026-11-12 进入 HotRepo 新项目榜：在约一小时的统计窗口内新增 29 Star、3 Fork，当时总计 142 Star。对年轻的基础设施项目来说起步不慢，但这只是一个很短的窗口，也没有 GitHub 全语言日榜名次，尚不足以说明持续热度。对采用更有参考意义的是它的分层结构：面板需要在每台机器上安装守护进程、配置通配 DNS 并开放控制端口，前置条件不少。源码可见的社区版加付费托管服务，适合不想自己维护面板的团队。