跳到主要内容

安装部署总览

Ithiltir 的部署对象有两个：Dash 主控端和 Ithiltir-node 节点端。Dash 必须先可用，节点脚本和节点二进制都由 Dash 的 /deploy 分发。

选择部署路径​

路径适用场景入口
快速验证单机、小规模、自用快速开始
单机生产Dash、PostgreSQL、TimescaleDB、Redis 同机单机 all-in-one 部署
标准生产Dash + 反向代理 + 独立数据库运维生产部署检查清单
源码验证开发、排错、验证配置源码和手工运行

部署顺序​

  1. 确认系统属于安装脚本支持的 systemd Linux 发行版。
  2. 下载并解压 Dash 发布包。
  3. 执行 install_dash_linux.sh。
  4. 按提示配置 app.public_url、数据库、Redis、管理员密码和反向代理信任网段。
  5. 让安装脚本执行数据库迁移并启动 dash.service。
  6. 配置反向代理，确认 /api、/theme、/deploy 和 / 同源可访问。
  7. 在管理台创建节点。
  8. 用 Dash 提供的安装脚本安装节点。

发布包安装脚本会检测 PostgreSQL 16+、TimescaleDB 和 Redis。缺失或版本不满足时，脚本会按发行版使用系统包管理器处理，必要时提示源码安装 Redis。Debian/Ubuntu 等 apt-get 系统不需要提前手工安装这些依赖。

推荐部署形态是：域名 + HTTPS + Nginx/Caddy 反向代理。Dash 后端监听本机或内网端口，例如 127.0.0.1:8080，外部只访问 https://dash.example.com/。直接 http://IP:端口 暴露 Dash 只适合临时验证和受控内网测试。

部署边界​

边界约束
Dash单实例运行，不支持多个 Dash 同时写同一套状态
PostgreSQL保存节点、指标、流量、告警、设置和主题元数据
Redis保存会话、热点快照和告警运行时状态
反向代理生产环境推荐前置 Nginx/Caddy/负载均衡，并保持同源根路径
节点通过 Push 模式访问 Dash 的 /api/node/*

网络路径​

Dash 对浏览器和节点公开：

https://dash.example.com/
https://dash.example.com/api
https://dash.example.com/theme
https://dash.example.com/deploy

节点默认向：

https://dash.example.com/api/node/metrics

上报指标。静态信息会发送到同级：

https://dash.example.com/api/node/static

关键限制​

  • app.public_url 必须是根路径 URL，不能带 /dash 这类路径前缀。
  • 生产环境 app.public_url 推荐使用 HTTPS 域名，不推荐直接 IP+HTTP。
  • 反向代理必须保持同源路径，不要把前端改成跨域 API。
  • 节点 secret 只用于 /api/node/*，不能放进浏览器代码。
  • Dash 是单实例应用，不能多进程同时写同一个数据库。
  • --no-redis 是降级模式，运行时状态重启后丢失。

相关文档​