Files
xiaoyin-markdown/site/README.md
T
Jidekin 8578bdbaff docs(site): 去掉写死的安装包体积(已从 1.6MB 变成 2.2MB)
老板指出:安装包已经不是 1.6 MB 了,官网上这个数字要拿掉。

加了在线升级的 updater 插件(reqwest + 签名校验 + zip)后,安装包从 1.6MB 变成 2.2MB,
以后再改依赖还会变 —— 所以**不写死数字**,避免每发一版就要改文案:

  · meta description:删掉「安装包仅 1.6 MB」
  · 首屏状态胶囊:改为「v2.6.2 已发布 · 支持在线升级」
    (顺手修了个渲染 bug:`.kv-tag` 是 inline-flex + gap,插进 <span> 后
      "v" 和版本号之间多了一个 9px 空隙 —— 把整段包一层 span 解决)
  · 信任胶囊:安装包 1.6 MB → 免装运行时
  · 深色区卖点:1.6 MB,秒装 → 免装运行时,秒装
  · 下载卡副标题:1.6 MB · Windows x64 → Windows 10 / 11 · x64
                   3.5 MB · 单个 exe → 单个 exe · 免安装
  · 旧版 Electron 也不再写 152 MB(改为「体积大得多」)
  · README / site/README 同样去掉写死的体积;带宽那段改成按量级说明

版本号仍然是 /update/latest.json 动态拉的,发版不用动页面。
2026-11-20 10:27:48 +08:00

89 lines
4.5 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=加速域名
▼
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`):
```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 安装包**(装完 .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`)仍保留在 `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 包。