老板要求:用 Tauri 打包成 exe,安装后 .md 默认由小银 Markdown 打开。 一、交叉编译(Linux → Windows,无需 Windows 机器) 本机从零装了 rustc 1.100 / mingw-w64(GCC 14)/ NSIS 3.11, target `x86_64-pc-windows-gnu`,crates 走清华镜像: npx tauri build --target x86_64-pc-windows-gnu --bundles nsis 产物: · XiaoyinMarkdown_2.6.1_x64-setup.exe 1.52 MiB(NSIS 安装包) · xiaoyin-markdown.exe 3.5 MiB(免安装版) electron-packager 那版是 152 MiB —— 因为 Tauri 用系统 WebView2,不捆绑运行时。 已核对导入表:只依赖系统 DLL + 安装包内自带的 WebView2Loader.dll, 没有 libgcc_s_seh-1 / libwinpthread 之类的 mingw 运行时依赖,干净 Windows 可跑。 二、默认打开方式(两步,缺一不可) 1. tauri.conf.json 的 fileAssociations 早就配了 md/markdown/mdown/mkd/mdwn/txt; 已核对生成的 installer.nsi:6 条 APP_ASSOCIATE,写 HKCU\Software\Classes\.md = XiaoyinMarkdown.Document(默认 ProgId,不只是「打开方式」列表) 2. 新增 src-tauri/installer-hooks.nsh(NSIS_HOOK_POSTINSTALL): 删掉 HKCU\...\Explorer\FileExts\.md\UserChoice —— 这个键带哈希保护、只能删不能写, 不删的话用户原来的默认程序永远赢;删完再 SHChangeNotify 刷新图标缓存。 已用「故意 !error 探针」证明该钩子确实被 makensis 编译进去(installer.nsi:758), 不是写了没生效。 三、首次双击 .md 能打开文件 原来只有 single_instance 回调处理 argv(= 程序已在运行时才生效)。 新增 on_page_load(Finished) + std::sync::Once:冷启动时把 argv 里的文件路径 emit 给前端(前端 tauri-bridge 监听 open-external → doOpenPath)。 四、官网 下载区改成三档:安装版(1.6MB,推荐)/ 免安装 exe(3.5MB)/ 源码 + 旧 Electron 版。 两个新文件已部署到 /download/,公网 200。 README 补了「用 Tauri 打包」整节(含 UserChoice 这个坑),site/README 更新发布步骤。
官网部署说明(md.wangjinding.com)
链路
访客 ──https://md.wangjinding.com:443──► EdgeOne 边缘(免费 TrustAsia 证书)
│ 回源 HTTPS 8443,Host=加速域名
▼
wangjinding.dynv6.net: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-3w6r6pp5u2qa,加速域名 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 次。