跳转至

安装器

在授权 Windows 设备上,从交付包启动 Install Avenue Agent.exe。如 Windows 显示安全提示,点击 More info 后选择 Run anyway 继续运行安装包。安装器会完成包校验、组件安装、工作区配置、服务启动和完成确认。安装失败时,先保存安装器展示的日志路径,再进入故障排查。

开始前

本页用于授权 Windows 设备的首次安装。安装时只需要接收并运行已提供的交付包,不需要从 GitHub 拉取源码,也不需要在授权设备上执行构建。

事项 项目侧准备 支持内容
安装设备 提供授权 Windows 设备和必要权限 说明安装环境要求
交付包 接收并按流程运行安装器 提供已校验的安装包
安装失败证据 提供截图和日志路径 根据日志定位安装问题

安装流程

%% avenue: linear-large %%
%%{init: {"theme":"base","themeVariables":{"fontFamily":"Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif","background":"#FAF9F5","primaryColor":"#F4F1EA","primaryTextColor":"#141413","primaryBorderColor":"#D8CBB8","lineColor":"#6F6B63","secondaryColor":"#FFFFFF","tertiaryColor":"#EAF1F7","clusterBkg":"#FAF9F5","clusterBorder":"#E8E6DC"},"flowchart":{"curve":"basis","padding":14,"nodeSpacing":34,"rankSpacing":44,"htmlLabels":true,"useMaxWidth":false}}}%%
flowchart LR
  A([启动安装器]):::start --> B[校验安装包]:::step
  B --> C[安装模块]:::step
  C --> D[配置工作区]:::step
  D --> E[启动服务]:::system
  E --> F([首次配置]):::done


  classDef start fill:#141413,color:#ffffff,stroke:#141413,stroke-width:1px;
  classDef step fill:#F4F1EA,color:#141413,stroke:#D8CBB8,stroke-width:1px;
  classDef system fill:#EAF1F7,color:#141413,stroke:#6A9BCC,stroke-width:1px;
  classDef decision fill:#EFE7DA,color:#141413,stroke:#C58B5A,stroke-width:1px;
  classDef action fill:#F7E4DC,color:#141413,stroke:#D97757,stroke-width:1px;
  classDef done fill:#EDF1E7,color:#141413,stroke:#788C5D,stroke-width:1px;
  classDef module fill:#FFFFFF,color:#141413,stroke:#E8E6DC,stroke-width:1px;

操作步骤

  1. 从交付包中打开 Install Avenue Agent.exe
  2. 如 Windows 显示安全提示,点击 More info 后选择 Run anyway
  3. 确认安装器显示就绪状态。
  4. 点击开始安装。
  5. 等待安装器完成包校验、组件安装和服务启动。
  6. 安装完成后进入首次配置向导(Setup Wizard)完成首次配置。

成功标准

  • 安装器显示完成状态。
  • 本地连接服务(Connector) 和本地模块已安装到授权 Windows 设备。
  • 安装器展示的日志路径可追踪。
  • 安装完成后可以进入 首次配置向导(Setup Wizard)。

安装器就绪

校验安装包

安装组件

配置工作区

启动服务

安装完成

失败处理

如果安装器显示失败:

  1. 保留失败页面截图。
  2. 复制安装器显示的日志路径。
  3. 检查安装包是否完整、SHA-256 是否匹配。
  4. 进入故障排查按安装失败路径处理。

安装失败示例