跳到主要内容

部署资产

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

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

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 节点安装脚本会在存在 cc、gcc 或 clang 时编译 root 侧连接数 helper，用于完整统计主机和容器网络命名空间 TCP/UDP 连接数。没有编译器时，节点会使用自带连接数统计，可能缺失容器连接数据。

本地节点资产布局​

打包 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。