Files
xiaoyin-markdown/site
Jidekin 9a788dadfb feat(update): 在线升级 —— 界面一键检查版本、自动覆盖安装并重启
老板要求:软件里点「在线升级」校验版本号,直接在线覆盖安装、重启;
升级服务放在 https://md.wangjinding.com。

一、服务端(md.wangjinding.com)
  · 升级清单 GET /update/latest.json(nginx 单独 location,强制 no-store,带 CORS)
      { version, notes, pub_date, platforms.windows-x86_64: { signature, url, size, sha256 } }
  · 安装包走现有 /download/;另加稳定别名 latest-setup.exe / latest-portable.exe
    —— 官网页固定链到别名,以后发版不用改 HTML
  · tools/release/publish.py:一条命令完成「拷安装包 → 写清单 → 更新别名 → 打校验值」
  · 官网页的版本号改成从 latest.json 拉(data-ver),发版后自动跟随

二、客户端(Tauri updater 官方插件,不是自己下 exe 硬跑)
  · 新增 tauri-plugin-updater + tauri-plugin-process
  · 命令 check_update() → { available, current, version, notes, date }
         install_update() → 下载 + 校验签名 + 静默覆盖安装 + restart
  · 签名用 minisign:私钥 /root/.tauri/xiaoyin-md-updater.key(600,**不在仓库里**),
    公钥写进 tauri.conf.json;安装包被篡改会被客户端直接拒装
  · 工具条新增升级按钮(仅 Tauri 版显示);点击 → 查版本 → 有新版弹窗(带更新说明)
    → 「立即升级」显示下载进度条 → 装完自动重启
  · 版本号 2.6.1 → 2.6.2

三、已验证
  · 构建出 XiaoyinMarkdown_2.6.2_x64-setup.exe(2.21 MB)+ .sig(448B)
  · 用 cryptography 按 minisign 规则**真验了一遍签名**:Ed25519 + BLAKE2b 预哈希 → 通过
  · /update/latest.json 200 / application/json / no-store;sha256 与清单一致
  · latest-setup.exe / latest-portable.exe 均 200

注意:2.6.1 是**没有升级器**的版本,老用户要手动装一次 2.6.2;
    从 2.6.2 起才能在软件里一键升级。
2026-11-20 10:22:26 +08:00
..

官网部署说明(md.wangjinding.com)

链路

访客 ──https://md.wangjinding.com:443──► EdgeOne 边缘(免费 TrustAsia 证书)
                                          │ 回源 HTTPS 8443,Host=加速域名
                                          ▼
                             <回源域名>:8443 ──(光猫映射)──► .8 的 OpenResty
                                                                        │ server_name 分流
                                                                        ▼
                                                              /opt/1panel/www/sites/md.wangjinding.com/index

各部分落在哪

环节 位置 / 参数
站点根目录 /opt/1panel/www/sites/md.wangjinding.com/index
nginx 配置 /opt/1panel/www/conf.d/md.wangjinding.com.conf(8082 + 8443 ssl)
源站证书 /opt/1panel/www/sites/md.wangjinding.com/ssl/(acme.sh + 阿里云 DNS-01,自动续期)
安装包 index/download/XiaoyinMarkdown-win32-x64.zip
EdgeOne zone zone-xxxxxxxx,加速域名 md.wangjinding.com,回源 HTTPS/8443
WAF 白名单 1pwaf/data/conf/sites.json + 1pwaf/data/sites/md.wangjinding.com/config.json
DNS 阿里云 md CNAME → md.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):

-- websites:type='static',proxy 留空,site_dir='/'
insert into websites (..., protocol, primary_domain, type, alias, status, http_config, proxy, site_dir, ...)
values (..., 'HTTPS', 'md.wangjinding.com', 'static', 'md.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/md.wangjinding.com.conf。

更新页面

cp site/index.html /opt/1panel/www/sites/md.wangjinding.com/index/
docker exec 1Panel-openresty-npAh nginx -s reload   # 一般不需要,静态文件直接生效

更新安装包

官网主下载项是 Tauri 安装包(1.6 MB,装完 .md 默认用它打开):

# 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/md.wangjinding.com/index/download/
cp $R/xiaoyin-markdown.exe \
   /opt/1panel/www/sites/md.wangjinding.com/index/download/XiaoyinMarkdown-portable.exe

旧版 Electron 构建(XiaoyinMarkdown-win32-x64.zip,152 MB)仍保留在 download/ 里。

坑

  • WAF 白名单:不往 sites.json 加 {"key": "<域名>", "host": ["<域名>:8082"]}, 就会本机 200、公网 403「网站不存在」(本次踩过)。
  • EdgeOne 过渡期:新加速域名 process 状态下访问会被边缘直接 Reset(curl 显示 000), 证书 applying → processing → deployed,全程约 10–15 分钟,别当成配错了。
  • 缓存:站点级策略是 NoCache,152MB 的安装包每次都回源(走家宽上行)。 要提速得在 EdgeOne 给 /download/* 单独加缓存规则。
  • 带宽账:EO 免费额度 50GB/月,单次下载 152MB → 每月约 330 次。