🛠️ CyberPanel

由 OpenLiteSpeed 驱动的网站托管控制面板，旨在简化托管管理。

🔧 功能与服务

• 🔐 不同用户访问级别（通过 ACL 实现）。
• 🌌 自动 SSL，为网站提供安全保护。
• 💻 FTP 服务器，用于文件传输。
• 🕒 轻量级 DNS 服务器（PowerDNS）。
• 🔐 phpMyAdmin，用于管理数据库（MariaDB）。
• 📧 电子邮件支持（SnappyMail）。
• 🕌 文件管理器，方便快速访问文件。
• 🌐 PHP 管理，简单易用。
• 🔒 防火墙（集成 FirewallD 与 ConfigServer Firewall）。
• 📀 一键备份与恢复。
• 🐳 Docker 管理，支持命令执行。
• 🤖 AI 驱动的安全扫描器，提供增强保护。
• 📊 每月带宽重置 - 自动重置带宽使用量（已在最新版本中修复）。

📖 文档与指南

CyberPanel 附带全面的文档和分步指南：

• 📚 完整指南索引 - 所有可用文档集中于一页
• 🐳 Docker 命令执行 - 在 Docker 容器中执行命令
• 🤖 AI 扫描器设置 - 配置 AI 驱动的安全扫描
• 📧 Mautic 安装 - 电子邮件营销平台设置

🔢 支持的 PHP 版本

CyberPanel 在不同的操作系统上支持多种 PHP 版本：

☑️ 当前支持的 PHP 版本

• PHP 8.5 - 最新稳定版（EOL：2028 年 12 月）
• PHP 8.4 - 稳定版（EOL：2027 年 12 月）
• PHP 8.3 - 稳定版（EOL：2027 年 12 月）
• PHP 8.2 - 稳定版（EOL：2026 年 12 月）
• PHP 8.1 - 稳定版（EOL：2025 年 12 月）
• PHP 8.0 - 旧版支持（EOL：2023 年 11 月）
• PHP 7.4 - 旧版支持（EOL：2022 年 11 月）

🔧 第三方 PHP 附加组件

如需更多 PHP 版本或特定需求，可以安装第三方软件包：

Ubuntu/Debian

• Ondrej 的 PPA：提供 PHP 5.6 至 8.5
• Sury 的 PPA：提供最新 PHP 版本的备用仓库

基于 RHEL 的系统（AlmaLinux、RockyLinux、CentOS、RHEL）

• Remi 仓库：全面的 PHP 软件包集合
• EPEL 仓库：面向企业 Linux 的附加软件包

CloudLinux

• CloudLinux PHP Selector：用于管理多个 PHP 版本的内置工具
• Remi 仓库：额外的 PHP 版本和扩展

注意：第三方仓库可能会提供默认仓库之外的其他 PHP 版本。请务必验证其与您的具体使用场景的兼容性。

🌐 支持的操作系统

CyberPanel 运行于 x86_64 架构，并支持以下操作系统：

✅ 当前支持

• Ubuntu 24.04.3 - 支持至 2029 年 4 月 ⭐ 新！
• Ubuntu 22.04 - 支持至 2027 年 4 月
• Ubuntu 20.04 - 支持至 2025 年 4 月
• AlmaLinux 10 - 支持至 2030 年 5 月 ⭐ 新！
• AlmaLinux 9 - 支持至 2032 年 5 月
• AlmaLinux 8 - 支持至 2029 年 5 月
• RockyLinux 9 - 支持至 2032 年 5 月
• RockyLinux 8 - 支持至 2029 年 5 月
• RHEL 9 - 支持至 2032 年 5 月
• RHEL 8 - 支持至 2029 年 5 月
• CloudLinux 8 - 支持至 2029 年 5 月
• CentOS 9 - 支持至 2027 年 5 月

🔧 第三方操作系统支持

其他操作系统可能通过第三方仓库或社区努力获得支持：

• Debian - 可能兼容 Ubuntu 软件包
• openEuler - 社区支持，测试有限
• 其他 RHEL 衍生版 - 可能兼容 AlmaLinux/RockyLinux 软件包

注意：对于不受支持的操作系统，不保证兼容性。请务必先在非生产环境中进行测试。

⚙️ 安装说明

使用以下命令轻松安装 CyberPanel：

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

📊 升级 CyberPanel

使用以下命令升级 CyberPanel 安装：

sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)

🆕 最近更新与修复

带宽重置问题已修复（2025 年 1 月）

• 问题：每月带宽使用量未重置，导致累计值无限增长
• 解决方案：为所有网站和子域实现了自动每月带宽重置
• 受影响的操作系统：所有受支持的操作系统（Ubuntu、AlmaLinux、RockyLinux、RHEL、CloudLinux、CentOS）
• 手动重置：使用 /usr/local/CyberCP/scripts/reset_bandwidth.sh 立即重置
• 文档：参见 带宽重置修复指南

新增操作系统支持（2025 年 1 月）

• Ubuntu 24.04.3：与最新的 Ubuntu LTS 完全兼容
• AlmaLinux 10：与最新的 AlmaLinux 版本完全兼容
• 长期支持：两者均支持至 2029-2030 年

📚 资源

• 🌐 官方网站
• ✏️ 文档（新版）
• 🎓 文档（旧版）
• 📖 更多指南 - 涵盖 Docker、AI 扫描器、Mautic 等的详细指南
• 📚 本地文档 - 本仓库中提供的所有指南
• 🤝 贡献指南 - 如何为 CyberPanel 开发做出贡献
• ✅ 更新日志
• 💬 论坛
• 📢 Discord
• 📵 Facebook 群组
• 🎥 YouTube 频道

📖 快速入门指南

• 🐳 Docker 命令执行 - 在 Docker 容器中执行命令
• 🤖 AI 扫描器设置 - 配置 AI 驱动的安全扫描
• 📧 Mautic 安装 - 电子邮件营销平台设置
• 📚 全部指南索引 - 完整的文档中心

🔗 指南直达链接

🧪 测试

CyberPanel 包含一套 OLS 功能测试套件，共 128 项测试，覆盖所有自定义 OpenLiteSpeed 功能。

运行测试

# On the target server, set up test data (once):
bash tests/ols_test_setup.sh

# Run the full 128-test suite:
bash tests/ols_feature_tests.sh

测试覆盖

🔧 故障排除

常见问题与解决方案

带宽未按月重置

• 问题：带宽使用量显示为累计值，而非每月用量
• 解决方案：运行带宽重置脚本：/usr/local/CyberCP/scripts/reset_bandwidth.sh
• 预防措施：确保每月 cron 任务正在运行：0 0 1 * * /usr/local/CyberCP/bin/python /usr/local/CyberCP/postfixSenderPolicy/client.py monthlyCleanup

常规支持

• 查看日志：/usr/local/lscp/logs/error.log
• 验证 cron 任务：crontab -l
• 测试手动重置：使用 /usr/local/CyberCP/scripts/ 中提供的脚本