安装 Nimbopanel

要求

Nimbopanel 安装在你掌控的一台 全新 Linux 服务器（VPS 或独立服务器）上——不是在共享主机上。你需要：

• 一台全新开通的 x86_64/arm64（64 位） 服务器，运行一个受支持的操作系统：

  • Ubuntu 22.04 LTS 或 24.04 LTS —— 已端到端测试，也是我们自己运行的系统。
  • Debian 12 —— 已端到端测试。
  • AlmaLinux 8、9 和 10 —— 已端到端测试。
  • Rocky Linux 9 —— 已端到端测试。RHEL 9 属于同一家族，预期表现完全一致。
  • CloudLinux 9 —— 已端到端测试，在 CloudLinux 内核提供支持之处，会遵循按账户的 LVE 资源限制。
  • ARM（aarch64）尚不支持。

  安装器不会在一个未经测试的组合上拦住你——它会警告并继续。

• Root（或 sudo）访问权限。

• 一个指向服务器 IP、供面板使用的域名或子域名（例如 panel.yourdomain.com）。

• 小型主机至少 1 GB 内存；随着你添加账户需要更多。

一行命令安装

登录你的账户，打开 Dashboard，并复制那里显示的安装命令——它已经包含你的许可证密钥：

curl -fsSL https://nimbopanel.com/install.sh | sudo bash -s -- --license NIMB-XXXX-XXXX-XXXX-XXXX

带有你自己密钥的确切、可直接运行的命令，在你登录后会显示在你的 Dashboard 和 Downloads 上。请从那里复制它，而不是敲下这一条——它带有适合你账户的正确密钥。

安装器会打开一个简短的 浏览器设置向导（它会打印一个链接并等待），在那里你确认许可证、创建管理员账户，并命名面板主机名。这是正常路径，无论你是否传入 --wizard 它都会运行；命令行上的密钥只是预先填好那个字段。

它随后会设置好控制面板、Web 服务器、PHP、邮件栈、DNS 和数据库服务，并在最后打印面板 URL 和管理员登录信息。整个运行过程都记录到 /var/log/nimbopanel-install.log。

还没有密钥？把 --license 去掉。服务器会安装并以 Free 权益运行——一个网站，无附加域名——你可以稍后从面板输入密钥。

安装之前（如果你已有域名）

要在安装期间自动获得 HTTPS，请 先 做这个：

1. 为你的面板主机名（例如 panel.yourdomain.com）创建一条 A 记录 指向你服务器的 IP——如果你要托管 DNS/邮件，再加上 ns1、ns2 和 mail 记录。
2. 在你的 云防火墙（DigitalOcean、Vultr、AWS……）中，开放 80 和 443 端口。

还没有域名？你可以在裸服务器 IP 上安装，稍后再添加域名 + HTTPS。

已经给服务器起了一个指向它的名称（hostname），例如 srv1.yourdomain.com？向导会检测到并把它作为面板地址提供——完全不需要 DNS 步骤。

安装之后

1. 打开面板 URL，用安装结束时显示的管理员凭据登录。
2. HTTPS 是自动的。 如果你面板主机名的 DNS 已经指向服务器，安装器会为你签发一份真实的 Let's Encrypt 证书——最后的摘要会予以确认。如果域名当时还没有指向，面板会保持在 http://，而 HTTPS 会在你指向 DNS 后 约 5 分钟内自行开启。要立即强制开启，以 root 身份 SSH 进去并运行 sudo nimbopanel-enable-https。
3. 创建你的第一个主机账户，或者 导入一个已有的 cPanel 账户——参见 从 cPanel 迁移。你添加的每一个主机域名，在指向服务器后都会自动获得它自己的免费 Let's Encrypt 证书。

在 RHEL 家族上有何不同

AlmaLinux、Rocky、CloudLinux 和 RHEL 运行相同的面板和相同的功能集，只有三个捆绑组件安装器不会在那里设置：

• phpMyAdmin 和 Roundcube webmail 仅限 Debian/Ubuntu。在没有它们的服务器上，你客户的面板会自动隐藏这两个图块，因此没有人会被送到一个并不存在的页面——但如果这两者中任何一个对你重要，请选择 Debian 或 Ubuntu。
• rspamd 垃圾邮件过滤不会在 RHEL 家族上安装。它的仓库用一个 RHEL 9 拒绝的密钥为软件包签名，而从一个未经验证的仓库安装一个 root 守护进程不是一笔值得做的交易。

其他一切——邮件、DNS、数据库、PHP、备份、SSL——在两个家族上都是相同的。

许可与离线容忍

你的服务器会不时地向许可证服务器签到。如果它连不上许可证服务器——一次中断、一次网络抖动——你的主机服务照常运行。Nimbopanel 刻意做到永不 “fail-closed（失败即关闭）”。详情参见 许可如何工作。

更新

更新以一个新发行版的形式发布。再次运行同一个安装器（或内置的更新器）即可升级到最新版本；你的账户和数据会被保留。