一、速览

入门

CyberPanel 是基于 OpenLiteSpeed 的开源 Web 主机控制面板，把建站、域名、数据库、邮箱、FTP、DNS 这些零碎操作整合到一个 Web UI 里。OpenLiteSpeed 自带 LSAPI 与缓存机制，对 PHP 站点（尤其是 WordPress、Laravel）的并发处理比传统 Nginx + PHP-FPM 方案更直接，少了一层反代配置。

控制面板内部依赖的组件链是：OpenLiteSpeed（Web 服务器）、MariaDB（数据库）、PowerDNS（DNS）、SnappyMail（Webmail）、Pure-FTPd（FTP）。这些组件不需要单独编译，用户在面板里点几下就能完成常见的运维动作。

和 cPanel、Plesk 这类商业面板相比，CyberPanel 是社区版开源，适合个人站长、接单开发者、小型工作室自用，也可以作为 VPS 厂商的预装镜像。

适用人群：管 1~50 个站点、想省 SSH 操作的人；不适合需要多租户隔离计费、WHMCS 深度整合的场景。

二、快速部署

入门

CyberPanel 没有官方 Docker 镜像，标准做法是在干净的 Linux 服务器上跑官方安装脚本。容器里跑面板的实践偶尔有人尝试，但官方文档明确以裸机/虚机部署为主。

环境要求

  • 系统：Ubuntu 20.04/22.04/24.04、AlmaLinux 8/9、Rocky Linux 8/9、CentOS 7（部分版本已停止官方支持）
  • 内存：建议 ≥ 2 GB，多 PHP 版本 + 数据库同时跑会比较高
  • 磁盘：≥ 20 GB，存放站点和数据库
  • 公网 IP，能访问 8090 端口（控制面板）

一键安装

SSH 登录服务器后执行：

sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)

安装脚本会先检测系统并提示选择版本：CyberPanel (Latest Stable) 是推荐项，附带 OpenLiteSpeed；另一个 Ent 版本包含 LiteSpeed Enterprise，需要自行准备授权。

随后会让你选择：

  • Install CyberPanel with Admin Panel：默认
  • 是否安装 Postfix + Dovecot + SnappyMail：自建邮件建议开
  • Remote MySQL：单台服务器选 No

安装结束后脚本会输出控制面板地址、admin 随机密码和端口号，建议截图保存。

安装完成后首次访问 https://<服务器IP>:8090，浏览器会提示证书不安全，因为控制面板用了自签证书。先进面板，再到 SSL 菜单签发主机名证书。

三、配置详解

进阶 · 推荐细读

核心端口清单

端口 用途
8090 CyberPanel Web UI（TCP）
7080 OpenLiteSpeed 管理后台（TCP）
80 HTTP
443 HTTPS
53 DNS（TCP/UDP）
21/20 FTP（主动/被动）
25/465/587/993/995 SMTP / SMTPS / IMAPS / POP3S

关键数据与配置路径

  • /usr/local/CyberCP/：控制面板核心代码与配置
  • /usr/local/lsws/：OpenLiteSpeed 主目录
  • /var/lib/mysql/：MariaDB 数据目录
  • /home/：站点根目录，每个网站一个子目录

常用配置入口

CyberPanel 不是容器化运行，没有 .env 风格的环境变量，常用配置通过编辑以下文件生效：

  • /usr/local/CyberCP/CyberCP/settings.py：面板基础配置
  • /usr/local/lsws/conf/httpd_config.conf：OLS 主配置
  • 修改后执行 systemctl restart lscpd && systemctl restart lsws，或在面板点 "Restart"

注意：修改 OLS 配置前先 cp 备份原文件，OpenLiteSpeed 在配置写错时会直接起不来，需要从控制台恢复。

CyberPanel 项目首页

四、功能导览

进阶 · 推荐细读

网站管理

左侧 Websites → Create Website 填域名、管理员邮箱、选择 PHP 版本（默认 8.1），点 Create Website 即完成建站。建站后系统会自动创建用户家目录、数据库用户、FTP 账号和 SSL 证书占位（首次签发前是自签）。

SSL 证书

面板集成了 Let's Encrypt 自动签发流程。在 Websites → Manage Website → SSL 标签页里：Issue SSL 给站点域名申请证书；Hostname SSL 给主机名签证书。签发失败的常见原因是域名未解析到服务器 IP，或 80 端口被占用。先用 curl -I http://你的域名 验证连通性。

数据库 / phpMyAdmin

Database → phpMyAdmin 直接跳转，或 Database → Create Database 手动建库。每个站点会附带一个同名数据库，可以重命名或删除。

DNS（PowerDNS）

如果把域名托管到这台服务器，在 DNS → Add Zone 添加 zone 文件。面板里的 NameServer 需要在域名注册商侧填入 ns1.<你的主机名>

项目信息

项目 值
仓库 usmannasir/cyberpanel
语言 JavaScript
Star 2,001
Fork 719
主页 无

参考链接