安装与部署
Sight DataLink 的安装方式:原生安装包(Linux/systemd)、Sight 部署助手、Docker Compose,以及安装向导、元数据库和健康检查。
概述
Sight DataLink 以单个进程运行(Spring Boot,需要 JDK 21 及以上),同时提供 UI 与 /api,默认端口 18680。
| 方式 | 适用场景 |
|---|---|
| 原生安装包(zip) | Linux 服务器长期运行,注册为 systemd 服务 |
| Sight 部署助手 | 在部署助手中选择产品 sight-datalink,自动下载安装包并注册服务 |
| Docker Compose | 5 分钟体验或容器化部署,含 PostgreSQL 元数据库与示例数据源 |
安装向导
以 prod 配置启动且没有配置元数据库时,自动进入安装向导:
- 在启动日志中找到「初始化令牌」,例如:
journalctl -u sight-datalink | grep 初始化令牌。 - 浏览器打开
http://服务器:18680,填写令牌。 - 选择元数据库:内置 H2(单机、小规模),或 PostgreSQL、MySQL、MariaDB、金仓、openGauss。「测试连接」会判断是空库、已有 DataLink 数据(重装或迁移)还是其他系统的库(拒绝)。
- 点「保存并启动」。配置写入数据目录下的
datalink.properties,同一进程随后启动完整服务。 - 在登录页「初始化管理员」,令牌填同一个。
注意:
datalink.properties含自动生成的数据源加密密钥,务必与数据库一起备份。密钥丢失后,已保存的数据源密码无法读出。
Docker Compose
需要 Docker 24+,会启动应用、PostgreSQL 16 元数据库和带示例数据的 PostgreSQL 16 数据源。
cp .env.example .env
# 必须填写:FDL_CONNECTION_SECRET_KEY、FDL_METADATA_DB_PASSWORD、FDL_DEMO_SOURCE_PASSWORD
docker compose up -d --build
浏览器打开 http://localhost:18680。停止用 docker compose down(数据在 volume 中;加 -v 会一并删除)。
健康检查
| 接口 | 含义 |
|---|---|
GET /api/health |
向导期间 mode=setup,等待数据库时 mode=waiting,正常运行时带 schemaVersion |
GET /api/health/ready |
完整服务就绪才返回 200 |
注意事项
注意:对公网提供服务时请放在 TLS 反向代理之后。
注意:脚本任务节点等同于在服务器上执行命令,默认关闭,只有所有任务编辑者都可信时才开启。