Ir al contenido

Wazuh 아키텍처 및 Docker Compose를 통한 배포

Wazuh 4.9 모듈화된 도커 컨테이너 배포 가이드, 복잡한 알파벳 숫자 자격 증명 할당 및 보안 포트 라우팅 맵

0조회

이 가이드는 Wazuh 4.9의 단일 노드 도커 환경(single-node)에 대한 표준 기술 프로시저를 설명합니다. 이 모듈은 자원 계획, 호스트 환경 준비, docker-compose.yml 파일 구조화 및 보안 네트워크 라우팅 아키텍처를 다룹니다.


Docker 엔진에서 컨테이너 초기화 중 파싱 오류(예: $ 또는 *의 특수 문자 오해)를 방지하고 Wazuh 보안 지침을 엄격히 준수하기 위해 주요 서비스용 고 엔트로피 알파벳 숫자 자격 증명 매트릭스가 정의되었습니다:

컴포넌트/서비스정체성/사용자예제 가상 비밀번호통합 참고사항
Wazuh 인덱서(Interface)adminzR9mK2vX5pW8qN3tY6cR4vB1웹 관리 접근용 주 계정.
Wazuh 내부 APIwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.심볼 지침을 준수하기 위해 .에서 종료하는 것이 필수적입니다
통신 서비스kibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1노드 간 내부 통신에 사용되는 계정입니다.

전체 배포는 호스트의 디렉토리 아래에 집약됩니다: /opt/wazuh-stack/single-node.

Wazuh는 세 개의 주요 컨테이너(인덱서, 매니저, 대시보드) 간 엔드 투 엔드 통신을 암호화하기 위해 SSL/TLS 인증서가 필요합니다. 정확한 인증된 버전(v4.9.0)을 복제하려면 호스트 콘솔에 액세스하십시오:

Ventana de terminal
# 1. Crear el directorio y clonar el repositorio oficial de despliegue
sudo mkdir -p /opt/wazuh-stack
sudo chown -R $USER:$USER /opt/wazuh-stack
git clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo único
cd /opt/wazuh-stack/single-node

서비스의 공개 키 인프라(PKI) 및 디지털 서명을 자동으로 프로비저닝하기 위해 일시적인 컨테이너를 초기화하십시오:

Ventana de terminal
sudo docker compose -f generate-indexer-certs.yml run --rm generator

이 파일은 최종 서비스 선언, 최적화된 커널 메모리 제한 및 환경의 초기 정적 자격 증명을 포함합니다.

파일 경로: /opt/wazuh-stack/single-node/docker-compose.yml

# Wazuh App Copyright (C) 2017, Wazuh Inc. (License GPLv2)
services:
wazuh.manager:
image: wazuh/wazuh-manager:4.9.0
hostname: wazuh.manager
restart: always
ports:
- "1514:1514"
- "1515:1515"
- "514:514/udp"
- "55000:55000"
ulimits:
memlock:
soft: -1
hard: -1
nofile:
soft: 655360
hard: 655360
environment:
- INDEXER_URL=https://wazuh.indexer:9200
- INDEXER_USERNAME=admin
- INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1
- FILEBEAT_SSL_VERIFICATION_MODE=full
- SSL_CERTIFICATE_AUTHORITIES=/etc/ssl/root-ca.pem
- SSL_CERTIFICATE=/etc/ssl/filebeat.pem
- SSL_KEY=/etc/ssl/filebeat.key
- API_USERNAME=wazuh-wui
- API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9.
- TZ=Europe/Madrid
volumes:
- wazuh_api_configuration:/var/ossec/api/configuration
- wazuh_etc:/var/ossec/etc
- wazuh_logs:/var/ossec/logs
- wazuh_queue:/var/ossec/queue
- wazuh_var_multigroups:/var/ossec/var/multigroups
- wazuh_integrations:/var/ossec/integrations
- wazuh_active_response:/var/ossec/active-response/bin
- wazuh_agentless:/var/ossec/agentless
- wazuh_wodles:/var/ossec/wodles
- filebeat_etc:/etc/filebeat
- filebeat_var:/var/lib/filebeat
- ./config/wazuh_indexer_ssl_certs/root-ca-manager.pem:/etc/ssl/root-ca.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.manager.pem:/etc/ssl/filebeat.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.manager-key.pem:/etc/ssl/filebeat.key
- ./config/wazuh_cluster/wazuh_manager.conf:/wazuh-config-mount/etc/ossec.conf
wazuh.indexer:
image: wazuh/wazuh-indexer:4.9.0
hostname: wazuh.indexer
restart: always
ports:
- "9200:9200"
environment:
- "OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g"
- TZ=Europe/Madrid
ulimits:
memlock:
soft: -1
hard: -1
nofile:
soft: 65536
hard: 65536
volumes:
- wazuh-indexer-data:/var/lib/wazuh-indexer
- ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-indexer/certs/root-ca.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.indexer-key.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.key
- ./config/wazuh_indexer_ssl_certs/wazuh.indexer.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.pem
- ./config/wazuh_indexer_ssl_certs/admin.pem:/usr/share/wazuh-indexer/certs/admin.pem
- ./config/wazuh_indexer_ssl_certs/admin-key.pem:/usr/share/wazuh-indexer/certs/admin-key.pem
- ./config/wazuh_indexer/wazuh.indexer.yml:/usr/share/wazuh-indexer/opensearch.yml
- ./config/wazuh_indexer/internal_users.yml:/usr/share/wazuh-indexer/opensearch-security/internal_users.yml
wazuh.dashboard:
image: wazuh/wazuh-dashboard:4.9.0
hostname: wazuh.dashboard
restart: always
ports:
- "443:5601"
environment:
- INDEXER_USERNAME=admin
- INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1
- WAZUH_API_URL=https://wazuh.manager
- DASHBOARD_USERNAME=kibanaserver
- DASHBOARD_PASSWORD=yQ3wV8xR9pK2mN6tT5sR4vC1
- API_USERNAME=wazuh-wui
- API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9.
- TZ=Europe/Madrid
volumes:
- ./config/wazuh_indexer_ssl_certs/wazuh.dashboard.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.dashboard-key.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard-key.pem
- ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-dashboard/certs/root-ca.pem
- ./config/wazuh_dashboard/opensearch_dashboards.yml:/usr/share/wazuh-dashboard/config/opensearch_dashboards.yml
- ./config/wazuh_dashboard/wazuh.yml:/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml
- wazuh-dashboard-config:/usr/share/wazuh-dashboard/data/wazuh/config
- wazuh-dashboard-custom:/usr/share/wazuh-dashboard/plugins/wazuh/public/assets/custom
depends_on:
- wazuh.indexer
links:
- wazuh.indexer:wazuh.indexer
- wazuh.manager:wazuh.manager
networks:
default:
name: wazuh_local
volumes:
wazuh_api_configuration:
wazuh_etc:
wazuh_logs:
wazuh_queue:
wazuh_var_multigroups:
wazuh_integrations:
wazuh_active_response:
wazuh_agentless:
wazuh_wodles:
filebeat_etc:
filebeat_var:
wazuh-indexer-data:
wazuh-dashboard-config:
wazuh-dashboard-custom:

블루 팀 분석가들이 경계 필터링 규칙(예: pfSense 방화벽 또는 호스트 정책)을 올바르게 구성할 수 있도록, 매핑된 포트의 기술적 기능을 상세히 설명합니다.

A. 컨테이너: wazuh.manager (분석 브레인)

Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»
  • 1514 (TCP/UDP) - 에이전트: 비상 통신 포트. 원격 수집 에이전트가 여기서 실시간으로 암호 해독 로그와 메타데이터를 전송합니다.
  • 1515 (TCP) - Authd: 에이전트 등록 서비스 포트. 새 노드를 연결할 때만 대칭 암호화 키를 생성하고 전송하는 데 사용됩니다.
  • 514 (UDP) - Syslog: 내장 에이전트를 지원하지 않는 네트워크 장치(라우터, pfSense 방화벽, 스위치 등)의 로그 수집용 옵셔널 서비스입니다.
  • 55000 (TCP) - REST API: 매니저의 제어 인터페이스입니다. 대시보드가 내부 관리 쿼리를 처리하는 데 사용됩니다.
  • 9200 (TCP) - OpenSearch API: 인덱싱 데이터베이스의 읽기/쓰기 포트입니다. Filebeat이 이곳에 경고를 입력하고 대시보드가 이를 검색하여 그래프에 표시합니다.

C. 컨테이너: wazuh.dashboard (웹 콘솔)

Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»
  • 443 ➔ 5601 (TCP) - HTTPS 포털: 내부 서비스는 5601 포트를 사용하지만, Docker에서 호스트의 표준 443 (HTTPS) 포트로 매핑되어 브라우저에서 비정상적인 포트를 지정하지 않고 깨끗하고 직접적인 액세스를 가능하게 합니다.

docker-compose.yml 파일이 구조화된 후 백그라운드에서 인프라를 시작하세요:

Ventana de terminal
sudo docker compose up -d

보안 경고

컨테이너가 Docker 엔진에서 올바르게 초기화되더라도, 다음 문서에 설명된 암호화된 해시를 생성하고 주입하지 않으면, 사양이 작동하지 않거나 안전하지 않습니다.