CapRover

CapRover 是什么

CapRover 是一个开源的自托管平台即服务（PaaS）解决方案（Heroku 的开源替代），旨在显著简化网络应用和数据库的部署与管理。

它作为一个强大的网络服务器管理器，支持广泛的应用类型，包括 NodeJS、Python、PHP、ASP.NET、Ruby，以及 MySQL、MongoDB、Postgres 等流行数据库，甚至 WordPress 等平台。

https://caprover.comhttps://caprover.com

CapRover 安装部署

基于Debian系统。

防火墙放行端口

如果未启用防火墙，可跳过。

此处使用相对于 iptables 更简单的 ufw 进行设置，如果系统未安装 ufw 则需先安装，或者直接使用 iptables 。

1	ufw allow 80,443,3000,996,7946,4789,2377/tcp; ufw allow 7946,4789,2377/udp;

安装 Docker

apt-get update && apt-get install ca-certificates curl gnupg
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null

apt-get update && apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

安装 CapRover

1	docker run -p 80:80 -p 443:443 -p 3000:3000 -e ACCEPTED_TERMS=true -v /var/run/docker.sock:/var/run/docker.sock -v /captain:/captain caprover/caprover

纯 IPv6 服务器安装方式

docker run -p 80:80 -p 443:443 -p 3000:3000 \
  -e BY_PASS_PROXY_CHECK='TRUE' \
  -e MAIN_NODE_IP_ADDRESS='2b01::ff' \
  -e ACCEPTED_TERMS=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /captain:/captain caprover/caprover

MAIN_NODE_IP_ADDRESS 为机器的公网 IP。

安装成功后，执行 caprover serversetup 命令会被卡在 IPv6 地址不符合 IPv4 这一步。
通过地址加端口号访问 [2b01::ff]:3000 ，默认密码：captain42。

安装的应用无法绑定域名，外部无法访问

绑定域名

添加 A 记录泛解析：

Type: A
Name: *.something
IP Address: 服务器 IP 地址

如果需要套上CDN，不建议直接使用二级域名泛解析，而是使用三级域名做泛解析（*.something.domain.com），避免遇上SSL证书错误、域名指向IP错误、集群registry异常等问题。

安装运行 CapRover CLI

npm install -g caprover
caprover serversetup

根据提示输入服务器 IP、泛解析根域名（something.domain.com）、SSL 证书邮箱等信息。

安装完毕后会给出 CapRover 的登录信息，等待数分钟 CapRover 启动完成后即可在浏览器中登录。

其他问题

应用绑定其它域名时显示1107:verification failed

确保域名有正确指向服务器 IP；
如果使用的是 CloudFlare 的解析服务，应暂用其反代功能（要使用反代功能，则应使用下面的 Nginx 使用自定义SSL）；
跳过域名验证：

1 2	echo "{\"skipVerifyingDomains\":\"true\"}" > /captain/data/config-override.json docker service update captain-captain --force

Nginx使用自定义SSL

在宿主机中(/captain/generated/nginx，安装 CapRover 时，映射的本地目录/caprover)添加SSL证书（在目录/captain/data/nginx-shared/下创建 cert.pem、key.pem）；
在 CapRover 管理面板中，选择需要自定义 ssl 的应用，依次点击HTTP Settings → Edit Default Nginx Configurations

修改配置

原配置：

<%
if (!s.forceSsl) {
%>
    listen       80;
<%
}
if (s.hasSsl) {
%>
    listen              443 ssl http2;
    ssl_certificate     <%-s.crtPath%>;
    ssl_certificate_key <%-s.keyPath%>;
<%
}
%>

改成：

<%
if (!s.forceSsl) {
%>
    listen       80;
<%
}
if (true) {                                                                           ### <<< CHANGED
%>
    listen              443 ssl http2;
    ssl_certificate     /nginx-shared/custom-ssl_certificate.crt;        ### <<< CHANGED
    ssl_certificate_key /nginx-shared/custom-ssl_certificate_key.key;    ### <<< CHANGED
<%
}
%>