快速上手 · 31 秒

把 IP 访问换成自己的域名

先用 IP 把 kageos 跑起来，准备给团队长期使用时，再换成自己的域名。这段视频为已有实例绑定域名，随后用 HTTPS 地址登录，继续进入原工作空间，无需重装或迁移业务数据。

中文讲解 · 视频内含整句字幕 · 可全屏观看画面为录制时版本，入口以当前实例为准。

1
先在域名服务商处添加 A 记录，指向这台服务器的公网 IPv4；使用 IPv6 时配置正确的 AAAA 记录，等待解析生效。不要保留指向其他服务器的旧记录。
2
在云安全组和本机防火墙放通公网 TCP 80、443，并确认请求能到达网关；服务器也需要能访问证书颁发机构。
3
运行 sudo kageos instance list 确认实例，再执行 sudo kageos domain instance-01 app.example.com，替换为自己的实例名和域名。
4
等待网关配置和 HTTPS 地址验证成功。切换会重启实例，建议避开业务高峰。
5
打开命令输出的 HTTPS 地址，用原账号登录，并运行 sudo kageos doctor instance-01 检查实例。

网关负责接收域名访问，并把请求转发到 kageos 实例。已有实例网关配置会继续沿用；未指定时优先识别实际监听 80/443 的 Caddy 或 Nginx，没有现有网关时默认使用 Caddy。

在域名解析、端口和网络正常的前提下，Caddy 会自动申请并续期它管理的 HTTPS 证书。保持网关运行、服务器联网，并保留其证书数据目录。手工提供的证书不属于这项自动续期承诺。

如果接入现有 Nginx，需要提前准备域名对应的可信证书并安排续期；缺少证书时当前命令默认停止并提示，不会静默改成 HTTP。

通过自己的 HTTPS 域名登录原实例，原账号和业务数据继续使用。

视频复用了已有 Caddy 路由和证书；DNS 解析、端口配置和首次签发没有在录像中演示。初始密码已遮挡，画面已剪辑并放慢，时长不代表实际配置耗时。请使用自己的实例名和域名。

详细规则、配置和排障说明，以文档中心为准。