文档中心
安装包管理
下载或上传 SeaTunnel 安装包，供一键安装与升级使用。
Web UI 安装包与插件 → 安装包管理（/packages）。这里存放的是 SeaTunnel 发行包（.tar.gz），不是 STX 自身安装包，也不是连接器 JAR（连接器见插件市场）。
包先保存在运行 STX Server 的机器上，再在一键安装或升级时经 stx-agent 推到被纳管主机。
在线版本与本地安装包
页内可切换两个列表：
| 列表 | 做什么 |
|---|---|
| 在线版本 | 看镜像上的可用版本；点 下载到服务器 拉到本机 |
| 本地安装包 | 看已下载或上传的包；可删除，或补齐 / 替换可选的源码包 |
页头会标出 推荐版本。需要刷新目录时用 刷新版本列表。
| 列（在线版本） | 说明 |
|---|---|
| 版本 | SeaTunnel 版本；推荐版本带 推荐 标记 |
| 状态 | 是否可下载 |
| 源码包 | 是否已下载源码，或是否支持与二进制一并下载 |
| 下载链接 | 下载到服务器、进度，或 已下载 |
下载对话框里可选镜像（如阿里云、华为云、Apache），并可勾选 同时下载源码包。源码包可选，主要用于 AI Agent 排障场景。
离线上传
内网或无法访问镜像时：点 上传安装包，拖入 .tar.gz。
| 约束 | 说明 |
|---|---|
| 格式 | 仅 .tar.gz |
| 文件名 | 建议 apache-seatunnel-{版本}-bin.tar.gz，便于自动识别版本 |
| 大小上限 | 由 storage.max_package_size 控制；配置示例默认 20480 MB |
| 存放目录 | 默认 ./lib/packages（相对 STX Server 工作目录） |
也可一并上传对应的 *-src.tar.gz 源码包。
和集群安装、升级的关系
| 场景 | 需要什么 |
|---|---|
| 一键安装 · 在线 | 若本地还没有目标版本，安装过程会按需下载 |
| 一键安装 · 离线 | 本地安装包里必须已有目标版本 |
| 集群升级 | 升级前须备好目标版本的本地包；缺包时界面会提示前往安装包管理 |
默认节点安装目录形如 /opt/seatunnel-{版本}。安装与升级细节见集群管理。