Windows MSI 설치

Zabbix v7.4번역일: 2026-09-09원본 보기

개요

Zabbix agent는 다운로드할 수 있는 32비트 또는 64비트 MSI 설치 프로그램 패키지를 사용하여 Windows에 설치할 수 있습니다.

MSI 설치를 위한 최소 OS 요구 사항은 다음과 같습니다.

  • 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 데몬, Zabbix sender, Zabbix get)를 선택합니다.

설치 프로그램에서 제공하는 기본 설치 위치를 사용하는 것이 좋습니다. 필요한 권한 없이 사용자 지정 위치를 사용하면 설치 보안이 저하될 수 있습니다.

Program Files 디렉터리 외부의 사용자 지정 위치를 사용하고 대상 폴더가 이미 존재하는 경우 설치 프로그램은 해당 권한을 변경하지 않습니다. 새로 설치할 때 적절한 권한을 수동으로 설정하거나 권한을 변경하지 않고 계속하도록 요청하는 메시지가 표시됩니다.

4. 다음 매개변수를 구성합니다. 해당 값은 Zabbix agent 구성 파일에 설정됩니다.

매개변수 설명
호스트 이름 Zabbix agent가 설치되는 시스템의 호스트 이름입니다. Hostname 매개변수를 설정합니다.
Zabbix server IP/DNS 쉼표로 구분된 Zabbix server 또는 Zabbix proxy의 IP 주소(선택적으로 CIDR 표기법 사용)나 DNS 이름 목록입니다. 이 매개변수는 필수입니다. Server 매개변수를 설정합니다.
Agent 수신 포트 Agent가 server의 연결을 수신할 포트입니다. ListenPort 매개변수를 설정합니다.
능동 검사용 Server 또는 Proxy 능동 검사를 가져올 Zabbix server/proxy 주소 또는 클러스터 구성입니다. Server/proxy 주소는 IP 주소 또는 DNS 이름이며, 선택적 포트는 콜론으로 구분합니다. ServerActive 매개변수를 설정합니다.
PSK 활성화 사전 공유 키를 사용하는 TLS 지원을 활성화하려면 확인란을 선택합니다. TLSConnect 및 TLSAccept 매개변수를 psk로 설정합니다.
PATH에 agent 위치 추가 Zabbix agent 위치를 시스템 PATH 변수에 추가하려면 확인란을 선택합니다.

기존 Zabbix agent가 감지되면 해당 구성 파일의 매개변수 값이 표시됩니다. 또한 설치 중 기존 구성 파일의 이름이 변경되고 새 구성 파일이 생성됩니다.

5. 이전 단계에서 PSK 활성화 확인란을 선택한 경우 PSK 매개변수를 구성합니다. 이러한 매개변수도 Zabbix agent 구성 파일에 설정됩니다.

매개변수 설명
사전 공유 키 ID 사전 공유 키 ID 문자열입니다. TLSPSKIdentity 매개변수를 설정합니다.
사전 공유 키 값 사전 공유 키 문자열 값입니다. 키가 포함된 psk.key 파일을 생성하고 TLSPSKFile 매개변수를 키 위치(기본값: C:\Program Files\Zabbix Agent\psk.key)로 설정합니다. Zabbix agent(또는 agent를 실행하는 사용자)만 읽을 수 있도록 파일의 보안 설정을 조정하여 사전 공유 키 파일에 대한 액세스를 제한하는 것이 권장됩니다.

6. 설치를 클릭하여 설치를 시작합니다.

선택한 모든 Zabbix 구성 요소와 Zabbix agent 구성 파일이 지정한 위치(기본값: C:\Program Files\Zabbix Agent)에 설치됩니다. Zabbix agent 2도 동일하지만 내장 플러그인의 추가 구성 파일은 zabbix_agent2.d\plugins.d 하위 폴더에 설치됩니다.

또한 zabbix_agentd.exe(또는 zabbix_agent2.exe)가 지연된 자동 시작(Windows Vista/Server 2008 이전 Windows 버전에서는 자동 시작)을 사용하는 Windows 서비스로 설정됩니다.

설치 중 다른 버전의 Zabbix agent가 실행 중이면 애플리케이션을 닫고 다시 시작을 시도하거나 열린 상태로 두는 옵션 중 하나를 선택하라는 메시지가 표시됩니다. 열린 상태로 두면 재부팅해야 합니다.

7. 마침 버튼을 클릭하여 설치 마법사를 종료합니다.

명령줄에서 설치

msiexec로 MSI 설치 프로그램을 실행하여 명령줄에서 Zabbix agent를 설치할 수 있습니다. 예:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.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) 페이지를 참조하십시오.

매개변수 설명
ADDDEFAULT 기본 구성으로 설치할 구성 요소를 쉼표로 구분한 목록입니다. 자세한 내용은 ADDDEFAULT 속성을 참조하십시오.
가능한 값: AgentProgram, GetProgram, SenderProgram, ALL
예: ADDDEFAULT=AgentProgram,GetProgram
ADDLOCAL 로컬에 설치할 구성 요소를 쉼표로 구분한 목록입니다. 자세한 내용은 ADDLOCAL 속성을 참조하십시오.
가능한 값: 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 MSI 설치 프로그램이 Zabbix agent 서비스를 시작하지 않도록 하려면 DONOTSTART=1을 사용합니다.
Zabbix 7.4.6부터 MSI 설치 프로그램 패키지에서 지원됩니다.
ENABLEPATH Zabbix agent 위치를 시스템 PATH 변수에 추가하려면 ENABLEPATH=1을 사용합니다.
ENABLEPERSISTENTBUFFER Zabbix agent 2 전용입니다. 능동 항목에 로컬 영구 저장소 사용을 활성화합니다.
HOSTINTERFACE 호스트 인터페이스를 정의하는 선택적 매개변수입니다.
HOSTMETADATA 호스트 메타데이터를 정의하는 선택적 매개변수입니다.
HOSTMETADATAITEM 호스트 메타데이터를 가져오는 데 사용할 항목을 정의하는 선택적 매개변수입니다.
HOSTNAME 호스트 이름을 정의하는 선택적 매개변수입니다.
HOSTNAMEITEM 호스트 이름을 가져오는 데 사용할 항목을 정의하는 선택적 매개변수입니다.
Zabbix 7.4.6부터 MSI 설치 프로그램 패키지에서 지원됩니다.
INCLUDE Zabbix agent 구성 파일에 포함할 개별 파일 또는 디렉터리의 모든 파일을 세미콜론으로 구분한 목록입니다.
IGNOREALREADYEXISTSFOLDER 새로 설치할 때 Program Files 디렉터리 외부의 기존 대상 폴더에 설치할 수 있도록 하려면 IGNOREALREADYEXISTSFOLDER=1을 사용합니다. 이 매개변수를 지정하지 않으면 이러한 대상 폴더가 이미 존재할 때 설치가 실패합니다.
INSTALLFOLDER Zabbix 구성 요소와 Zabbix agent 구성 파일이 설치될 폴더의 전체 경로 이름입니다. Zabbix agent 2의 경우 내장 플러그인용 추가 구성 파일은 zabbix_agent2.d\plugins.d 하위 폴더에 설치됩니다.
예: INSTALLFOLDER="C:\Program Files\Zabbix Agent"
LISTENIP Agent가 수신 대기할 IP 주소를 쉼표로 구분한 목록입니다.
LISTENPORT Agent가 server의 연결을 수신할 포트입니다.
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 전용입니다. Server 또는 proxy에 연결되지 않았을 때 데이터를 저장할 기간입니다.
SERVER 쉼표로 구분된 Zabbix server 또는 Zabbix proxy의 IP 주소(선택적으로 CIDR 표기법 사용)나 DNS 이름 목록입니다. STARTAGENTS가 0으로 설정된 경우를 제외하고 이 매개변수는 필수입니다.
SERVERACTIVE 능동 검사를 가져올 Zabbix server/proxy 주소 또는 클러스터 구성입니다.
SKIP MSI 설치 프로그램이 Zabbix agent에 대한 Windows Firewall 예외 규칙을 추가하지 않도록 하려면 SKIP=fw를 사용합니다.
SOURCEIP Zabbix server 또는 Zabbix proxy로 나가는 연결이나 일부 항목(web.page.get, net.tcp.port 등)을 실행하는 동안 연결할 때 사용할 소스 IP 주소입니다.
Zabbix 7.4.6부터 MSI 설치 프로그램 패키지에서 지원됩니다.
STARTAGENTS 수동 검사를 처리하는 사전 포크된 zabbix_agentd 인스턴스 수입니다.
0으로 설정하면 수동 검사가 비활성화되고 agent는 어떤 TCP 포트에서도 수신 대기하지 않습니다.
Zabbix 7.4.6부터 MSI 설치 프로그램 패키지에서 지원됩니다.
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 또는 server와 연결을 설정하고 데이터를 교환할 때 대기할 시간(초)을 지정합니다.
TLSACCEPT 허용할 수신 연결입니다(수동 검사에 사용). psk로 설정하면 달리 지정하지 않는 한 TLSCONNECT도 psk로 설정됩니다.
TLSCAFILE 피어 인증서 검증을 위한 최상위 CA 인증서가 포함된 파일의 전체 경로 이름입니다.
TLSCERTFILE Agent 인증서 또는 인증서 체인이 포함된 파일의 전체 경로 이름입니다.
TLSCONNECT Agent가 Zabbix server 또는 proxy에 연결하는 방식입니다(능동 검사에 사용). psk로 설정하면 달리 지정하지 않는 한 TLSACCEPT도 psk로 설정됩니다.
TLSCRLFILE 해지된 인증서가 포함된 파일의 전체 경로 이름입니다.
TLSKEYFILE Zabbix agent 개인 키가 포함된 파일의 전체 경로 이름입니다.
TLSPSKFILE Zabbix agent 사전 공유 키가 포함된 파일의 전체 경로 이름입니다. TLSPSKFILE과 TLSPSKVALUE가 모두 설정된 경우 TLSPSKVALUE의 값이 TLSPSKFILE에 지정된 파일에 기록됩니다. Zabbix agent(또는 agent를 실행하는 사용자)만 읽을 수 있도록 파일의 보안 설정을 조정하여 사전 공유 키 파일에 대한 액세스를 제한하는 것이 권장됩니다.
TLSPSKIDENTITY 사전 공유 키 ID 문자열입니다.
TLSPSKVALUE 사전 공유 키 문자열 값입니다. TLSPSKFILE과 TLSPSKVALUE가 모두 설정된 경우 TLSPSKVALUE의 값이 TLSPSKFILE에 지정된 파일에 기록됩니다.
예: TLSPSKVALUE=1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952
TLSSERVERCERTISSUER 허용되는 server(proxy) 인증서 발급자입니다.
TLSSERVERCERTSUBJECT 허용되는 server(proxy) 인증서 주체입니다.
UNSAFEUSERPARAMETERS 사용자 정의 매개변수의 인수에 모든 문자를 전달할 수 있도록 허용합니다.
Zabbix 7.4.6부터 MSI 설치 프로그램 패키지에서 지원됩니다.
예

다음 예에서는 사용자 지정 구성으로 Zabbix agent를 설치합니다. 또한 사전 공유 키를 사용하는 TLS 지원을 활성화합니다.

mkdir "C:\Program Files\Zabbix Agent" 2>nul
msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent-7.4.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-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent.conf"

# agent-template.conf example:
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-7.4.1-windows-amd64-openssl.msi" /qn+ NONMSICONFNAME="C:\agent-custom.conf"

# agent-custom.conf example:
Server=192.0.2.8
Hostname=DESKTOP-X9F4A2B

Zabbix agent 2 로드 가능 플러그인

Zabbix agent 2 로드 가능 플러그인은 다운로드할 수 있는 64비트 MSI 설치 프로그램 패키지를 사용하여 Windows에 설치할 수 있습니다.

MSI 설치를 위한 최소 OS 요구 사항은 Windows 10(64비트) 또는 Windows Server 2016입니다.

Zabbix agent/agent2와 마찬가지로 로드 가능 플러그인은 설치 마법사 또는 명령줄을 사용하여 설치할 수 있습니다.

플러그인을 설치하기 전에 README 파일을 확인하십시오. 여기에 특정 요구 사항과 설치 지침이 포함되어 있을 수 있습니다.

설치 마법사에서 설치

1. 다운로드한 MSI 파일을 두 번 클릭하여 설치를 시작합니다.

2. 최종 사용자 사용권 계약에 동의합니다.

3. 설치할 Zabbix agent 2 로드 가능 플러그인을 선택합니다.

설치 프로그램에서 제공하는 기본 설치 위치를 사용하는 것이 좋습니다. 필요한 권한 없이 사용자 지정 위치를 사용하면 설치 보안이 저하될 수 있습니다.

4. 설치를 클릭하여 설치를 시작합니다.

선택한 모든 Zabbix agent 2 로드 가능 플러그인은 지정한 위치(기본값: C:\Program Files\Zabbix Agent 2)에 설치되고, 해당 구성 파일은 zabbix_agent2.d 하위 폴더에 설치됩니다.

5. 마침 버튼을 클릭하여 설치 마법사를 종료합니다.

명령줄에서 설치

msiexec로 MSI 설치 프로그램을 실행하여 명령줄에서 Zabbix agent 2 로드 가능 플러그인을 설치할 수 있습니다. 예:

msiexec.exe /l*v "C:\package.log" /i "C:\zabbix_agent2_plugins-7.4.0-windows-amd64.msi" /qn+

Zabbix agent 2 로드 가능 플러그인 MSI 설치 프로그램 패키지는 다음 매개변수를 지원합니다.

매개변수 설명
ADDDEFAULT 기본 구성으로 설치할 구성 요소를 쉼표로 구분한 목록입니다. 자세한 내용은 ADDDEFAULT 속성을 참조하십시오.
가능한 값: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
예: ADDDEFAULT=MongodbPlugin,PostgresqlPlugin
ADDLOCAL 로컬에 설치할 구성 요소를 쉼표로 구분한 목록입니다. 자세한 내용은 ADDLOCAL 속성을 참조하십시오.
가능한 값: ALL, EmberplusPlugin, MongodbPlugin, MssqlPlugin, NvidiagpuPlugin, PostgresqlPlugin
예: ADDLOCAL=MongodbPlugin,MssqlPlugin
INSTALLFOLDER Zabbix 구성 요소가 설치될 폴더의 전체 경로 이름이며, 해당 구성 파일은 zabbix_agent2.d 하위 폴더에 설치됩니다.
예: INSTALLFOLDER="C:\Program Files\Zabbix Agent 2"