安装器
在授权 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;
操作步骤
- 从交付包中打开
Install Avenue Agent.exe。 - 如 Windows 显示安全提示,点击
More info后选择Run anyway。 - 确认安装器显示就绪状态。
- 点击开始安装。
- 等待安装器完成包校验、组件安装和服务启动。
- 安装完成后进入首次配置向导(Setup Wizard)完成首次配置。
成功标准
- 安装器显示完成状态。
- 本地连接服务(Connector) 和本地模块已安装到授权 Windows 设备。
- 安装器展示的日志路径可追踪。
- 安装完成后可以进入 首次配置向导(Setup Wizard)。






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