Files
xiaoyin-markdown/site/README.md
T
Jidekin 81c90ed060 feat(build): Tauri 交叉编译出 Windows 安装包(1.6MB),装完 .md 默认用它打开
老板要求:用 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 更新发布步骤。
2026-11-19 20:00:55 +08:00

87 lines
4.3 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.
# 官网部署说明(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`):
```sql
-- 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`。
## 更新页面
```bash
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 默认用它打开):
```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/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 次。