GPTWOL은 사용자 지정 Docker 애플리케이션으로 ZimaOS에서 실행할 수 있지만, 커뮤니티 YAML에서 중요한 부분은 오래된 예시 인증 정보가 아닙니다. 애플리케이션이 로컬 네트워크에서 Wake-on-LAN 패킷을 전송하려면 호스트 네트워킹이 필요하고, 데이터베이스와 cron 데이터를 위한 영구 저장소도 필요하며, 다른 서비스가 이미 사용 중이지 않은 웹 포트를 지정해야 합니다.
2026년 1월 스레드는 작동하는 구성의 예시로 유용하지만, GPTWOL과 ZimaOS는 모두 발전해 왔습니다. 현재 GPTWOL 문서에서도 Wake-on-LAN에 호스트 네트워킹이 필요하다고 안내하지만, 최신 ZimaOS 릴리스는 더욱 향상된 YAML 작업 흐름을 제공합니다. 원본 파일은 시작점으로만 사용하고, 가져오기 전에 최신 업스트림 옵션을 확인하세요.
커뮤니티 YAML에서 구성한 항목
공유된 애플리케이션 정의는 misterbabou/gptwol:latest 이미지를 사용하고, network_mode: host와 restart: unless-stopped를 지정했습니다. 또한 /app/db와 /etc/cron.d에 연결된 두 개의 호스트 폴더에 GPTWOL 상태 데이터를 영구 저장했습니다.
원본 구성은 GPTWOL 인터페이스를 포트 99로 노출하고 예약된 깨우기 작업을 위한 시간대를 설정했습니다. 이러한 값은 모든 환경에 동일하게 적용되지 않습니다. 사용 가능한 호스트 포트를 선택하고 컨테이너가 실행되는 시스템에 맞는 시간대를 사용하세요.
GPTWOL이 호스트 네트워킹을 사용하는 이유
GPTWOL의 최신 업스트림 문서에 따르면 컨테이너가 LAN에서 Wake-on-LAN 명령을 전송하려면 호스트 네트워크 모드가 필요합니다. 이는 일반적인 웹 애플리케이션이 Docker 브리지 네트워킹으로 격리된 상태에서 단일 게시 포트만 사용해도 되는 경우와 다릅니다.
호스트 네트워킹을 사용하면 포트를 확인하는 방식도 달라집니다. 애플리케이션이 ZimaOS 호스트 네트워크에서 직접 수신 대기하므로, 선택한 GPTWOL 포트가 이미 비어 있어야 합니다. 웹 페이지가 열리지 않으면 관련 없는 라우터 설정을 변경하기 전에 구성된 포트를 확인하고 다른 서비스가 해당 포트에서 수신 대기 중인지 점검하세요.
최신 GPTWOL Docker 구성에는 필요한 네트워크 모드, 저장 경로, 인증 옵션 및 예약 기능이 설명되어 있습니다.
예시 로그인 인증 정보를 재사용하지 마세요
커뮤니티 YAML은 로컬 인증을 활성화하고 간단한 예시 인증 정보를 사용했습니다. 이는 원본 게시자가 앱을 구성한 방식의 예일 뿐, 새 설치에 그대로 복사해 사용할 안전한 기본값이 아닙니다.
로컬 인증을 활성화한다면 실제로 배포하기 전에 공개된 예시 사용자 이름과 비밀번호를 변경하세요. 최신 릴리스의 GPTWOL은 OIDC도 지원합니다. 어느 방식을 사용하든 업스트림 프로젝트는 적절한 인증 없이 서비스를 공용 인터넷에 직접 노출하지 말라고 경고합니다.
Wake-on-LAN은 일반적으로 LAN 내부에서 제어하는 기능입니다. 외부에서 집에 있는 장치를 깨워야 한다면 GPTWOL 웹 인터페이스를 공용 포트에 직접 노출하는 대신 안전한 원격 액세스 계층을 사용하는 것이 좋습니다.
최신 ZimaOS에서 YAML 가져오기 또는 편집
2026년 1월 스레드는 현재의 App Store 2.0 YAML 환경이 도입되기 전 작성되었습니다. ZimaOS 1.7에서는 애플리케이션용 네이티브 YAML 편집 기능이 추가되었고, ZimaOS 1.7.1에서는 YAML 저장 호환성이 더욱 개선되었습니다. 따라서 원본 게시물의 스크린샷이나 버튼 위치가 현재 인터페이스와 다를 수 있습니다.
Compose 서비스 정의는 이미지, 호스트 네트워킹, 재시작 정책, 필수 환경 값 및 영구 볼륨으로 간단하게 유지하세요. 내보낸 파일에 포함되어 있다는 이유만으로 오래된 x-casaos 메타데이터를 그대로 가져오지 말고, 현재 ZimaOS 앱 작업 흐름에 실제로 필요한 경우에만 사용하세요.
ZimaOS 1.7.1 릴리스 노트에는 최신 YAML 호환성 개선 사항이 설명되어 있습니다.
GPTWOL은 WOL을 지원하지 않는 대상에서 WOL을 활성화할 수 없습니다
GPTWOL은 깨우기 패킷을 전송할 뿐, 호환되지 않는 컴퓨터가 깨어날 수 있도록 만들어 주지는 않습니다. 대상 컴퓨터에서 펌웨어와 운영 체제의 Wake-on-LAN이 활성화되어 있어야 하며, 네트워크 어댑터가 의도한 전원 상태에서 매직 패킷을 수신할 수 있는 상태로 유지되어야 합니다.
컨테이너를 디버깅하기 전에 동일한 LAN에서 정상 작동이 확인된 다른 WOL 도구로 대상 장치를 깨울 수 있는지 확인하세요. 작동한다면 GPTWOL을 테스트하세요. 어떤 도구로도 대상을 깨울 수 없다면 먼저 대상 컴퓨터의 BIOS, NIC, 종료 상태 및 네트워크 경로를 점검해야 합니다.
