Table of Contents
4 从MSI安装Windows agent
概览
Zabbix agent 可以使用 32 位或 64 位的 MSI 安装包在 Windows 上安装，这些安装包可以从 下载 页面获取。
MSI 安装的最低操作系统要求为：
- 对于 Zabbix agent: Windows XP (64 位) 或 Windows Server 2003
- 对于 Zabbix agent 2: Windows 10 (32 位) 或 Windows Server 2016
32 位的安装包无法在 64 位系统上安装。
安装包包含：
- TLS 支持（TLS 配置是可选的）
- Zabbix get 和 Zabbix sender 工具（可以与 Zabbix agent/agent 2 一同安装或单独安装）
Zabbix agent 2 的安装包不包含可加载的插件（MongoDB, PostgreSQL, MSSQL），这些插件需要 单独下载和安装。
尽管使用 MSI 包安装是完全支持的，但为了正确处理错误，推荐至少安装 Microsoft .NET Framework 2。
推荐使用安装程序提供的默认安装位置。 使用没有必要权限的自定义位置可能会损害安装的安全性。
从设置向导安装
以下安装步骤适用于Zabbix agent和Zabbix agent 2两者。
- 双击下载的MSI文件以开始安装：
- 接受最终用户许可协议：
- 选择要安装的Zabbix组件(Agent daemon, Zabbix sender, Zabbix get)：
建议使用安装程序提供的默认安装位置。 使用没有必要权限的自定义位置可能危及安装的安全性。
- 配置以下参数。 它们的值将在Zabbix agent配置文件中设置：
| Parameter | 描述 |
|---|---|
| Host name | 正在安装Zabbix agent的机器的主机名。设置Hostname参数。 |
| Zabbix server IP/DNS | 以逗号分隔的IP地址列表，可选地使用CIDR表示法，或Zabbix servers或Zabbix proxies的DNS名称。此参数是必须的。设置Server参数。 |
| Agent listen port | agent将在此端口上监听来自服务器的连接。设置ListenPort参数。 |
| Server or Proxy for active checks | 获取active checks的Zabbix server/proxy地址或集群配置。server/proxy地址是一个IP地址或DNS名称，后跟可选的端口，以冒号分隔。设置ServerActive参数。 |
| Enable PSK | 选中标记以启用TLS支持using pre-shared keys。设置TLSConnect和TLSAccept参数为psk。 |
| Add agent location to the PATH | 选中标记以将Zabbix agent位置添加到系统PATH变量。 |
如果检测到现有的Zabbix agent，其配置文件中的参数值将被显示。 此外，在安装过程中，现有的配置文件将被重命名，并将创建一个新的配置文件。
- 如果在上一步中选中了“启用PSK”复选框，配置PSK参数。 这些参数也将在Zabbix agent配置文件中设置：
| Parameter | 描述 |
|---|---|
| Pre-shared key identity | 预共享密钥身份string。设置TLSPSKIdentity参数。 |
| Pre-shared key value | 预共享密钥string值。创建包含密钥的psk.key文件，并将TLSPSKFile参数设置为密钥位置（默认：C:\Program Files\Zabbix Agent\psk.key）。建议通过调整文件的安全设置，限制对预共享密钥文件的访问，以便只有Zabbix agent（或运行agent的用户）可以读取它。 |
- 点击安装以开始安装。
所有选定的Zabbix组件和Zabbix agent配置文件将安装在您指定的位置（默认：C:\Program Files\Zabbix Agent）。 Zabbix agent 2同样适用，除了其built-in plugins的附加配置文件将安装在zabbix_agent2.d\plugins.d子文件夹中。
此外，zabbix_agentd.exe（或zabbix_agent2.exe）将设置为具有延迟自动启动的Windows服务（或在Windows Vista/Server 2008之前的Windows版本上自动启动）。
如果在安装期间运行不同版本的Zabbix agent，将提示您选择关闭应用程序并尝试重新启动它或保持其打开状态，在后一种情况下将需要重新启动。
- 点击完成按钮以退出设置向导。
从命令行安装
Zabbix agent 可以通过在命令行中运行带有 msiexec 的 MSI 安装程序从命令行安装。例如：
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.0此方法允许进行无人值守安装并使用参数进行自定义配置。
Zabbix agent MSI 安装包支持以下参数，适用于 Zabbix agent 和 Zabbix agent 2。
在安装过程中，Zabbix agent/agent2 参数将在配置文件中设置。 点击参数名称以在 Zabbix agent (Windows) 页面上查看其详细描述和配置示例。 对于 Zabbix agent 2，请参阅 Zabbix agent 2 (Windows) 页面。
| 参数 | 描述 |
|---|---|
| ADDDEFAULT | 以逗号分隔的组件列表，以默认配置安装。更多信息，请参阅 ADDDEFAULT 属性。 可能的值: AgentProgram, GetProgram, SenderProgram, ALL示例: ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | 以逗号分隔的组件列表，本地安装。更多信息，请参阅 ADDLOCAL 属性。 可能的值: AgentProgram, GetProgram, SenderProgram, ALL示例: ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | 以分号分隔的 AllowKey 或 DenyKey 参数列表，用于 限制 Zabbix agent 检查。如果必要，使用反斜杠转义分隔符 (\;)。在 agent 配置文件中设置 AllowKey 和 DenyKey 参数。示例: ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]" |
| CONF | Zabbix agent 的自定义配置文件的完整路径名。在安装过程中，此文件将完全替换新或现有 agent 配置文件的内容。文件必须至少包含 Server 和 LogFile 参数。 示例: CONF="C:\full\path\to\example.conf" |
| ENABLEPATH | 使用 ENABLEPATH=1 将 Zabbix agent 位置添加到系统 PATH 变量。 |
| ENABLEPERSISTENTBUFFER | 仅限 Zabbix agent 2。启用本地持久存储以用于主动项目。 |
| HOSTINTERFACE | 可选参数，定义主机接口。 |
| HOSTMETADATA | 可选参数，定义主机元数据。 |
| HOSTMETADATAITEM | 可选参数，定义用于获取主机元数据的项目。 |
| HOSTNAME | 可选参数，定义主机名。 |
| INCLUDE | 以分号分隔的单独文件列表或目录中的所有文件，包含在 Zabbix agent 配置文件中。 |
| INSTALLFOLDER | Zabbix 组件和 Zabbix agent 配置文件将安装的文件夹的完整路径名。对于 Zabbix |
示例
以下示例安装带有自定义配置的 Zabbix agent。 它还启用了 TLS 支持 使用预共享密钥。
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.0-windows-amd64-openssl.msi" /qn+^
SERVER=192.0.2.0^
INSTALLFOLDER="C:\Program Files\Zabbix Agent"^
HOSTNAME=LAPTOP-IKP7S51S^
TLSACCEPT=psk^
TLSCONNECT=psk^
TLSPSKIDENTITY="PSK 001"^
TLSPSKFILE="C:\Program Files\Zabbix Agent\psk.key"^
TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952^
ENABLEPATH=1^
ALLOWDENYKEY="AllowKey=system.run[type C:\Windows\System32\drivers\etc\hosts];DenyKey=system.run[*]"以下示例安装 Zabbix agent 的较新版本，并使用自定义配置文件替换现有 agent 配置文件中的特定参数（例如，Hostname=LAPTOP-IKP7S51S,DESKTOP-X9F4A2B）。
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.0.10-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"Zabbix agent 2 可加载插件
Zabbix agent 2 可加载插件 可以通过64位MSI安装包在Windows上安装，这些安装包可以从 下载 获取。
MSI安装的最低操作系统要求为Windows 10（64位）或Windows Server 2016。
安装包包括：
安装包不包括 Ember+插件，该插件目前仅可通过从源代码构建（适用于Unix和Windows）获得。
在安装插件之前，请检查其README文件。 它可能包含针对该插件的额外要求和特定安装说明。
类似于Zabbix agent/agent2，可加载插件可以通过设置向导或命令行进行安装。
1. 双击下载的MSI文件以开始安装。
2. 接受最终用户许可协议。
3. 选择要安装的Zabbix agent 2可加载插件 (MongoDB插件, PostgreSQL插件, MSSQL插件)。
建议使用安装程序提供的默认安装位置。 在没有必要权限的情况下使用自定义位置可能会影响安装的安全性。
4. 点击 安装 开始安装。
所有选定的Zabbix agent 2可加载插件将安装在您指定的位置（默认：C:\Program Files\Zabbix Agent 2），其配置文件将安装在zabbix_agent2.d子文件夹中。
5. 点击 完成 按钮退出设置向导。
从命令行安装
Zabbix agent 2 可加载插件可以从命令行通过运行带有 msiexec 的 MSI 安装程序进行安装。例如：
Zabbix agent 2 可加载插件 MSI 安装包支持以下参数。
| 参数 | 描述 |
|---|---|
| ADDDEFAULT | 以逗号分隔的组件列表，以默认配置进行安装。更多信息，请参阅 ADDDEFAULT 属性。 可能的值: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALL示例: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | 以逗号分隔的组件列表，进行本地安装。更多信息，请参阅 ADDLOCAL 属性。 可能的值: MongodbPlugin, PostgresqlPlugin, MssqlPlugin, ALL示例: ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | Zabbix 组件将被安装的文件夹的完整路径名，其配置文件将被安装在 zabbix_agent2.d 子文件夹中。示例: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |