Documentation
Table of Contents
1 在Windows上构建Zabbix agent
概述
本页面演示如何在 Windows 10（64-bit）上从源代码构建 Zabbix agent。
这些说明适用于支持 Visual Studio 2022 的 Windows 版本。
构建 Zabbix agent 需要以下组件：
- C 编译器（包含在 Build Tools for Visual Studio 2022 中）
- OpenSSL（用于 Zabbix 的 encryption 功能）
- PCRE2（Perl 兼容正则表达式；用于 Zabbix 中的正则表达式模式匹配功能）
您可以使用以下方法之一来构建 Zabbix agent：
根据您的监控需求，可能还需要额外的库。有关更多信息，请参见 agent。
在开始构建过程之前，请注意以下事项：
- 要 execute 命令，请使用 x64 Native Tools Command Prompt（包含在 Build Tools for Visual Studio 2022 中），并以具有向受保护文件夹写入权限的用户身份运行。
- 建议在
C:\Zabbix为所有源代码文件和构建文件夹 create 一个工作目录。但是，编译后的组件应安装在C:\Program Files\Zabbix\x64中。
使用 vcpkg 构建 Zabbix agent
本部分包含使用vcpkg构建Zabbix agent的指导说明，该包管理器可简化依赖项管理及与C++项目的集成。
1. 下载并安装Build Tools for Visual Studio 2022。 安装过程中请确保勾选使用C++的桌面开发工作负载，其中包含使用vcpkg构建agent所需的工具：
- C编译器（Microsoft Visual C++）
- NMake命令行工具
- vcpkg包管理器
- x64本机工具命令提示符
2. 初始化vcpkg并安装构建Zabbix agent所需的依赖项（注意此过程可能需要较长时间）：
cd C:\Zabbix
vcpkg new --application
vcpkg add port pcre2
vcpkg add port openssl
vcpkg install --triplet x64-windows-static --x-install-root="C:\Program Files\Zabbix\x64"3. 下载Zabbix source archive并解压至C:.0。
4. 进入Zabbix构建目录（C:.0）并create以下build.bat脚本，需正确指定OpenSSL和PCRE2的安装目录：
:: Set vcpkg installation path:
set vcpkg=C:\Program Files\Zabbix\x64\x64-windows-static
:: Run the build process:
nmake -f Makefile CPU=AMD64 ^
PCRE2INCDIR="%vcpkg%\include" ^
PCRE2LIBDIR="%vcpkg%\lib" ^
TLS=openssl ^
TLSINCDIR="%vcpkg%\include" ^
TLSLIBDIR="%vcpkg%\lib" ^
LIBS="$(LIBS) Crypt32.lib" ^
all5. 通过执行脚本编译Zabbix agent：
编译完成后，Zabbix组件二进制文件将位于C:.0。 Zabbix agent的配置file存放于C:.0。
要runagent，需copyzabbix_agent.exe及其配置file至专用文件夹（如C:），然后runagent：
mkdir C:\Zabbix\agent
copy C:\Zabbix\zabbix-7.0.0\bin\win64\zabbix_agent.exe C:\Zabbix\agent\
copy C:\Zabbix\zabbix-7.0.0\conf\zabbix_agent.win.conf C:\Zabbix\agent\
C:\Zabbix\agent\zabbix_agent.exe -c C:\Zabbix\agent\zabbix_agent.win.conf手动构建 Zabbix agent
此 Zabbix agent 构建方法适用于需要对构建环境进行完全控制，或在无法使用 vcpkg 的受限环境中使用的用户。
本节包含手动构建 Zabbix agent 的说明，包括安装所需的构建工具和依赖项（Perl、OpenSSL、PCRE2），然后编译 agent。
安装构建工具
1。下载并安装 Build Tools for Visual Studio 2022。 安装期间，请确保选择 使用 C++ 进行桌面开发 工作负载，其中包含手动构建 agent 所需的工具：
- C 编译器（Microsoft Visual C++）
- NMake 命令行工具
- x64 本机工具命令提示符
安装 OpenSSL
若要在不支持 TLS 的情况下编译 Zabbix agent，请转至 安装 PCRE2 部分。
1. 下载并安装 Strawberry Perl（提供为 MSI 安装程序）。
安装期间，请确保将安装文件夹指定为 C:\Zabbix\Strawberry。
2. 安装 Text::Template Perl 模块：
3. 验证在安装 Strawberry Perl 期间是否已编译 Netwide Assembler（NASM；编译 OpenSSL 所需）：
如果未编译 NASM，请手动安装。有关更多信息，请参阅 NASM documentation。
4. 下载 OpenSSL source archive 并将其解压到 C:\Zabbix\openssl-3.5.0。
5. 进入解压后的目录并配置 OpenSSL，例如：
cd C:\Zabbix\openssl-3.5.0
perl Configure VC-WIN64A no-shared no-capieng no-winstore no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method --api=1.1.0 --prefix="C:\Program Files\Zabbix\x64\OpenSSL" --openssldir="C:\Program Files\Zabbix\x64\OpenSSL"如果在 Windows 上编译 Zabbix agent 时选择了自定义 OpenSSL 目录（例如 C:\zabbix 或 C:\openssl-64bit），请确保撤销该目录对非管理员用户的写入权限。
否则，agent 将从非特权用户可修改的路径加载 SSL 设置，从而可能导致潜在的安全漏洞。
no-shared选项使 libcrypto.lib 和 libssl.lib OpenSSL 静态库自包含，因此 Zabbix 二进制文件包含 OpenSSL，而无需外部 DLL。
这意味着可以将 Zabbix 二进制文件复制到其他 Windows 机器而无需 OpenSSL 库；但是，当新的 OpenSSL 修补版本 version 发布时，需要重新编译 Zabbix agent。
- 不使用
no-shared选项时，Zabbix 在运行时依赖 OpenSSL DLL。
这意味着 OpenSSL 更新可能不需要重新编译 Zabbix agent；但是，将其复制到其他机器时，也必须复制 OpenSSL DLL。
有关其他 OpenSSL 配置选项的更多信息，请参阅 OpenSSL documentation。
6. 编译 OpenSSL 并运行 run 测试（注意这可能需要一些时间）：
请在无管理员权限的情况下运行测试；否则可能导致意外结果或安全风险。
如果某些测试失败，请参阅 OpenSSL documentation 进行故障排除。
nmake
nmake test
...
All tests successful.
Files=325, Tests=3101, 822 wallclock secs ( 4.81 usr + 0.81 sys = 5.62 CPU)
Result: PASS7. 安装 OpenSSL：
如果仅需安装软件组件（库、头文件，但不包括文档），可以使用 nmake install_sw。
{HEADER_06283175}
1。下载并安装 CMake（提供为 MSI 安装程序）。
安装期间，请确保将安装文件夹指定为 C:\Zabbix\CMake 并选择 将 CMake 添加到 PATH 环境变量 选项。
2。下载 PCRE2 source archive 并将其解压到 C:\Zabbix\pcre2-10.45。
3。在解压后的 PCRE2 目录中创建一个 build 目录并进入该目录：
4。配置 PCRE2：
cmake -G "NMake Makefiles" -DPCRE_SUPPORT_UNICODE_PROPERTIES=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="C:\Program Files\Zabbix\x64\PCRE2" "C:\Zabbix\pcre2-10.45"如果出现任何错误，建议在尝试重复 CMake 构建过程之前 delete CMake 缓存。
缓存文件 (CMakeCachecache.txt) 可在解压后的 PCRE2 目录的构建目录中找到。
5。使用 NMake 构建 PCRE2：
6。安装 PCRE2：
编译 Zabbix agent
1。下载Zabbix source archive并解压到C:.0目录。
如需从源代码仓库generate源码归档（例如应用自定义补丁或基于最新源码构建），请在Linux机器上run以下命令：
git clone https://git.zabbix.com/scm/zbx/zabbix.git
cd zabbix
./bootstrap.sh
./configure --enable-agent --enable-ipv6 --prefix=`pwd`
make dist该操作将create生成源码归档文件，之后可将其复制到Windows机器。
2。进入Zabbix构建目录并编译Zabbix agent（或其他组件），请确保正确指定OpenSSL和PCRE2的安装目录：
cd C:\Zabbix\zabbix-7.0.0\build\win32\project
# With TLS support:
nmake /K -f Makefile_agent PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib"
nmake /K -f Makefile_get PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib"
nmake /K -f Makefile_sender PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib" TLS=openssl TLSINCDIR="C:\Program Files\Zabbix\x64\OpenSSL\include" TLSLIBDIR="C:\Program Files\Zabbix\x64\OpenSSL\lib"
# Without TLS support:
nmake /K -f Makefile_agent PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib"
nmake /K -f Makefile_get PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib"
nmake /K -f Makefile_sender PCRE2INCDIR="C:\Program Files\Zabbix\x64\PCRE2\include" PCRE2LIBDIR="C:\Program Files\Zabbix\x64\PCRE2\lib"编译完成后，Zabbix组件二进制文件将存放在C:.064目录。Zabbix agent的配置file位于C:.0。
要runagent，请将zabbix_agent.exe及其配置filecopy到专用目录（如C:），然后runagent：