从 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。
1. 双击下载的 MSI 文件以开始安装：
2. 接受最终用户许可协议：
3. 选择要安装的 Zabbix 组件（Agent daemon、Zabbix sender、Zabbix get）：
建议使用安装程序提供的默认安装位置。 如果使用自定义位置且没有必要的权限，可能会危及安装的安全性。
4. 配置以下参数。 其值将写入 Zabbix agent 配置文件中：
| Parameter | Description |
|---|---|
| Host name | 安装 Zabbix agent 的主机名称。设置 Hostname 参数。 |
| Zabbix server IP/DNS | 以逗号分隔的 IP 地址列表，也可以使用 CIDR 表示法，或者 Zabbix 服务器或 Zabbix proxy 的 DNS 名称。此参数为必填。设置 Server 参数。 |
| Agent listen port | agent 将在此端口上监听来自服务器的连接。设置 ListenPort 参数。 |
| Server or Proxy for active checks | 用于获取 active checks 的 Zabbix 服务器/proxy 地址或集群配置。服务器/proxy 地址可以是 IP 地址或 DNS 名称，并可通过冒号指定可选端口。设置 ServerActive 参数。 |
| Enable PSK | 勾选此复选框以启用 TLS 支持，使用预共享密钥。将 TLSConnect 和 TLSAccept 参数设置为 psk。 |
| Add agent location to the PATH | 勾选此复选框可将 Zabbix agent 所在位置添加到系统 PATH 变量。 |
如果检测到现有的 Zabbix agent，将显示其配置文件中的参数值。 此外，现有配置文件将在安装过程中重命名，并创建新的配置文件。
5. 如果在上一步中勾选了 Enable PSK 复选框，请配置 PSK 参数。 这些参数也将写入 Zabbix agent 配置文件中：
| Parameter | Description |
|---|---|
| Pre-shared key identity | 预共享密钥标识字符串。设置 TLSPSKIdentity 参数。 |
| Pre-shared key value | 预共享密钥字符串值。创建包含密钥的 psk.key 文件，并将 TLSPSKFile 参数设置为密钥所在位置（默认：C:\Program Files\Zabbix Agent\psk.key）。建议通过调整文件的安全设置来限制对预共享密钥文件的访问权限，使只有 Zabbix agent（或运行 agent 的用户）可以读取它。 |
6. 单击 Install 开始安装。
所有选定的 Zabbix 组件以及 Zabbix agent 配置文件都将安装到您指定的位置（默认：C:\Program Files\Zabbix Agent）。
Zabbix agent 2 也同样如此，但其 内置插件 的额外配置文件将安装到 zabbix_agent2.d\plugins.d 子文件夹中。
此外，zabbix_agentd.exe（或 zabbix_agent2.exe）将作为 Windows 服务进行设置，并采用延迟自动启动（在 Windows Vista/Server 2008 之前的 Windows 版本上则为自动启动）。
如果安装期间正在运行其他版本的 Zabbix agent，系统会提示您选择关闭该应用程序并尝试重新启动，或者保持其打开；在后一种情况下，将需要重启。
7. 单击 Finish 按钮退出安装向导。
从命令行安装
可以通过使用 msiexec 运行 MSI 安装程序，从命令行安装 Zabbix agent。例如：
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+ SERVER=192.0.2.1此方法支持无人值守安装，并可使用参数进行自定义配置。
支持的参数
Zabbix agent MSI 安装包支持以下适用于 Zabbix agent 和 Zabbix agent 2 的参数。
Zabbix agent/agent2 参数会在安装期间写入配置文件中。 单击参数名称可查看其详细说明和配置示例，参见 Zabbix agent (Windows) 页面。 对于 Zabbix agent 2，请参见 Zabbix agent 2 (Windows) 页面。
| Parameter | Description |
|---|---|
| ADDDEFAULT | 要按默认配置安装的以逗号分隔的组件列表。更多信息，请参见 ADDDEFAULT property。 可能的值： AgentProgram、GetProgram、SenderProgram、ALL示例： ADDDEFAULT=AgentProgram,GetProgram |
| ADDLOCAL | 要本地安装的以逗号分隔的组件列表。更多信息，请参见 ADDLOCAL property。 可能的值： AgentProgram、GetProgram、SenderProgram、ALL示例： ADDLOCAL=AgentProgram,SenderProgram |
| ALLOWDENYKEY | 用于 限制 Zabbix agent 检查 的以分号分隔的 AllowKey 或 DenyKey 参数列表。如有必要，请使用反斜杠转义分隔符（\;）。在 agent 配置文件中设置 AllowKey 和 DenyKey 参数。示例： ALLOWDENYKEY="AllowKey=system.run[more C:\Windows\System32\drivers\etc\hosts\\; echo 'File read complete'];DenyKey=system.run[*]" |
| CONF | Zabbix agent 的 模板配置文件 的完整路径名。安装期间，此文件将成为 agent 配置文件。该文件至少必须包含 Server 和 LogFile 参数。 示例： CONF="C:\full\path\to\example.conf" |
| DONOTSTART | 使用 DONOTSTART=1 可阻止 MSI 安装程序启动 Zabbix agent 服务。 |
| ENABLEPATH | 使用 ENABLEPATH=1 可将 Zabbix agent 所在位置添加到系统 PATH 变量。 |
| ENABLEPERSISTENTBUFFER | 仅适用于 Zabbix agent 2。启用对主动监控项使用本地持久存储。 |
| HOSTINTERFACE | 定义主机接口的可选参数。 |
| HOSTMETADATA | 定义主机元数据的可选参数。 |
| HOSTMETADATAITEM | 定义用于获取主机元数据的监控项的可选参数。 |
| HOSTNAME | 定义主机名的可选参数。 |
| HOSTNAMEITEM | 定义用于获取主机名的监控项的可选参数。 |
| INCLUDE | 要包含到 Zabbix agent 配置文件中的以分号分隔的单个文件列表，或目录中的所有文件。 |
| INSTALLFOLDER | Zabbix 组件和 Zabbix agent 配置文件的安装目录完整路径名。对于 Zabbix agent 2，附加的 内置插件 配置文件将安装在 zabbix_agent2.d\plugins.d 子文件夹中。示例： INSTALLFOLDER="C:\Program Files\Zabbix Agent" |
| LISTENIP | agent 应监听的以逗号分隔的 IP 地址列表。 |
| LISTENPORT | agent 将在此端口上监听来自服务器的连接。 |
| LOGFILE | Zabbix agent 日志文件的名称。 |
| LOGTYPE | 日志输出类型。 |
| NONMSICONFNAME | Zabbix agent 的 自定义配置文件 的完整路径名。安装期间，此文件中存在的任何有效 agent 配置参数（仅限于本表中列出的参数）都将写入新创建的 agent 配置文件。该文件至少必须包含 Server 参数。 示例： NONMSICONFNAME="C:\full\path\to\example.conf" |
| PERSISTENTBUFFERFILE | 仅适用于 Zabbix agent 2。Zabbix agent 2 应保存 SQLite 数据库的文件。 |
| PERSISTENTBUFFERPERIOD | 仅适用于 Zabbix agent 2。在无法连接到服务器或 proxy 时，数据应存储的时间段。 |
| SERVER | 以逗号分隔的 Zabbix 服务器或 Zabbix proxy 的 IP 地址列表，可选使用 CIDR 表示法，或 DNS 名称。此参数为必需，除非将 STARTAGENTS 设置为 0。 |
| SERVERACTIVE | 用于获取主动检查的 Zabbix 服务器/proxy 地址或集群配置。 |
| SKIP | 使用 SKIP=fw 可阻止 MSI 安装程序为 Zabbix agent 添加 Windows 防火墙例外规则。 |
| SOURCEIP | 用于到 Zabbix 服务器或 Zabbix proxy 的出站连接，或在执行某些监控项（web.page.get、net.tcp.port 等）时建立连接的源 IP 地址。 |
| STARTAGENTS | 处理被动检查的 zabbix_agentd 预先 fork 的实例数量。 如果设置为 0，则会禁用被动检查，且 agent 不会在任何 TCP 端口上监听。 |
| STARTUPTYPE | Zabbix agent 服务的启动类型。可能的值： automatic - 在 Windows 启动时自动启动服务； delayed - (默认) 在自动启动的服务完成启动后延迟启动服务（适用于 Windows Vista/Server 2008 及更高版本）； manual - 手动启动服务（由用户或应用程序）； disabled - 禁用服务，使用户或应用程序无法启动它。 示例： STARTUPTYPE=disabled |
| STATUSPORT | 仅适用于 Zabbix agent 2。如果设置，agent 将在此端口上监听 HTTP 状态请求（http://localhost:<port>/status）。 |
| TIMEOUT | 指定与 Zabbix proxy 或服务器建立连接并交换数据时的等待时间（秒）。 |
| TLSACCEPT | 接受的入站连接（用于被动检查）。如果设置为 psk，则 TLSCONNECT 也将设置为 psk（除非另有指定）。 |
| TLSCAFILE | 包含用于对等证书验证的顶级 CA 证书的文件完整路径名。 |
| TLSCERTFILE | 包含 agent 证书或证书链的文件完整路径名。 |
| TLSCONNECT | agent 应如何连接到 Zabbix 服务器或 proxy（用于主动检查）。如果设置为 psk，则 TLSACCEPT 也将设置为 psk（除非另有指定）。 |
| TLSCRLFILE | 包含已吊销证书的文件完整路径名。 |
| TLSKEYFILE | 包含 Zabbix agent 私钥的文件完整路径名。 |
| TLSPSKFILE | 包含 Zabbix agent 预共享密钥的文件完整路径名。如果同时设置了 TLSPSKFILE 和 TLSPSKVALUE，则 TLSPSKVALUE 的值将写入 TLSPSKFILE 指定的文件中。建议通过调整文件的安全设置来限制对预共享密钥文件的访问，使只有 Zabbix agent（或运行 agent 的用户）可以读取它。 |
| TLSPSKIDENTITY | 预共享密钥标识字符串。 |
| TLSPSKVALUE | 预共享密钥字符串值。如果同时设置了 TLSPSKFILE 和 TLSPSKVALUE，则 TLSPSKVALUE 的值将写入 TLSPSKFILE 指定的文件中。 示例： TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 |
| TLSSERVERCERTISSUER | 允许的服务器（proxy）证书颁发者。 |
| TLSSERVERCERTSUBJECT | 允许的服务器（proxy）证书主题。 |
| UNSAFEUSERPARAMETERS | 允许将所有字符传递给用户自定义参数的参数。 |
示例
以下示例安装带有自定义配置的 Zabbix agent。 它还会启用 TLS 支持 使用预共享密钥。
mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.0-windows-amd64-openssl.msi" /qn+^
SERVER=192.0.2.1^
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，并使用 模板配置文件 (CONF="C:\agent-template.conf")。
在安装过程中，此文件将成为 agent 配置文件。
要继承旧配置文件中的参数，请使用参数占位符（例如，[AllowDenyKey]）。
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"
# agent-template.conf 示例:
LogFile=[LogFile]
[AllowDenyKey]
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B
[Include]
[TLSConnect]
[TLSAccept]
[TLSPSKIdentity]
[TLSPSKFile]或者，您也可以使用 自定义配置文件 (NONMSICONFNAME="C:\agent-custom.conf")。
在安装过程中，此文件中存在的任何有效 agent 配置参数（仅限于上表中列出的参数）都将写入新创建的 agent 配置文件中。
要保留现有的 agent 配置，请定义需要保留的参数。
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-8.0.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"
# agent-custom.conf 示例:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2BZabbix agent 2 可加载插件
Zabbix agent 2 的可加载插件可在 Windows 上使用 64 位 MSI 安装程序包进行安装，这些安装包可通过下载获取。
MSI 安装的最低操作系统要求为 Windows 10（64 位）或 Windows Server 2016。
安装插件之前，请先查看其 README 文件。 其中可能包含特定要求和安装说明。
与 Zabbix agent/agent2 类似，可加载插件也可以使用安装向导或命令行进行安装。
通过安装向导安装
1. 双击已下载的 MSI 文件以开始安装。
2. 接受最终用户许可协议。
3. 选择要安装的 Zabbix agent 2 可加载插件。
建议使用安装程序提供的默认安装位置。 如果在缺少必要权限的情况下使用自定义位置，可能会影响安装的安全性。
4. 单击 Install 开始安装。
所有选定的 Zabbix agent 2 可加载插件都将安装到您指定的位置（默认：C:\Program Files\Zabbix Agent 2），其配置文件将安装在 zabbix_agent2.d 子文件夹中。
5. 单击 Finish 按钮退出安装向导。
从命令行安装
可以通过运行 MSI 安装程序并使用 msiexec 从命令行安装 Zabbix agent 2 可加载插件。例如：
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-8.0.0-windows-amd64.msi" /qn+Zabbix agent 2 可加载插件 MSI 安装程序包支持以下参数。
| 参数 | 说明 |
|---|---|
| ADDDEFAULT | 以默认配置安装的、以逗号分隔的组件列表。更多信息，请参见 ADDDEFAULT property。 可能的值： ALL、CephPlugin、EmberplusPlugin、MongodbPlugin、MssqlPlugin、NvidiagpuPlugin、PostgresqlPlugin示例： ADDDEFAULT=MongodbPlugin,PostgresqlPlugin |
| ADDLOCAL | 要在本地安装的、以逗号分隔的组件列表。更多信息，请参见 ADDLOCAL property。 可能的值： ALL、CephPlugin、EmberplusPlugin、MongodbPlugin、MssqlPlugin、NvidiagpuPlugin、PostgresqlPlugin示例： ADDLOCAL=MongodbPlugin,MssqlPlugin |
| INSTALLFOLDER | 安装 Zabbix 组件的文件夹完整路径，其配置文件将安装在 zabbix_agent2.d 子文件夹中。示例： INSTALLFOLDER="C:\Program Files\Zabbix Agent 2" |