Files
xiaoyin-markdown/site/README.md
T
Jidekin 31d6d7b3b9 feat(domain)!: 彻底下线旧域名 md.wangjinding.com
老板要求不再兜底,直接删掉旧域名的全部基础设施。

前置风险处理
  xymd 站点的 index 原来是**软链到 md 目录**的,直接删 md 会把新站一起删掉。
  先把 xymd/index 换成真实目录(复制 383MB / 21 个文件,md5 校验一致),
  确认新站能独立服务后,才开始拆旧站。

拆除清单(全部完成)
  · OpenResty:conf.d/md.wangjinding.com.conf 删除、站点目录移除
  · 1Panel DB:websites / website_ssls / website_domains 三张表的记录都清掉
  · WAF:sites.json 条目 + data/sites/md.wangjinding.com/ 目录(移入回收站)
  · EdgeOne:先停用(offline)再 DeleteAccelerationDomains —— 直接删会报
    OperationDenied.AccelerationDomainStatusNotInOffline
  · DNS:md CNAME 记录删除,公网已无法解析
  · acme.sh:--remove 掉 md 的证书登记,目录移入回收站(DNS 已删,留着只会续期失败)

应用侧
  · tauri.conf.json 的 updater endpoints 去掉 md,只剩 xymd
  · 版本 2.6.7,Windows + Linux 重编发布
  · main.rs / site/README 里的旧域名叙述同步改成「已停用」

影响说明
  2.6.6 及更早的客户端内置的地址里含 md,现在会走 xymd(列在第一位),
  所以仍能升级到 2.6.7;2.6.7 之后只认新域名。
2026-11-20 15:18:33 +08:00

94 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 官网部署说明(xymd.wangjinding.com)
> **2026-11-20 域名迁移完成**:官网从 `md.wangjinding.com` 迁到 `xymd.wangjinding.com`。
> 旧域名已**彻底下线** —— EdgeOne 加速域名、1Panel 站点、WAF 条目、DNS 记录、acme 证书全部删除。
> 站点根目录现在是真的独立目录(`/opt/1panel/www/sites/xymd.wangjinding.com/index`),
> 不再是软链,删旧站不会影响新站。
## 链路
```
访客 ──https://xymd.wangjinding.com:443──► EdgeOne 边缘(免费 TrustAsia 证书)
│ 回源 HTTPS 8443,Host=加速域名
▼
wangjinding.dynv6.net:8443 ──(光猫映射)──► .8 的 OpenResty
│ server_name 分流
▼
/opt/1panel/www/sites/xymd.wangjinding.com/index
```
## 各部分落在哪
| 环节 | 位置 / 参数 |
| --- | --- |
| 站点根目录 | `/opt/1panel/www/sites/xymd.wangjinding.com/index` |
| nginx 配置 | `/opt/1panel/www/conf.d/xymd.wangjinding.com.conf`(8082 + 8443 ssl)|
| 源站证书 | `/opt/1panel/www/sites/xymd.wangjinding.com/ssl/`(acme.sh + 阿里云 DNS-01,自动续期)|
| 安装包 | `index/download/XiaoyinMarkdown-win32-x64.zip` |
| EdgeOne | zone `zone-3w6r6pp5u2qa`,加速域名 `xymd.wangjinding.com`,回源 HTTPS/8443 |
| WAF 白名单 | `1pwaf/data/conf/sites.json` + `1pwaf/data/sites/xymd.wangjinding.com/config.json` |
| DNS | 阿里云 `xymd` CNAME → `xymd.wangjinding.com.eo.dnse2.com`(TTL 600)|
## 在 1Panel 面板里可见(重要)
只建 `conf.d/*.conf` + 站点目录,**面板列表里是看不到的** —— 面板的「网站」页读的是
`/opt/1panel/db/agent.db` 的 `websites` 表。要让站点出现在面板里、能用面板的「配置」页管理,
必须往库里登记(本次已登记:`websites.id=11`、`website_domains`、`website_ssls.id=15`):
```sql
-- websites:type='static',proxy 留空,site_dir='/'
insert into websites (..., protocol, primary_domain, type, alias, status, http_config, proxy, site_dir, ...)
values (..., 'HTTPS', 'xymd.wangjinding.com', 'static', 'xymd.wangjinding.com', 'Running',
'HTTPToHTTPS', '', '/', ...);
-- website_domains:(website_id, domain, ssl=0, port=8082)
-- website_ssls:(primary_domain, private_key, pem, key_type='EC256', type='YE2',
-- expire_date, start_date, status='ready', auto_renew=1)
-- 再把 websites.website_ssl_id 指过去
```
注意:
- `website_ssls` 的布尔列必须是 0/1(写 `''` 会让面板整页 `sql: Scan error`)。
- 证书内容直接从 `sites/<域名>/ssl/{fullchain,privkey}.pem` 读进去,面板的「证书」页才显示得出来。
- 面板刷新后即可见(Ctrl+F5);若没出现,`systemctl restart 1panel-agent` 一次。
- ⚠️ **在面板里改这个站点的配置时,nginx conf 会被面板模板重写** ——
我加的 `Strict-Transport-Security` 头、`/download/` 的 `Content-Disposition: attachment`
可能会丢,改完记得复查 `conf.d/xymd.wangjinding.com.conf`。
## 更新页面
```bash
cp site/index.html /opt/1panel/www/sites/xymd.wangjinding.com/index/
docker exec 1Panel-openresty-npAh nginx -s reload # 一般不需要,静态文件直接生效
```
## 更新安装包
官网主下载项是 **Tauri 安装包**(装完 .md 默认用它打开):
```bash
# 1) 交叉编译 Windows 安装包(详见仓库 README「用 Tauri 打包」)
npx tauri build --target x86_64-pc-windows-gnu --bundles nsis
# 2) 发布
R=src-tauri/target/x86_64-pc-windows-gnu/release
cp $R/bundle/nsis/XiaoyinMarkdown_2.6.1_x64-setup.exe \
/opt/1panel/www/sites/xymd.wangjinding.com/index/download/
cp $R/xiaoyin-markdown.exe \
/opt/1panel/www/sites/xymd.wangjinding.com/index/download/XiaoyinMarkdown-portable.exe
```
旧版 Electron 构建(`XiaoyinMarkdown-win32-x64.zip`)仍保留在 `download/` 里。
## 坑
- **WAF 白名单**:不往 `sites.json` 加 `{"key": "<域名>", "host": ["<域名>:8082"]}`,
就会**本机 200、公网 403「网站不存在」**(本次踩过)。
- **EdgeOne 过渡期**:新加速域名 `process` 状态下访问会被边缘直接 Reset(curl 显示 000),
证书 `applying → processing → deployed`,全程约 10–15 分钟,别当成配错了。
- **缓存**:站点级策略是 NoCache,主安装包(Tauri 版,2 MB 左右)每次回源压力不大;
但旧的 Electron 包有 152MB,有人下就整包走家宽上行。
要提速得在 EdgeOne 给 `/download/*` 单独加缓存规则。
- **带宽账**:EO 免费额度 50GB/月。按 2 MB 的 Tauri 包算够下两万多次;
按 152MB 的 Electron 包算只有 330 次左右 —— 所以主下载项别指回 Electron 包。