租户侧：安装代理（零基础）

先跑通安装代理，是成功的第一步：若卡在这里，很多人不会再试平台其它能力。文档与控制台帮助都按「能复制就不手写」来写，卡住时把终端最后约 20 行发给支持即可。

面向在自备 Linux 服务器上部署 vaiteam-install-agent 的客户：若只会 SSH、尚未安装 Docker，请按 复制粘贴 步骤操作。

获取源码：下载包与 Git 仓库（建议同时提供）

• 压缩包 / 302 短链：运营提供 vaiteam-install-agent-*.tar.gz 或由控制台 /api/go/install-agent 跳转 OSS。解压后即为完整可构建目录，最快跑通，不必 git clone。
• Git 仓库：控制台配置 INSTALL_AGENT_SOURCE_REPO_URL 后与下载入口并列展示，便于 git clone、审计与跟踪更新；monorepo 需进入 saas/install-agent 子目录（以你们实际仓库为准）。

控制台内帮助

登录 SaaS 控制台 → 安装代理 → 选定租户实例后，点击 「零基础安装说明」，与本文同旨，可边开网页边在 SSH 里粘贴命令。

交付包 / 仓库文档（最全）

开源与交付小包中的完整说明（含公告板约定、FRP、排障等）见：

• 仓库路径：saas/install-agent/README.md
• 其中 「零基础客户」 一节：按 Ubuntu / Debian / CentOS / Rocky / Fedora 分块给出整段 shell，并说明 A → B → C（装 Docker → 进目录 → 改 docker.env + build / register / up）。

务必记住

1. 顺序：docker compose build → docker compose run … register → docker compose up -d，不要先 up -d。
2. 不要对本栈执行 docker compose pull（镜像是本地 build，与 Dockerfile 基础镜像源不是一回事）。
3. 国内网络建议配置 Docker registry-mirrors，构建代理镜像时已默认使用国内基础镜像转发；详见 README.md。