---
title: 代理部署
slug: neurons/help/zh_cn/8iq5pnks1QfuvNmBd0i3v
createdAt: 2026-09-07T07:01:35.264Z
---

使用 Ivanti Neurons 平台需要 Ivanti Neurons 代理。 使用以下选项卡分配策略并将代理推送到终端：

- **自动策略分配**：选择此项可根据可配置的规则自动管理和分配策略到环境中的设备。
- **Neurons 推送安装**：选择此项可下载代理并部署到目标设备。
- **手动安装**：选择此项可下载代理并通过命令行在每个目标设备上手动安装。

## 自动化策略分配

自动策略分配 (APA) 根据可配置的规则自动管理策略并分配策略到环境中的设备。 借助 APA，管理员可以简化和集中策略管理，确保始终根据组织标准、设备组、例外和其他属性为设备分配正确的策略。

您可以使用 APA 功能以利用以下关键功能将策略分配给端点：

- **基于规则的分配**：根据可自定义的规则将策略分配给设备。
- **组和例外处理**：设备可以分组，可以配置例外。
- **手动和自动模式**：按照自己所需的节奏从手动策略分配过渡到基于规则的自动化。
- **24 小时冷却**：限制策略重新分配，以避免不稳定和资源使用。

要部署 APA，您必须首先配置策略分配。 有关配置 APA 的更多信息，请参阅[配置自动化策略分配](https://docs.ivanti.com/neurons/help/zh_cn/jW1ZAb_GRc_bTevRzjt6D)。

## 手动安装代理

要手动安装 Ivanti Neurons 代理，请执行以下操作：

1. 导航到**代理** > **代理部署**，在**手动安装**磁贴，点击**开始**。
   **手动安装代理**页面随即显示。
2. **选择您的代理策略**：从下拉列表中选择要分配给代理的**代理策略**，或者开始输入策略的名称来筛选下拉列表。
   或者，从下拉列表中选择**使用自动化策略分配**选项，以使用基于 APA 的部署。
   代理策略在**代理&#x20;**> **代理策略**中创建。
3. **选择您的注册密钥**：从下拉列表中选择要用于注册代理的**注册密钥**。 或者使用新密钥，选择**创建新密钥**。 [创建注册密钥](https://docs.ivanti.com/neurons/help/zh_cn/19vEcTT_8AbdbR9LX9iEo#create-enrollment-key)面板随即显示。
   注册密钥在**代理&#x20;**> **注册密钥**中创建。


:::hint{type="info"}
如果您使用自动策略分配功能进行座席部署，将使用内置的自动生成密钥向租户注册代理。 默认情况下，注册密钥设置为**自动生成**。 如果需要，您还可以使用自己的客户注册密钥。
:::

4. **选择主机端点系统**：选择要安装代理的设备的操作系统： 

:::ExpandableHeading
## Microsoft Windows

选择 **Windows** 磁贴以在 Microsoft Windows 端点上安装 Ivanti Neurons 代理，然后选择偏好的安装方法：

- **交互式安装**
  1. 在**安装模式**中，选择**交互式**。
  2. 点击**下载**。
     将下载两个文件：
     - IvantiCloudAgent - 代理安装文件 (`.exe`)
     - IvantiCloudAgent.exe.options - 配置设置 (`.options`)。
  3. 确保下载的两个文件位于同一个文件夹中，然后运行可执行文件。
- **无提示安装**
  1. 在**安装模式**中，选择**静默**。
  2. 点击**下载**。
  3. 复制**命令**，并与选项文件中的安装参数一同用于运行安装文件。
:::

:::ExpandableHeading
## Apple macOS

选择 **macOS** 磁贴以在 Apple macOS 端点上安装 Ivanti Neurons 代理，然后选择偏好的安装方法：

- **交互式安装**
  1. 在**安装模式**中，选择**交互式**。
  2. 点击**下载**。
  3. 在端点上，分发并挂载代理安装磁盘映像 (`.dmg`)。
  4. 运行安装包 (`.pkg`)。
  5. 安装代理后，复制**命令**，并从终端运行命令来配置代理。
- **无提示安装**
  1. 在**安装模式**中，选择**静默**。
  2. 点击**下载**。
  3. 在端点上，分发可执行文件。
  4. 复制**命令**，并与选项文件中的安装参数一同用于运行安装文件。

在 macOS 设备上安装 Neurons 代理期间，将会显示多个权限和通知对话框，您可能需要确定是否允许代理使用位置服务以获取[位置传感器](https://docs.ivanti.com/neurons/help/zh_cn/xbBP-edge-intelligence#Generic)提供的位置信息。 必须设置和/或允许这些权限和通知，以便代理正常运行。
可以访问 Ivanti 社区查看知识库文章[ Ivanti Neurons 的 MDM 配置文件](https://forums.ivanti.com/s/article/MDM-Profiles-for-Ivanti-Neurons)，找到相应的 MDM 配置文件，以便提前完成大部分权限的设置。
:::

::::ExpandableHeading
## Linux

:::hint{type="info"}
在安装 Ubuntu 24 之前，用户必须安装依赖程序包 `libltdl-dev`，所使用的命令为
`sudo apt install -y libltdl-dev`
:::

选择 **Linux** 磁贴以在 Linux 端点上安装 Ivanti Neurons 代理，然后选择 Linux 版本：

1. 从**版本**下拉列表中，选择适用的 Linux 发行版。
2. 点击**下载**。
3. 在端点上，以 root 身份打开 shell，然后导航到下载的安装文件 (`.sh`)。
4. 使安装文件可执行。
5. 运行安装文件：
   `bash <filename>.sh`

### 调试日志

超级管理员可以选择使用命令行启用或禁用 P2Z 引擎调试日志。 超级管理员必须与代理计算机建立 SSH 连接，并以超级用户权限执行以下命令。

- 要启用调试日志，请在终端上使用以下命令： `touch /opt/ivanti/isec/data/agentPatchP2Z_EnableDebugLog`
- 要禁用调试日志，请在终端上使用以下命令：`rm -f /opt/ivanti/isec/data/agentPatchP2Z_EnableDebugLog`

### 有关 Linux 安装过程和系统修改的重要说明

**用户创建**

- 安装过程仅创建一个用户：**ivanticloudagent**。
- 卸载代理时，系统将删除此用户。
- Ivanti Cloud 代理在任何情况下都不会创建其他用户。
- ivanticloudagent 用户：
  - 具有代理安装位置的主目录
  - 此目录由具有 755 项权限的根拥有
  - 用户可以搜索此目录，但无法更改
  - 无法登录（无密码或默认登录 Shell）

**系统修改**：Ivanti Cloud 代理安装不会对以下各项进行任何更改：

- Sudoers 配置
- 系统控制参数 (sysctl)
- 服务定义（自身服务除外）
- 系统权限
- 任何其他系统级设置

**服务配置**

- 服务文件的创建地址为 /lib/systemd/system/ivanticloudagent.service
- 在成功注册代理之前，服务将保持非活动状态
- 注册后，服务将：
  - 激活并启动代理
  - 如果代理因错误而停止，请重启代理
- 此服务不依赖其他系统服务
- 仅在系统启动为多用户模式时启动
- 此服务将 /opt/ivanti/cloudagent/run/agent 用作其工作目录
- 此服务的启动程序为 stagentd
::::

在端点上安装代理后，设备详细信息将列于主菜单 > **设备**中。

:::hint{type="success"}
如果使用单独发送参数的分发软件（例如 Ivanti Endpoint Manager），请记得从复制文本中删除代理文件名，然后再将其粘贴到分发软件。 有关如何使用 Ivanti Endpoint Manager 分发 Ivanti Neurons 代理的详细信息，请参阅[如何使用 Endpoint Manager 部署 Ivanti Neurons 代理](https://forums.ivanti.com/s/article/How-to-deploy-an-Ivanti-Cloud-agent-using-Ivanti-Endpoint-Manager)。
:::

## 使用 Neurons 推送安装部署代理

:::hint{type="info"}
确保设备名称、IP 地址和操作系统信息可用于设备，以便在推送安装期间从列表中选择或查看它们。
:::

要使用 Ivanti Neurons 将 Ivanti Neurons 代理部署并安装到端点，请执行以下操作：

1. 导航到**代理&#x20;**> **代理部署**，在 **Neurons 推送安装**磁贴上，点击**开始**。
   **使用 Ivanti Neurons 部署**页面随即显示。

### 部署设置

**选择您的代理策略**：从下拉列表中选择要分配给代理的**代理策略**，或者开始输入策略的名称来筛选下拉列表。 或者，从下拉列表中选择**使用自动化策略分配**选项，以使用基于 APA 的部署。
代理策略在**代理&#x20;**> **代理策略**中创建。

3. **注册密钥（剩余激活次数）**：从下拉菜单中选择要用于注册代理的**注册密钥**，或者开始输入注册密钥的名称来筛选下拉列表。 确保拥有足够的剩余激活次数，能满足要部署到的设备数量。
   或者使用新密钥，选择**创建新密钥**。 [创建注册密钥](https://docs.ivanti.com/neurons/help/zh_cn/19vEcTT_8AbdbR9LX9iEo#create-enrollment-key)面板随即显示。
   注册密钥在**代理&#x20;**> **注册密钥**中创建。


:::hint{type="info"}
如果您使用自动策略分配功能进行座席部署，将使用内置的自动生成密钥向租户注册代理。 默认情况下，注册密钥设置为**自动生成**。 如果需要，您还可以使用自己的客户注册密钥。
:::

4. **部署来源**：选择用于部署的端点。 如果至少 1 个但又不超过 500 个代理端点已启用部署功能，则默认选择**自动**选项。 您可以从下拉列表中选择特定的端点，或者输入端点的名称来筛选下拉列表。 只有已安装代理并启用“部署”功能的端点可供选择。

### 源设备

**源设备**部分会列出 Neurons **设备**主视图中具有名称、IP 地址和操作系统的所有设备。

:::hint{type="info"}
非持久 VDI 端点当前无法选择。 要应用更改，需要解封、更新这些端点，然后重新密封。 相反，直接将代理策略部署到 NP-VDI 镜像。 有关 VDI 信息，请参阅[非持久虚拟设备基础设施 (NP-VDI)](https://docs.ivanti.com/neurons/help/zh_cn/np-vdi) 和[持久虚拟设备接口 (VDI) 以及黄金映像克隆设备](https://docs.ivanti.com/neurons/help/zh_cn/vdi)。
:::

默认列表是**所有设备**。 您可以按以下方式筛选列表，或使用搜索功能来找到特定设备：

:::Paragraph{listStyleType="disc" indent="2"}
**所有设备**（默认），默认设备组：**EPM 托管**、**云托管**、**便携**、公共设备组或您的私有设备组（在**设备**中创建）。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**有代理**或**无代理**。
:::

6. **选择**要部署代理的各个设备的复选框。
7. 点击**添加**，将所选源设备添加到**目标设备**部分。

### 目标设备

**目标设备**部分会列出您从**源设备**部分添加的所有设备。 这些是您选择要为其部署代理的设备。
**设备**记录中的设备名称、IP 地址和操作系统随即显示。
点击**部署**，开始向所有目标设备进行部署。
部署状态可以&#x5728;**&#x20;Agent Management&#x20;**&#x9875;面的[状态](https://docs.ivanti.com/neurons/help/zh_cn/LQ5e_BAeiGVVcM4pkQA5_#status)列中查看。

9. 如果需要从目标列表中删除设备，请选中设备旁的复选框，然后点击**删除**。 或者点击**删除全部**，以删除目标列表中的所有设备。

### 凭据

代理需使用设备凭据才能在需要提升权限的设备上执行操作，或扫描网络上的其他设备。 必须先添加要为其部署的相关操作系统的凭据，然后才能继续部署。 **凭据**选项卡将以红色突出显示，直至解决此问题。
设置相关操作系统的凭据：**Windows**、**macOS**、**Linux**。 从下拉列表中，选择凭据。 要创建新凭据，请选择**创建新凭据**。 **新建凭据**面板随即显示。

:::ExpandableHeading{customAnchorSlug="Create-credential"}
## 创建新凭据

1. 输入新凭据的**名称**。 您可以选择提供描述。
2. 输入**用户名**。
3. 输入**密码**。
4. 点击**提交**保存凭据集。 这些凭据将保存到**管理员** > **凭据**中。
:::

:::ExpandableHeading
## 如何在不指定设备凭据的情况下在设备上安装功能

1. [手动安装代理](https://docs.ivanti.com/neurons/help/zh_cn/8iq5pnks1QfuvNmBd0i3v#ManuallyInstall)。
2. 导航到**代理** > **代理策略**。
   **代理策略**页面随即显示。
3. 手动安装过程中，对要安装的策略选择**操作** > **编辑**。
   **编辑代理策略**页面随即显示。
4. 在**功能**部分，选择启用所需功能。
5. 点击**保存**以保存更改。
   代理下次签入时，策略更改将生效。
:::
