Wazuh 아키텍처 및 Docker Compose를 통한 배포
Wazuh 4.9 모듈화된 도커 컨테이너 배포 가이드, 복잡한 알파벳 숫자 자격 증명 할당 및 보안 포트 라우팅 맵
이 가이드는 Wazuh 4.9의 단일 노드 도커 환경(single-node)에 대한 표준 기술 프로시저를 설명합니다. 이 모듈은 자원 계획, 호스트 환경 준비, docker-compose.yml 파일 구조화 및 보안 네트워크 라우팅 아키텍처를 다룹니다.
1. 자격 증명 계획 및 보안 강화
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Docker 엔진에서 컨테이너 초기화 중 파싱 오류(예: $ 또는 *의 특수 문자 오해)를 방지하고 Wazuh 보안 지침을 엄격히 준수하기 위해 주요 서비스용 고 엔트로피 알파벳 숫자 자격 증명 매트릭스가 정의되었습니다:
| 컴포넌트/서비스 | 정체성/사용자 | 예제 가상 비밀번호 | 통합 참고사항 |
|---|---|---|---|
| Wazuh 인덱서(Interface) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | 웹 관리 접근용 주 계정. |
| Wazuh 내부 API | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | 심볼 지침을 준수하기 위해 .에서 종료하는 것이 필수적입니다 |
| 통신 서비스 | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | 노드 간 내부 통신에 사용되는 계정입니다. |
2. 호스트(Ubuntu)에서 환경 프로비저닝
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»전체 배포는 호스트의 디렉토리 아래에 집약됩니다: /opt/wazuh-stack/single-node.
A. 공식 저장소 브랜치 복제
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh는 세 개의 주요 컨테이너(인덱서, 매니저, 대시보드) 간 엔드 투 엔드 통신을 암호화하기 위해 SSL/TLS 인증서가 필요합니다. 정확한 인증된 버전(v4.9.0)을 복제하려면 호스트 콘솔에 액세스하십시오:
# 1. Crear el directorio y clonar el repositorio oficial de desplieguesudo mkdir -p /opt/wazuh-stacksudo chown -R $USER:$USER /opt/wazuh-stackgit clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo únicocd /opt/wazuh-stack/single-nodeB. 인증 기관 및 TLS 인증서 생성
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»서비스의 공개 키 인프라(PKI) 및 디지털 서명을 자동으로 프로비저닝하기 위해 일시적인 컨테이너를 초기화하십시오:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. 생산용 Docker Compose 파일
Sección titulada «3. Archivo Docker Compose de Producción»이 파일은 최종 서비스 선언, 최적화된 커널 메모리 제한 및 환경의 초기 정적 자격 증명을 포함합니다.
파일 경로: /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:4. 포트 라우팅 지도 (보안 네트워크)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»블루 팀 분석가들이 경계 필터링 규칙(예: 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: 매니저의 제어 인터페이스입니다. 대시보드가 내부 관리 쿼리를 처리하는 데 사용됩니다.
B. 컨테이너: wazuh.indexer (저장소)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»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 파일이 구조화된 후 백그라운드에서 인프라를 시작하세요:
sudo docker compose up -d보안 경고
컨테이너가 Docker 엔진에서 올바르게 초기화되더라도, 다음 문서에 설명된 암호화된 해시를 생성하고 주입하지 않으면, 사양이 작동하지 않거나 안전하지 않습니다.

