跳到主要内容

部署资产

Dash 格式 v1 发布包携带 Ithiltir-node 二进制和安装脚本，并通过 /deploy 分发给节点。

安装脚本模板公开可读。打包携带的节点二进制和 runner 资产需要 X-Node-Secret，或使用 Dash 为旧 Node 自动升级生成的短期 upgrade_token。安装脚本下载节点二进制时会发送 X-Node-Secret。

受保护资产响应使用 Cache-Control: private, no-store，并返回 Vary: X-Node-Secret，不得由共享缓存保存。

release.env 记录 Dash 版本、Node 版本、目标 OS/架构和下表 7 个资产的 SHA-256。更新器在停止在线服务前校验 manifest、全部摘要以及候选 Dash 报告的 Dash/Node 版本。

HTTP 路径​

路径内容
/deploy/linux/install.shLinux 节点安装脚本
/deploy/macos/install.shmacOS 节点安装脚本
/deploy/windows/install.ps1Windows 节点安装脚本
/deploy/linux/node_linux_amd64Linux amd64 节点二进制
/deploy/linux/node_linux_arm64Linux arm64 节点二进制
/deploy/macos/node_macos_arm64macOS arm64 节点二进制
/deploy/windows/node_windows_amd64.exeWindows amd64 节点二进制
/deploy/windows/node_windows_arm64.exeWindows arm64 节点二进制
/deploy/windows/runner_windows_amd64.exeWindows amd64 runner
/deploy/windows/runner_windows_arm64.exeWindows arm64 runner

安装脚本里的下载 scheme、host 和路径来自 app.public_url。因此 app.public_url 必须是节点可访问的真实地址。安装脚本提示语言跟随 Dash app.language。

生产环境应使用 HTTPS 域名作为 app.public_url，并通过 Nginx/Caddy 反向代理到 Dash。直接 http://IP:端口 会把节点安装、二进制下载和上报入口都固定到裸 HTTP 地址，只应作为临时验证使用。

Linux、macOS 和 Windows 安装器手工处理重定向，最多 5 次。目标必须保持初始主机；同协议跳转必须保持有效端口；只允许 HTTP 升级到 HTTPS，不允许降级。通过校验后才向下一跳发送 X-Node-Secret。

Linux systemd 安装在存在 cc、gcc 或 clang 时编译 root 侧连接数 helper，并每秒刷新。OpenRC 和无法编译 helper 的主机使用 Node 内置统计，可能缺失容器连接数据。

本地节点资产布局​

打包 Dash 时可以用 --node-local 或 --node-local-dir 从本地读取节点资产。接受两种布局。

目录布局：

linux/node_linux_amd64
linux/node_linux_arm64
macos/node_macos_arm64
windows/node_windows_amd64.exe
windows/node_windows_arm64.exe
windows/runner_windows_amd64.exe
windows/runner_windows_arm64.exe

扁平 release asset 命名：

Ithiltir-node-linux-amd64
Ithiltir-node-linux-arm64
Ithiltir-node-macos-arm64
Ithiltir-node-windows-amd64.exe
Ithiltir-node-windows-arm64.exe
Ithiltir-runner-windows-amd64.exe
Ithiltir-runner-windows-arm64.exe

打包示例​

bash scripts/package.sh \
  --version 1.2.3-alpha.1 \
  --node-version 1.2.3-alpha.1 \
  --node-local \
  -o release \
  -t linux/amd64 \
  --tar-gz

省略 --node-version 时，脚本会从 https://github.com/Ithildur/Ithiltir-node.git 解析最新兼容 tag。正式打包还会检查 dist/index.html 和 dist/theme-bootstrap.js 非空，并且只把 configs/config.example.yaml 放入发布包。