快速入门
在全新的 Ubuntu 24.04 服务器上安装 CapRover。
系统要求
- AMD64 或 ARM64 服务器,具有公网 IPv4 地址以及 sudo/root 权限。
- 至少 1 GiB 内存和 5 GiB 可用磁盘空间。
- 一个可以配置通配符 DNS 记录的域名。
- 云服务商防火墙允许公网访问 TCP 80、443 和 3000 端口。
安装 CapRover
在服务器上执行:
sudo apt update && sudo apt install -y curl
curl -fsSL https://get.caprover.com -o caprover-install.sh
sudo bash caprover-install.sh
如需执行只读检查,请运行 sudo bash caprover-install.sh --check。
其他安装方式: 手动安装(手动执行 Docker 和 CapRover 命令)、DigitalOcean Marketplace,以及适用于私有网络、现有 Swarm 集群或自定义端口的高级安装。
DNS
在 DNS 服务商处创建一条 A 记录:
| 类型 | 名称(在 example.com 域中) | 值 |
|---|---|---|
| A | *.apps | 服务器的公网 IPv4 地址 |
本指南使用 apps.example.com 作为 CapRover 的根域名。通配符记录将覆盖 captain.apps.example.com 和应用域名,例如 my-first-app.apps.example.com。
验证 DNS 解析:
dig +short captain.apps.example.com
dig +short test.apps.example.com
两个命令都应返回服务器的 IP 地址。如果使用 Cloudflare 等 DNS 代理,安装时请选择 DNS only(仅 DNS)。只有需要直接使用 apps.example.com 时,才需要为这个根主机名单独创建 DNS 记录。
配置 CapRover
打开 http://YOUR_SERVER_IP:3000。初始密码:captain42。
- 更改密码,并将根域名设置为
apps.example.com(不包含*.或captain.)。 - 管理面板域名为
captain.apps.example.com。确认 DNS 正常且可以签发证书后,启用 HTTPS 和 Force HTTPS。 - 管理面板通过 HTTPS 正常访问后,限制公网对
3000/tcp端口的访问。
如果证书签发失败,请检查 DNS 和 TCP 80/443 端口的入站访问。参阅域名和 HTTPS。
CLI 替代方案: 在自己的电脑上运行 npm install -g caprover 安装 CLI,然后执行 caprover serversetup。参阅 CLI 命令。
部署第一个应用
-
打开 Apps,创建名为
my-first-app的 Web 应用。 -
在 Deployment 中粘贴以下 Captain Definition 并部署:
{"schemaVersion": 2,"imageName": "nginx:stable-alpine"} -
将 Container HTTP Port 设置为
80。 -
打开
http://my-first-app.apps.example.com。此时应该看到 NGINX 欢迎页面。 -
DNS 和 80 端口可以正常访问后,在应用的 HTTP 设置中配置 HTTPS。
内存不足时的构建方案(可选)
如果构建因内存不足而失败,请运行 free -h 和 swapon --show 检查内存和交换空间。如果磁盘有足够空间且 /swapfile 尚不存在,可以执行:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
若要重启后继续启用交换空间,请将 /swapfile none swap sw 0 0 仅添加一次到 /etc/fstab 中。如果经常构建应用,建议增加内存或使用 CI 进行构建。
文档导航
按主题查看文档: