增加自定义绑定域名

docs/自有域名绑定说明.md

@@ -0,0 +1,117 @@
+# 绑定自有域名操作说明（给租户看的版本）
+
+把你自己的域名（例如 `www.你的公司.com`）指向平台，访客访问时打开的还是你在后台配置的那套官网内容，与平台分配的二级域名完全一致。HTTPS 证书由系统自动申请与续期，你不需要买证书、不需要上传证书。
+
+整个过程三步：**填域名 → 加解析 → 点检测**。
+
+---
+
+## 一、填域名
+
+后台 →「我的域名」→ 右上角「绑定自有域名」。
+
+填写规则：
+
+- 填完整域名，例如 `www.example.com`；
+- 不要带 `http://`、`https://`，不要带路径和端口；
+- 根域名（`example.com`）和 `www.example.com` 是两个不同的域名。想两个都能访问，就绑两次；
+- 域名必须已完成实名认证与备案（国内服务器要求），否则解析能通但访问会被拦。
+
+提交后会看到一条记录，状态是「待生效」，这是正常的——还没加解析。
+
+---
+
+## 二、加解析
+
+弹窗里会显示平台给你的解析目标。到你买域名的地方（阿里云、腾讯云、DNSPod 等）的「域名解析」里添加记录：
+
+### 子域名（如 www、cn、shop）
+
+| 记录类型 | 主机记录 | 记录值 |
+|---|---|---|
+| CNAME | www | 弹窗里显示的 CNAME 目标 |
+
+### 根域名（如 example.com 本身）
+
+根域名在 DNS 标准里不能用 CNAME，只能用 A 记录：
+
+| 记录类型 | 主机记录 | 记录值 |
+|---|---|---|
+| A | @ | 弹窗里显示的 IP |
+
+几个容易踩的点：
+
+- **主机记录填 `www`，不要填 `www.example.com`**。解析商会自动补上域名后缀，填全了会变成 `www.example.com.example.com`。
+- **同一个主机记录下不能既有 CNAME 又有 A/MX 记录**。如果 `www` 已经有 A 记录指向别处，先删掉再加 CNAME。
+- **有 CDN 的先关掉**。域名挂在 CDN 上时解析指向的是 CDN 节点，系统检测不到平台地址，证书也签不下来。
+- **TTL 用默认值就行**。修改解析后需要等 TTL 时间生效，通常 10 分钟内，最长可能要几小时。
+
+---
+
+## 三、点检测
+
+回到「我的域名」，在这条自有域名记录上点「检测解析」。
+
+- 解析已生效 → 提示「正在申请 HTTPS 证书」。等 1～2 分钟刷新页面，「证书」列变成「已签发」、状态变成「已生效」，域名就能用了；
+- 解析没生效 → 提示当前解析到了哪里，对照第二步核对记录值，等一会儿再点。
+
+生效后用 `https://你的域名` 访问，看到的就是你的官网。
+
+---
+
+## 四、状态怎么看
+
+「我的域名」列表里有三列状态：
+
+| 列 | 取值 | 含义 |
+|---|---|---|
+| 状态 | 待生效 | 解析或证书还没就绪，暂时不能访问 |
+| 状态 | 已生效 | 可以正常访问 |
+| 状态 | 已禁用 | 被平台停用，联系平台管理员 |
+| 解析检测 | 未检测 / 已通过 / 未通过 | 鼠标悬浮看具体原因 |
+| 证书 | 待处理 / 签发中 / 已签发 / 签发失败 | 悬浮「已签发」看到期时间，悬浮「签发失败」看失败原因 |
+
+证书到期前系统会自动续期，你不用管。
+
+---
+
+## 五、常见问题
+
+**点了检测一直提示解析未生效**
+
+用命令行确认解析实际指向哪里（Windows 用 `nslookup`，Mac/Linux 用 `dig`）：
+
+```bash
+nslookup www.example.com
+dig +short www.example.com
+```
+
+看返回的结果是不是弹窗里给的目标。如果不是，说明记录没加对或者还没生效。
+
+**证书显示「签发失败」**
+
+悬浮在「签发失败」上看原因，常见两种：
+
+- 提到 80 端口或验证失败：你的域名可能开了强制 HTTPS 跳转，或者解析被 CDN 拦了。证书颁发机构需要通过 80 端口访问 `http://你的域名/.well-known/acme-challenge/...` 来验证域名归属；
+- 提到频率限制：短时间内失败次数太多。系统有 30 分钟冷却，等半小时再试。
+
+**能不能同时用平台二级域名和自己的域名**
+
+可以，两个都能访问同一套官网内容，互不影响。
+
+**换域名怎么办**
+
+先删掉旧的那条记录，再绑新域名。删除后旧域名立即无法访问，已签发的证书也不再续期。
+
+**一个租户能绑几个自有域名**
+
+一个。需要多绑（比如根域名和 www 都要）请联系平台管理员。
+
+---
+
+## 六、需要联系平台的情况
+
+- 弹窗提示「平台尚未配置解析目标」；
+- 提示「该域名已被绑定」但你确认没绑过；
+- 提示「该域名属于平台域名」——这种情况请改用「申请二级域名」；
+- 检测通过但证书连续失败超过一天。