如何重新编译Zabbix Agent 2的MSI包并修改配置以添加自定义插件？

要在Windows环境下修改Zabbix Agent 2的MSI安装包，添加自定义插件并更新配置，你可以按照以下步骤操作，核心是先提取MSI内容、修改后重新打包：

1. 准备必要工具 #

• Orca编辑器：Windows SDK自带的MSI编辑工具，也可以单独下载安装。
• WiX工具集（可选）：如果习惯命令行操作，WiX的dark（解包）和light（打包）工具更高效。
• 管理员权限：所有操作都需要以管理员身份执行，避免权限不足问题。

2. 提取MSI安装包内容 #

先把原MSI的内容提取到本地目录，方便修改：

msiexec /a "Zabbix Agent 2.msi" /qb TARGETDIR=C:\temp\zabbix_agent_extract

• /a表示管理员安装（提取模式），TARGETDIR指定提取后的目录路径，可自行修改。

3. 添加自定义插件并修改配置文件 #

• 放置插件文件：在提取目录的bin文件夹下新建plugins目录（如果没有），将你的自定义插件文件（比如custom_plugin.dll）复制到这个plugins文件夹中。
• 修改配置文件：找到提取目录中的zabbix_agent2.conf，用文本编辑器打开，添加以下配置（根据实际情况修改）：

  # 指定插件目录（对应*安装完成后的目标路径*，默认安装路径是C:\Program Files\Zabbix Agent 2）
  Plugins.Path=C:\Program Files\Zabbix Agent 2\bin\plugins
  # 启用自定义插件
  Plugins.CustomPlugin=custom_plugin.dll
  

  注意：这里的路径是安装完成后的目标路径，不是提取目录的路径。

4. 重新打包MSI包 #

这里提供两种常用方法：

方法一：用Orca图形化编辑 #

1. 打开Orca工具，加载原Zabbix Agent 2 MSI文件。
2. 在左侧面板找到File表：
   • 点击右键选择Add Row，添加插件文件的条目：
     • FileName：填写插件文件名（比如custom_plugin.dll）
     • Component_：新建一个组件名（比如CustomPluginComponent）
     • DestinationFolder：选择ProgramFilesFolder\Zabbix Agent 2\bin\plugins（如果没有这个目录条目，先在Directory表添加）
   • 找到zabbix_agent2.conf对应的条目，点击File列的路径，替换为你修改后的配置文件路径。
3. 保存修改后的MSI为新文件（比如Zabbix Agent 2_Custom.msi）。

方法二：用WiX工具集命令行操作 #

1. 解包原MSI：

   dark.exe "Zabbix Agent 2.msi" -x C:\temp\zabbix_unpack
   

   -x表示提取所有文件到指定目录。
2. 将修改后的zabbix_agent2.conf和插件文件替换到C:\temp\zabbix_unpack对应的目录中。
3. 重新打包MSI：

   light.exe C:\temp\zabbix_unpack\Product.wxs -out "Zabbix Agent 2_Custom.msi"
   

5. 测试验证 #

安装修改后的MSI包，完成后：

• 检查C:\Program Files\Zabbix Agent 2\bin\plugins目录是否存在你的自定义插件。
• 查看C:\Program Files\Zabbix Agent 2\zabbix_agent2.conf确认配置是否正确。
• 启动Zabbix Agent 2服务，查看日志确认插件是否成功加载。

注意事项 #

• 确保自定义插件与Windows系统版本（32/64位）和Zabbix Agent 2版本兼容。
• 操作前务必备份原MSI文件，避免误操作导致原包损坏。
• 如果使用Orca，注意Component表需要对应新增的组件，否则可能导致安装失败。

内容的提问来源于stack exchange，提问作者Raul Chiarella