Files
xiaoyin-markdown/site/README.md
T
Jidekin 1c3bc5681c feat(domain): 官网迁移到 xymd.wangjinding.com(应用/文档/发布链路全换)
老板要求:把官网换成 xymd.wangjinding.com,EdgeOne、1Panel、git、文档、
更新服务地址都要换掉。

基础设施(本机侧,已实测)
  · 1Panel 新站点 xymd.wangjinding.com:静态站,index 软链到 md 的 index
    —— 两个域名共用同一份文件,不搞双份维护
    index 软链必须用**相对路径**(../md.wangjinding.com/index):
    宿主机绝对路径 /opt/1panel/www/... 在容器里解析不到(容器内是 /www)
  · Let's Encrypt 证书(acme.sh + 阿里云 DNS-01,自动续期)
  · WAF 白名单 + 1Panel DB 登记(克隆 md 的 websites/website_ssls 两行;
    注意 SQLite 里 group 是保留字,插入时要给列名加双引号)
  · EdgeOne 加速域名:回源 HTTPS/8443,Host=加速域名,免费边缘证书 deployed
  · DNS:xymd CNAME → xymd.wangjinding.com.eo.dnse2.com

应用与代码
  · tauri.conf.json:updater endpoints 改为 [xymd, md] —— **md 保留为兜底**,
    否则已经装出去的 2.6.5 客户端会拉不到更新清单,直接断更
  · 版本 2.6.6,Windows + Linux 双端重编
  · publish.py:BASE_URL/SITE_ROOT 改新域名;另外加了**版本校验** ——
    只收版本号对得上的产物。之前它会把 target/ 里上一版 2.6.5 的
    AppImage 改名成 2.6.6 发出去(清单写新版、二进制是旧的,升级静默失败)
  · README / site/README / wiki 路径全部改成新域名

发布
  · 2.6.6 已发布:latest.json 指向 xymd,windows 2.16MB / linux AppImage 103.62MB
  · 公网实测:首页 200、清单 200、三端安装包 206、EdgeOne 头正常

顺带
  · 博客文章里的下载链接同步换成新域名 + 2.6.6
  · 公众号草稿的「阅读原文」改成 https://xymd.wangjinding.com
2026-11-20 15:00:13 +08:00

89 lines
4.4 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)
## 链路
```
访客 ──https://xymd.wangjinding.com:443──► EdgeOne 边缘(免费 TrustAsia 证书)
│ 回源 HTTPS 8443,Host=加速域名
▼
<回源域名>:8443 ──(光猫映射)──► .8 的 OpenResty
│ server_name 分流
▼
/opt/1panel/www/sites/<域名>/index
```
## 各部分落在哪
| 环节 | 位置 / 参数 |
| --- | --- |
| 站点根目录 | `/opt/1panel/www/sites/<域名>/index` |
| nginx 配置 | `/opt/1panel/www/conf.d/<域名>.conf`(8082 + 8443 ssl)|
| 源站证书 | `/opt/1panel/www/sites/<域名>/ssl/`(acme.sh + 阿里云 DNS-01,自动续期)|
| 安装包 | `index/download/XiaoyinMarkdown-win32-x64.zip` |
| EdgeOne | zone `zone-xxxxxxxx`,加速域名 `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/<域名>/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/<域名>/index/download/
cp $R/xiaoyin-markdown.exe \
/opt/1panel/www/sites/<域名>/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 包。