Pi Node 도커 오류 해결 전 확인할 WSL·로그·데이터 백업

차근차근 알아보기

Pi Node에서 Docker 연결 오류가 표시되면 어느 프로그램이 어떤 오류를 내는지 먼저 확인하세요. 무조건 Docker를 예전 버전으로 바꾸거나 컨테이너를 삭제하는 방식은 다른 문제와 데이터 손실을 만들 수 있습니다.

오류를 기록하는 순서

1. Pi Node와 Docker Desktop의 오류 문구를 각각 기록합니다.
2. 운영체제, Docker 버전, 사용 중인 WSL 환경을 확인합니다.
3. Docker Desktop이 자체적으로 정상 실행되는지 확인합니다.
4. 공식 지원 문서의 현재 요구 사항과 비교합니다.

Pi Node의 호환 조건은 현재 배포 안내를 따르세요. 특정 과거 Docker 버전을 모든 사용자에게 권장하거나 자동 보안 업데이트를 꺼두는 방식으로 고정하지 마세요.

WSL 문제가 표시될 때

Docker의 Windows WSL 안내와 Microsoft WSL 문제 해결 문서를 확인하세요. Windows의 가상화·WSL 상태를 확인하고 필요한 업데이트를 진행합니다. 상태 확인 단계에서 배포판 삭제나 초기화 명령을 실행할 필요는 없습니다.

Docker는 켜지는데 Node만 연결되지 않을 때

앱 로그와 버전별 호환 안내를 확인하세요. 인증 없는 Docker daemon TCP 노출을 기본 해결책으로 켜지 않습니다. Docker 관리 소켓은 강한 권한을 제공하므로 Docker의 접근 보호 문서가 설명하는 보호 원칙을 지켜야 합니다.

삭제·재설치 전에 확인하기

컨테이너·볼륨·설정 파일에는 운영 데이터가 들어 있을 수 있습니다. 보관 대상과 복원 방법을 확인하고 백업한 다음, 해당 버전의 공식 복구 절차에서 필요한 작업만 진행하세요. 로그 일부를 공유할 때에는 토큰·계정 정보·개인 경로를 가려야 합니다.

네트워크가 의심되더라도 공유기 포트 전체 개방이나 방화벽 전체 해제를 먼저 하지 마세요. 필요한 통신 조건을 공식 문서에서 확인하고 해당 범위만 점검합니다.