跳到主要内容

快速入门

在全新的 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 命令。

部署第一个应用​

  1. 打开 Apps,创建名为 my-first-app 的 Web 应用。

  2. 在 Deployment 中粘贴以下 Captain Definition 并部署:

    {
    "schemaVersion": 2,
    "imageName": "nginx:stable-alpine"
    }
  3. 将 Container HTTP Port 设置为 80。

  4. 打开 http://my-first-app.apps.example.com。此时应该看到 NGINX 欢迎页面。

  5. 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 进行构建。

文档导航​

按主题查看文档: