panel README

项目的 README,来自 github.com/serveroshq/panel。合并为一个 markdown 文件:README.md。

ServerOS

ServerOS panel

One place to run the Linux servers you already own.

License: AGPL-3.0 CI Downloads Contributor Covenant v2.1 adopted Discord Follow ServerOS on LinkedIn

The ServerOS dashboard: machines, services, average CPU and backups, a CPU chart for the last 24 hours, and the machines list

ServerOS runs the Linux servers you already own from one place. Connect a VPS from any provider with one command, then deploy apps, sites and databases, watch them, back them up and fix them, without living in a terminal. Your servers stay with your provider, on your account.

This repo is the panel, the web app you and your team work in. Each server runs serverosd, a small daemon the panel talks to. serveros.com runs this same panel as a hosted service.

What's in it

Self-hosting

You need a Linux server with Docker, ports 80, 443 and 8443 open, and a domain like panel.example.com with two A records pointing at the server: one for panel.example.com and one for *.panel.example.com.

Then run this on the server:

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

It installs Docker if it's missing, runs the official image (ghcr.io/serveroshq/panel) and prints a setup code. Open https://panel.example.com, enter it, and the installer walks you through email and your first account. serveros-panel setup-code shows the code again if you lose it.

Then connect your servers from Machines › Connect machine. Each one runs serverosd, the open source daemon, which connects out to your panel on port 8443.

docs/self-hosting.md covers the rest: building the community edition yourself, installing without Docker, upgrades, backups, connecting machines, and the anonymous daily ping (and how to turn it off).

Editions

Edition What's in it License
Community, built from this repo The panel AGPL-3.0, free
Official image (ghcr.io/serveroshq/panel) The panel plus serveroshq/panel-ee, off until you add a license key AGPL-3.0, and panel-ee under its own terms
serveros.com The panel, hosted for you A paid service

Without a key, the official image works exactly like the community edition. A license turns on single sign-on, SCIM, custom roles, your own domains and the other paid features, with nothing to reinstall. LICENSING.md explains what that means for you. The daemon is AGPL-3.0 too.

Development

You need PHP 8.4, Composer, Node 22 and npm. SQLite works out of the box.

composer setup   # install, .env, key, migrate, build
composer dev     # the panel, queue worker, logs and Vite together

Workspaces live on subdomains, so set these in .env and open http://serveros.localhost:8000:

APP_URL=http://serveros.localhost:8000
APP_DOMAIN=serveros.localhost
SESSION_DOMAIN=.serveros.localhost

CONTRIBUTING.md has the full setup, the tests and checks CI runs, and how pull requests are reviewed. On Linux, docker/dev runs it all in Docker.

Help and contributing

Found a security problem? Please don't open an issue; follow SECURITY.md.

Before you open a pull request, read CONTRIBUTING.md. Everyone who takes part follows the Code of Conduct, and first-time contributors sign the CLA with a comment on their pull request.

Star history

Stars on serveroshq/panel over time

License

The panel is licensed under the GNU Affero General Public License v3.0. Copyright © 2026 ServerOS Cloud Ltd.

The ServerOS name and logo are trademarks of ServerOS Cloud Ltd and aren't covered by the AGPL. See TRADEMARKS.md.

panel (serveroshq/panel)

正在搜索数据库…

1.1K ·GitHub
这是什么?这是一个网页控制面板,用来管理你已经拥有的 Linux 服务器。用一条命令连接服务器,然后就可以在浏览器里部署应用和网站、备份、监控和修复问题,无需待在终端里操作。
这是框架、库还是应用?这是一个应用:一个基于 PHP(Laravel)的网页面板,供你和团队登录使用,另外还有一个小型开源守护进程 serverosd,运行在每台你连接的服务器上。
怎样让它运行起来?在装有 Docker 的 Linux 服务器上开放 80、443 和 8443 端口,并把两条 DNS A 记录指向该服务器:一条是 panel.example.com,另一条是它的子域名。然后运行 README 中的安装程序。它会在需要时安装 Docker,启动官方镜像,并显示一个设置代码。
开始之前需要准备什么?一台你可以控制、装有 Docker 的 Linux 服务器,开放 80、443 和 8443 端口,以及一个可以指向它的域名。如果你想自己开发这个面板,需要 PHP 8.4、Composer、Node 22 和 npm;SQLite 开箱即用。
有什么限制吗?安装前必须先准备好 DNS 和端口。单点登录、SCIM、自定义角色和自有域名功能只有在使用许可证密钥后才会启用;没有许可证密钥时,官方镜像的功能与社区版相同。
它会向外部发送数据吗?默认情况下,它会每天发送一次匿名的心跳请求。docs/self-hosting.md 中说明了如何关闭此功能。
日常可以用它做什么?查看 CPU、内存和磁盘使用情况,安装更新,从 Git 或模板部署应用并配置域名和 HTTPS,还能在正式上线前把项目复制到测试环境。
我的 AI 助手可以使用它吗?可以。面板内置了 MCP 服务器和 API,因此你自己的工具和 AI 助手可以与你的服务器协同工作。
团队可以共同使用吗?可以。面板内置成员管理、角色、两步验证登录和活动日志,并且工作流可以按计划、在推送时或手动运行,用于部署、检查和晋升等步骤。
大小
7 MB
星标
1.1K
时长
9天
提交 · 90 天