CapRover

CapRover Pro 故障排查


本节内容仅适用于 CapRover Pro 订阅用户(付费方案)。你可以订阅付费方案以获得更多功能,例如构建状态通知,以及安全增强功能(如登录提醒、双因素认证等)。

重置 OTP(双因素认证)

在少数情况下,你可能需要重置双因素认证,例如:

  • pro.caprover.com 宕机,导致你无法访问你的实例
  • 当你失去了对认证器(Authenticator)应用的访问权限

在这些情况下,你只需要清除 Pro 配置,并临时将服务器降级为非付费版本即可。你可以通过删除 /captain/data/config-captain.json 中的 pro 内容来完成。

下面的辅助脚本会完成上述操作:

docker service scale captain-captain=0 && \
docker run -it --rm -v /captain:/captain  caprover/caprover /bin/sh -c "wget https://raw.githubusercontent.com/caprover/caprover/master/dev-scripts/clear-pro-config.js ; node clear-pro-config.js ;" && \
docker service scale captain-captain=1 && \
echo "OKAY"

更新:

从 v1.12.0 开始,你可以运行以下脚本:

docker exec -it $(docker ps --filter name=captain-captain -q) npm run disable-otp

启用 OTP 时部署

当你启用 OTP 后,无法使用常规的 caprover deploy 进行部署,因为它需要 2FA 令牌(也就是需要你 同时输入 OTP token)。此时你应该改用 App Tokens:

caprover deploy --caproverUrl https://captain.domain.com --appToken 123456123456123456 --appName my-app -b main

你可以在 Deployment 选项卡中启用 App Token。或者,你也可以使用如下格式(不推荐):

CAPROVER_OTP_TOKEN=123456; caprover login

## or

CAPROVER_OTP_TOKEN=123456; caprover deploy

为告警设置指定邮箱地址

目前还没有内置的“修改通知邮箱”功能。不过,我们选择 Google 作为认证提供方的原因之一是:在 Gmail 中你可以很方便地设置过滤器,将特定邮件转发到其他邮箱。

只需搜索 from: alerts@mail.pro.caprover.com 并创建一个过滤器,然后把匹配到的邮件转发到另一个邮箱即可。

gmail-instruction-1 gmail-instruction-2

邮件支持

我们的 Pro 付费方案包含 24 小时 SLA 的邮件支持。你可以发送邮件至 pro.support at/caprover/dot/com 获取帮助。请务必使用你购买时所使用的同一邮箱发送邮件。