如何在 VPS 上安装 Cloudron
了解在全新 Ubuntu VPS 上安装 Cloudron 的完整步骤:配置通配符 DNS、运行安装脚本并首次启动,同时核对 2 至 10 个应用的内存、邮件、证书和备份要求。
在 VPS 上安装 Cloudron:简要步骤
要在 VPS 上安装 Cloudron,您需要一台全新的 Ubuntu 服务器、至少 2 GB 内存,以及一个可以编辑其 DNS 记录的域名。安装过程只需执行 3 条命令并重启 1 次。大多数问题都发生在此步骤之前(基础镜像错误、虚拟化类型错误)或之后(DNS、邮件、备份)。
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron 会为自托管应用安装、更新和备份,并签发 TLS(传输层安全)证书。每个应用都运行在 Docker 中,nginx 位于所有应用前端,并且每个应用都会使用您域名下的独立子域名。正因为如此,DNS 配置必须先完成。
Cloudron 对基础操作系统要求严格的原因
安装脚本会在安装任何组件前检查服务器。检查失败意味着需要重新订购服务器。选择镜像前先阅读这些要求。本节引用的安装程序检查来自 October 13, 2026;当前安装文档要求使用全新的 Ubuntu 26.04 服务器。
- 仅支持 Ubuntu,并且只支持三个版本。其他系统会以
Cloudron requires Ubuntu 22.04, 24.04, 26.04退出。Ubuntu 20.04 会被拒绝,当前安装文档要求使用全新的 Ubuntu 26.04 服务器。不支持 Debian、Rocky 和 Alpine。Ubuntu 24.04 需要 Cloudron 8 或更高版本,脚本会自动检查这一点。 - 仅支持 64 位 Intel 或 AMD:
Error: Cloudron only supports amd64/x86_64。ARM VPS 无法运行 Cloudron。 - 仅支持完整硬件虚拟化。在基于容器的 VPS 上,脚本会以
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization停止,因为它会通过systemd-detect-virt --container检测到容器环境。KVM 可以使用。不支持 OpenVZ 和 LXC。 - 根文件系统必须是
ext4或xfs。使用其他文件系统时会出现Error: Cloudron requires '/' to be ext4 or xfs,btrfs 和 zfs 镜像会因此检查失败。 - 至少需要 941 MB RAM,使用
free -m测量;根文件系统需要 18 GB,在/上按根文件系统大小测量。错误消息要求 20GB,但检查本身对 19 GB 的根文件系统也会通过。 - 必须使用真正全新的服务器。如果已经安装
nginx、docker或node,脚本会以Error: Some packages like nginx/docker/nodejs are already installed.拒绝继续。
最后一项检查最容易引发争议。原因如下。Cloudron 会安装固定版本的 Docker、nginx、Node.js 和 MySQL,为它托管的每个应用生成 nginx 配置,并自行管理 iptables 防火墙规则。昨天手动安装的 Docker 版本可能不符合要求,因此脚本会退出,不修改任何内容,并要求从全新的 Ubuntu 安装开始。Cloudron 会接管整台机器,因此应为它提供专用 VPS。
还有一项检查容易被忽略。在不支持 AVX(高级矢量扩展)的旧 CPU 上,脚本会输出 CPU has no AVX support. MongoDB will be disabled,所有需要 MongoDB 的应用都会无法安装。提交订单前使用 grep -m1 -o avx /proc/cpuinfo 检查 CPU。支持 AVX 的主机会输出 avx,旧主机则不会输出任何内容。
Cloudron 需要多少 RAM?
2026 年 10 月 13 日的安装程序检查会拒绝在低于 941 MB 的环境中运行,并显示 Error: Cloudron requires atleast 1GB physical memory;当前文档要求 2 GB RAM 和 20 GB 磁盘空间。这两个数值是平台本身的最低要求,不包括平台上运行的应用。Cloudron 会运行 Docker、nginx、自带的 box 服务和邮件堆栈,并在部署应用时提供共享数据库服务。在全新安装上运行 docker ps 并统计这些服务。
应用的内存限制是在上述基础开销之上的额外需求。每个应用包都有一个较低的默认限制,您可以在应用的 Resources 视图中使用滑块提高该限制。应用超过限制后会重启,并向您发送 OOM(内存不足)通知。因此,如果服务器持续重启某个应用,通常是内存限制问题,而不是程序错误。
以下是我建议采购的配置。这些建议适用于您不希望下个月就重装服务器的场景,不是实测基准结果。
此图表背后的数据
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]运行两个应用时,4 GB RAM 和 60 GB 磁盘空间足够。运行约 10 个应用时,建议使用 16 GB RAM 和 240 GB 磁盘空间,因为平台基础开销不会减少,每个应用还会增加一个 Docker 镜像、一个数据库和自身的数据。磁盘空间通常会比预期更快耗尽:镜像、应用数据和本地备份会共用同一卷,除非您将备份移出服务器。
Cloudron 会为每个应用提供不受限制的 swap,因此您设置的内存限制仅适用于 RAM。在没有 swap 文件的 VPS 镜像上,swapon --show 完全不会输出内容,内存压力会直接导致 OOM 重启,而不是让应用运行缓慢。增加 2 GB swap 是一种低成本的保障,但不能替代实际内存。VPS 方案之间的价差通常小于您调试内存限制所需的时间,因此请查看VPS 的实际成本,并购买更高一级的配置。
DNS:使应用子域名生效的通配符记录
Cloudron 将管理面板放在 my.example.com,并为每个应用使用独立的子域名,因此 DNS 是前置条件,而不是后续步骤。首次打开管理面板前,将以下记录指向服务器的公网 IP 地址:
- 将
my.example.com配置为 A 记录。这是管理面板。 - 将
*.example.com配置为 A 记录。该记录用于使应用子域名生效,因此安装这些应用后,wiki.example.com和git.example.com会立即解析。 - 仅当您希望在裸域名上运行应用时,才将
example.com配置为 A 记录。
通配符记录的优先级低于显式记录,因此,已有的指向其他位置的 www.example.com 仍会继续生效。
在设置过程中,您需要选择 Cloudron 后续如何处理 DNS:
- API 提供商。Cloudron 会保存 Cloudflare、DigitalOcean、Route53、Hetzner、Porkbun、Linode、deSEC、Gandi、Namecheap、Hostinger DNS、Scaleway DNS 等服务的令牌(总计 22 个 API DNS 集成,不包括 Wildcard、Manual 和 No-op),然后自行写入所有记录,包括邮件记录。
- Wildcard。您手动添加
*记录,Cloudron 不写入任何记录。 - Manual。Cloudron 显示每条记录,您需要在每次安装应用前手动添加这些记录。
DNS 通配符记录不是通配符证书。 默认的证书提供商是 Let's Encrypt Prod - Wildcard。该方式通过 DNS 验证域名所有权,因此只能与 API 提供商配合使用。在 Wildcard 或 Manual 后端中,Let's Encrypt 会通过 HTTP 验证并签发单独的证书,因此签发和续期时都需要开放入站端口 80。您也可以禁用 Let's Encrypt 集成并上传自定义通配符证书,这样端口 80 就不再是证书验证的长期要求。如果您的注册商或 DNS 托管商在 API 列表中,请使用对应的集成:邮件记录和证书都无需再由您管理。
继续操作前先进行验证。dig +short my.example.com 和 dig +short anything.example.com 都应输出服务器的 IP 地址。在 Wildcard 后端中,如果通配符查询没有输出结果,后续应用将无法正常工作,而管理面板仍可能正常运行。
如果域名位于 Cloudflare 后方,请将这些记录设置为“仅 DNS”。代理只转发 HTTP 和 HTTPS 流量,因此邮件端口会失效。对于使用代理的 Web 应用,Cloudron 的 Network 视图支持信任 Cloudflare 公布的 IP 地址范围,以便从转发标头中恢复访问者的地址。
运行安装脚本
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup请以 root 身份运行,或通过 sudo 运行。否则,它首先会输出 This script should be run as root.。安装需要几分钟。安装过程中不会显示进度,因为 apt 输出和 Docker 拉取内容会写入日志文件。请从第二个 SSH 会话中监控日志:
tail -f /var/log/cloudron-setup.log在 2026 年 10 月 13 日的安装程序检查中,它先输出 After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup.,后面跟随服务器地址,然后询问 The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]。请输入 yes。该安装程序还提供了 --skip-reboot 标志,可推迟重启。
首次启动:域名、DNS 后端和管理员帐户
打开 https://<server-ip> 并接受浏览器警告。证书是自签名证书,因为 Cloudron 还不知道您的域名,因此无法向证书颁发机构申请证书。在 Chrome 中点击 Advanced,然后点击 Proceed to <ip> (unsafe)。在 Firefox 中点击 Advanced,然后点击 Accept the Risk and Continue。
第一个页面会要求您输入域名。输入 example.com,然后控制面板会固定在 my.example.com。您也可以改用 cloudron.example.com 这样的子域名,此时控制面板地址为 my.cloudron.example.com。选择 DNS 后端;如果您有 API token,请粘贴到相应位置;然后使用一个您确实会查看的电子邮件地址创建管理员帐户,因为密码重置和平台通知都会发送到该地址。
保存后,Cloudron 会申请证书,并将控制面板迁移到 https://my.example.com。此时通过 IP 地址访问的 URL 将不再有效,请将新的 URL 添加到书签。
证书:续期内容与停止续期的时机
证书会自动续期,遵循证书颁发机构发布的 ACME Renewal Information(ARI)计划。实际上,续期通常在证书到期前约一个月进行。续期失败后,系统会向管理员账户发送电子邮件;证书过期后,系统会回退到内置的自签名证书。网站昨天还可以正常访问,但今天浏览器出现警告,实际指的就是这种回退情况。
大多数问题都由两个原因导致。HTTP 验证需要入站端口 80。对于使用 Let's Encrypt HTTP 验证的 Wildcard 或 Manual DNS 后端,如果因为“反正所有内容都是 HTTPS”而关闭端口 80,续期就会失败。DNS 验证需要仍具有写入权限的 API token。如果轮换该 token 或收紧其权限,续期会静默失败,直到系统发送警告邮件。
Domains 视图中有一个 Renew All 按钮,可立即强制执行续期尝试;其中还提供 Let's Encrypt Staging provider,供测试使用。Staging 证书有意不受浏览器信任,这正是其用途:测试不会消耗生产环境的速率限制。Staging 也有自己的限制,包括每个账户每个标识符每小时最多 200 次授权失败。
是否应使用内置邮件服务器?
Cloudron 自带完整的邮件系统,包括 IMAP 邮箱、邮件提交、Sieve 过滤器和 DKIM(域名密钥识别邮件)签名。在管理面板的 Email 中按域启用。邮件能否成功投递才是难点,而这些问题都不是 Cloudron 造成的。
- 大多数 VPS 提供商会封锁出站端口 25,以控制垃圾邮件。提交支持工单后,部分提供商会解除封锁。在服务器上使用
nc -zv aspmx.l.google.com 25进行测试(如果缺少该命令,请安装netcat-openbsd)。开放端口会报告succeeded;如果端口被封锁,命令会一直等待,直到超时。 - PTR 记录(反向 DNS)由 VPS 提供商设置,而不是由 DNS 托管商设置。直接从服务器发送邮件时,PTR 记录必须与邮件主机名匹配。使用智能主机可以不再要求 PTR 记录。
- 在基于 API 的 DNS 后端上,SPF、DKIM 和 DMARC 记录会自动为您写入。在 Wildcard 或 Manual 后端上,您需要手动添加这些记录。如果缺少 DKIM 记录,您签名的每封邮件都无法验证。
对大多数用户而言,可靠的配置是:在 Cloudron 上接收邮件,再通过 SendGrid、Postmark、Mailgun 或 Amazon SES 等中继发送邮件,并在 Email 页面中进行配置。中继必须允许使用您域中的任意地址发送邮件,否则来自不同发件人的应用通知会被拒收。如果购买服务器的主要目的是运行邮件服务,请在独立服务器上运行独立的邮件服务器,例如 Mailcow,并为其使用独立 IP 信誉。
如果完全不使用 Cloudron Email,请在提供商的防火墙中封锁端口 25、465、587、993 和 4190。应在提供商处执行此操作,而不是在服务器上执行,因为 Cloudron 会自行写入 iptables 规则,并且需要独占管理这些规则。这与普通 VPS 不同;在普通 VPS 上,您需要自行管理 ufw 规则。
在需要备份之前配置备份目标
备份默认保存到 /var/backups 的本地文件系统,与其他数据位于同一块磁盘上。文档对此有明确说明:“让备份与平台服务器位于同一块物理磁盘上非常危险。”磁盘发生故障时,应用和备份会同时丢失。
打开 Backups,然后进入 Backup Sites,在第一天就将备份指向其他位置。S3 兼容对象存储通常是首选方案(Backblaze B2、Wasabi、Cloudflare R2、DigitalOcean Spaces,或第二台服务器上的 MinIO 存储桶)。同时也支持 SSHFS、NFS、CIFS 和普通文件系统目标。
以下三个设置决定备份是否真正有用:
- 格式。
tgz为每个应用写入一个压缩归档,并在每次运行时重新上传整个归档。rsync只上传发生更改的文件。对于大型 Nextcloud,这样可以大幅降低成本,但会向存储 API 发起更多请求。 - 加密。可选的 AES-256 加密,同时保护文件内容和文件名。Cloudron 不会保留密码副本,因此密码丢失后,包括您在内的任何人都无法解密备份。点击保存之前,请将密码存储在自行托管的密码管理器中。
- 保留期限。使用数量表示,例如 7 个每日备份和 4 个每周备份。在对象存储中长期保留备份会产生每月费用,因此请选择您愿意持续支付的数量。
然后测试恢复。安装一个小型应用,从控制面板恢复该应用,并确认其数据能够一并恢复。任何从未恢复过的备份都只是猜测。
免费套餐的限制
截至 October 2026,免费套餐最多支持安装 2 个应用。以下功能均包含在内:应用更新、每个应用的备份、防火墙、邮件服务器和单点登录。安装第 3 个应用时需要购买许可证。付费套餐会取消应用数量限制;更高一级的套餐还支持用户组和角色、目录服务器以及多个备份站点。价格会变化,因此请查看Cloudron 价格页面,不要依据教程中的固定数字。
一个许可证对应一个 Cloudron 安装,因此运行 2 台小型服务器的费用是运行 1 台更大型服务器的 2 倍。这种定价会让大多数用户选择单台更大的 VPS,这与通常建议将服务分散到多台机器上的做法相矛盾。配置服务器容量时应考虑这一点,因为之后再拆分服务意味着需要支付 2 倍费用。
出现故障时
先运行内置检查。它会依次检查 DNS、证书、磁盘、内存和各项服务,并告知哪个测试失败:
sudo cloudron-support --troubleshoot然后使用常规的 systemd(系统和服务管理器)工具。systemctl status box 会报告 Cloudron 服务本身的状态,journalctl -u box -n 100 会显示其最近的日志,journalctl -u docker 会检查底层容器运行时。安装过程中发生的任何错误都会记录在 /var/log/cloudron-setup.log 中。
仪表板无法加载时,通常是 DNS 或服务商防火墙的问题,而不是 Cloudron 本身的问题。在笔记本电脑上运行 dig +short my.example.com,并确认服务商网络防火墙已放行 80 和 443 端口。该防火墙独立于服务器自身的规则。2026 年 10 月 13 日的安装程序检查中,第二次运行因 Error: Cloudron is already installed. To reinstall, start afresh 被拒绝;重建服务器是最稳妥的处理方式。
Cloudron 不适合的情况
如果您只想部署应用,而不想管理基础设施,Cloudron 很合适。如果您想按自己的方式运行容器,Cloudron 就不太合适,因为它会接管 nginx、Docker 和防火墙,并覆盖您对这些组件所做的配置。如果您的计划是维护一组 compose 文件,那么在自己的 Docker Compose 堆栈前使用 Traefik,即可获得相同的自动 TLS 和子域名路由功能,同时不需要在其上再运行一个平台。如果您还没有做出选择,Cloudron、CasaOS 和 Coolify 对比会并列介绍这几个方案;相比直接查看安装指南,更完整的自托管项目列表更适合作为起点。
FAQ
Cloudron 在 VPS 上需要多少 RAM?
2026 年 10 月 13 日的安装程序检查拒绝在 941 MB 以下运行;当前文档要求 2 GB,但这只是平台在未安装任何应用时的最低配置。Cloudron 会运行 Docker、nginx、自带的 box 服务和邮件栈,并在部署应用时提供共享数据库服务。运行两个应用建议分配 4 GB,运行大约十个应用建议分配 16 GB,并添加交换文件,因为 Cloudron 不限制应用使用交换空间;没有交换空间的服务器在内存压力下可能触发重启。
可以在 Debian 上安装 Cloudron,或安装在已经运行 Docker 的服务器上吗?
两种情况都不支持。在 2026 年 10 月 13 日的安装程序检查中,脚本会因版本不受支持而显示 Cloudron requires Ubuntu 22.04, 24.04, 26.04,如果服务器上已存在 nginx、docker 或 node,也会拒绝继续。当前安装文档要求使用全新的 Ubuntu 镜像,并排除 Debian、Rocky 和 Alpine。请从 KVM VPS 上的全新 Ubuntu 镜像开始。
为什么应用子域名无法访问,但控制面板可以访问?
如果使用 Wildcard 后端,请检查通配符 DNS 记录。安装程序会为 my.example.com 创建或要求一个 A 记录,因此控制面板可以解析;而 wiki.example.com 会返回 NXDOMAIN,浏览器则报告找不到该网站。添加一个将 *.example.com 指向服务器 IP 的 A 记录,然后在安装应用前使用 dig +short wiki.example.com 确认。
必须使用 Cloudron 邮件服务器吗?
不必。您可以关闭入站邮件,并通过 Postmark、Mailgun 或 Amazon SES 等外部中继发送邮件。如果您的服务提供商阻止出站端口 25,或 IP 地址没有邮件信誉,这种方式更安全。如果完全不使用 Cloudron Email,请在服务提供商的防火墙中关闭端口 25、465、587、993 和 4190,而不是在服务器上关闭。
免费计划达到两个应用的上限后会怎样?
您需要购买付费订阅才能安装第三个应用。已经运行的应用不会受到影响:它们会继续更新、继续备份,并继续使用现有证书。添加订阅后无需重新安装即可解除限制,因此免费计划适合先在真实域名上测试该平台。