自定义域名

将自定义域名连接到 sh0 应用，享受自动 SSL 证书和零停机配置。

添加域名

在 sh0 上部署的每个应用都会获得 *.sh0.app 下的默认子域名。要使用自己的域名，请导航到应用设置并通过域名面板添加。

1. 打开 控制台 并选择你的应用。
2. 导航到 设置 → 域名。
3. 点击 添加域名 并输入你的域名（例如 example.com）。
4. sh0 将显示需要在域名注册商处配置的 DNS 记录。

DNS 配置

在控制台中添加域名后，你需要在域名注册商（Cloudflare、Namecheap、GoDaddy 等）配置 DNS 记录。sh0 同时支持 A 记录和 CNAME 记录。

A 记录设置

对根域名使用 A 记录。将其指向 sh0 服务器的 IP 地址：

Type: A
Name: @
Value: YOUR_SERVER_IP
TTL: 3600 (or Auto)

CNAME 设置

对子域名使用 CNAME 记录。将其指向 sh0 服务器的主机名：

Type: CNAME
Name: app
Value: your-server.example.com
TTL: 3600 (or Auto)

域名验证

sh0 通过检查 DNS 记录自动验证域名所有权。验证流程如下：

1. sh0 为你的域名生成唯一的验证令牌。
2. 你按照控制台中显示的内容添加 DNS 记录。
3. sh0 定期检查记录（每 30 秒）。
4. 验证通过后，sh0 配置 SSL 证书并将流量路由到你的应用。

你也可以通过 API 触发手动检查：

curl -X POST https://your-server:9000/api/domains/verify \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[object Object]'

通过 Let's Encrypt 自动配置 SSL

sh0 使用 Caddy 作为反向代理，自动从 Let's Encrypt 获取和续期 SSL 证书。无需配置——域名验证通过后：

• HTTPS 证书在几秒内配置完成。
• HTTP 流量自动重定向到 HTTPS。
• 证书在到期前自动续期（每 60 天）。
• 同时支持 RSA 和 ECDSA 证书。

通配符域名

通配符域名允许你将一个域名的所有子域名路由到单个应用。这对于每个客户都有自己子域名的多租户应用非常有用。

Type: A
Name: *
Value: YOUR_SERVER_IP
TTL: 3600

在 sh0 控制台中，将通配符域名添加为 *.example.com。你的应用将在请求头中接收完整的主机名，并可据此进行路由。

域名状态指示器

控制台为每个域名显示状态标记。以下是每种状态的含义：

DNS 故障排查

如果域名卡在 待处理 或 错误 状态，请尝试以下步骤：

本地检查 DNS 记录：

dig example.com +short
dig CNAME app.example.com +short

验证服务器在 80 和 443 端口是否可达：

curl -I http://YOUR_SERVER_IP
curl -I https://YOUR_SERVER_IP

常见问题和解决方案：

• DNS 未传播：等待最多 48 小时，或使用较低的 TTL 值。
• 防火墙阻止 80/443 端口：确保服务器防火墙允许入站 HTTP 和 HTTPS 流量。
• Cloudflare 代理干扰：切换到仅 DNS 模式（灰色云朵）或在 Cloudflare 中配置完全（严格）SSL。
• IP 地址错误：使用 curl ifconfig.me 仔细检查服务器的公共 IP。
• 速率限制：Let's Encrypt 有速率限制（每个域名每周 50 个证书）。如果达到限制，请等待或使用测试证书。