# 药药联 · 红包商城 —— 子域名规划与公众号/小程序配置指引

> 更新：2026-11-09
> 适用环境：腾讯云 h20（公网 159.75.182.62 / Tailscale 100.124.33.108）

---

## 一、子域名规划（已全部解析并路由生效）

| 子域名 | 用途 | 当前状态 |
|---|---|---|
| `yaoyaolian.cn` / `www.yaoyaolian.cn` | **官网**（医药营销前台 pharma） | ✅ DNS 已指向 159.75.182.62；h20 nginx 已按子域名分流（实测标题「药药联·红包商城·种草·科普·领任务·兑红包」） |
| `admin.yaoyaolian.cn` | **管理后台**（平台端/商家端） | ✅ 已分流（标题「药药联·红包商城」）；旧入口 `:8082` 兼容保留 |
| `clerk.yaoyaolian.cn` | **店员端 H5** | ✅ 已分流（标题「药药联·红包店员端」） |
| `m.yaoyaolian.cn` | **商城 H5 / 客户端**（uni-app） | ✅ 已分流 |
| `api.yaoyaolian.cn` | **后端 API**（小程序 / 客户端 request 合法域名） | ✅ 已分流；`/prod-api`、`/app-api`、`/pay/notify` 已反代 |
| `open.yaoyaolian.cn` | **公众号 / 开放平台**（校验文件 + 网页授权回跳占位） | ✅ 已分流 |

> DNS 全部为 A 记录 → `159.75.182.62`，已在腾讯云 DNSPod 配好（含新增的 `open`）。
> 部署配置已归档：`deploy-prod/nginx/ydb-hb-h20-live.conf`（实际生效版）、`.bak`（改前备份）。

---

## 二、最关键的一关：ICP 备案

**公网用域名访问（www / admin / 等）目前被腾讯云拦截，原因是域名 `yaoyaolian.cn` 备案未完成。**

- 备案通过前：域名（含子域名）在公网会被腾讯云返回「未备案」拦截页；**裸 IP `https://159.75.182.62` 可访问**（证书对域名不匹配，浏览器警告，可用下方 hosts 法消除）。
- 备案通过后：域名自动全网可用，无需改任何配置。

### 备案前如何内测（干净证书、无警告）

在你**自己的电脑**用管理员身份改 `C:\Windows\System32\drivers\etc\hosts`，加：

```
100.124.33.108  yaoyaolian.cn
100.124.33.108  www.yaoyaolian.cn
100.124.33.108  admin.yaoyaolian.cn
100.124.33.108  clerk.yaoyaolian.cn
100.124.33.108  m.yaoyaolian.cn
100.124.33.108  api.yaoyaolian.cn
100.124.33.108  open.yaoyaolian.cn
```

> `100.124.33.108` 是 h20 的 Tailscale 内网 IP，**仅连了 Tailscale 的设备**能解析到它。改完直接用 `https://www.yaoyaolian.cn`（或 admin/clerk/m）打开，通配符证书有效、无警告。备案通过后删掉这几行即可。

---

## 三、公众号（服务号）认证 + 域名配置

### 现在就能做（不需要备案）

1. 微信公众平台（mp.weixin.qq.com）申请**服务号**（企业主体，需营业执照、对公账户打款验证）。
2. 完成**微信认证**（¥300/年）。认证后的服务号可**复用资质快速注册并认证小程序**，省下小程序 ¥300。
3. 准备素材：企业 logo、简介、菜单规划（官网入口、红包商城入口、店员端入口等）。

### 备案通过后才能做（微信要求域名已备案）

公众号后台「设置 → 公众号设置 → 功能设置」三项需填 `yaoyaolian.cn` 相关域名并上传校验文件：
- **业务域名**
- **JS 接口安全域名**
- **网页授权域名**

我方已配好 nginx 校验文件服务：把微信下发的 `MP_verify_xxxx.txt` 放到 h20 的
`/home/ubuntu/ydb-hb/nginx/../` → 实际路径容器为 `/usr/share/nginx/html/verify/`（`/usr/share/nginx/html/verify/MP_verify_xxxx.txt`），即可在 `https://www.yaoyaolian.cn/MP_verify_xxxx.txt`（或 open/api 子域名根）通过验证。

> 操作由我方在备案通过后执行（TAT 远程放文件 + reload），你只需把微信下发的 txt 给我。

---

## 四、小程序（员工端）域名配置

1. 拿到小程序 AppID（复用公众号认证注册，或单独注册）。
2. 小程序后台「开发 → 开发管理 → 开发设置 → 服务器域名」：
   - **request 合法域名**：`https://api.yaoyaolian.cn`
   - uploadFile / downloadFile / socket 合法域名：同上（按需要）
3. 同样需**域名已备案 + HTTPS**，校验文件放 `api.yaoyaolian.cn` 根（我方已配 `MP_verify` 服务）。
4. 小程序代码包（uni-app）我方已就绪，AppID 一下来当天即可对接 `api.yaoyaolian.cn` 联调、提交审核、发布。

---

## 五、待办与阻塞项（诚实标注）

| 项 | 状态 | 阻塞 |
|---|---|---|
| DNS 二级域名 | ✅ 完成 | — |
| 安全组 80/443 | ✅ 完成 | — |
| nginx 子域名分流（h20） | ✅ 已部署并实测 | — |
| ICP 备案 | ⏳ 进行中 | 官方审核周期，约 1–3 周 |
| 公众号服务号 + 认证 | ⏳ 待你方申请 | 需企业资质 |
| 微信侧域名配置 | ⏳ 待备案 | 微信要求域名已备案 |
| 小程序 AppID + 联调 | ⏳ 待 AppID | 复用认证或单独注册 |
| admin 后台加 IP 白名单 / basic auth | ⬜ 建议上线前做 | 公网暴露后台的安全加固 |