Raspberry Pi Imager의 숨겨진 고급 설정으로 모니터/키보드 없이(Headless) OS 설치하기
라즈베리파이를 처음 설정할 때 전용 모니터나 키보드가 없어도 네트워크를 통해 바로 원격 제어할 수 있습니다. Raspberry Pi Imager에서 제공하는 고급 설정 기능을 활용하면 OS 이미지를 쓰기 전 Wi-Fi 계정, 사용자 인증 정보, SSH 통신 옵션을 미리 기록할 수 있습니다. 이 글에서는 헤드리스 설치의 작동 원리와 실제 설정 방법, 그리고 접속 과정에서 발생하는 문제 해결법을 다룹니다.
Headless 설치의 원리와 준비물
헤드리스(Headless) 설치는 디스플레이나 키보드 같은 입출력 장치를 연결하지 않고 시동하는 방식입니다. 일반적인 단일 기판 컴퓨터(SBC) 부팅 과정에서는 초기 사용자 생성과 네트워크 접속을 위한 화면 조작이 필요하지만, 이미지 작성 과정에서 사전 구성 정보를 설정 파티션에 주입하면 이 과정을 생략할 수 있습니다.
Raspberry Pi Imager는 SD 카드에 OS를 저장할 때 시스템 초기화 스크립트가 참조할 사용자 계정, 비밀번호, 무선 네트워크 정보(SSID 및 암호), SSH 활성화 플래그를 미리 파일 형태로 저장합니다. 부팅 시 라즈베리파이는 이 파일들을 읽어 네트워크에 자동으로 접속하고 OpenSSH 데몬을 실행합니다. 시스템 구구동에 필요한 최신 보드 규격 및 인터페이스 사양은 공식 문서에서 최신 값을 확인하세요.
network 및 보안 설정 작업은 본인 소유 장비와 허락받은 네트워크 범위 안에서 진행해야 하며, 초기 비밀번호는 강력하게 설정해야 합니다.
고급 설정 기능 활용 및 초기 접속 방법
Imager 실행 후 대상 작업 장치와 OS를 선택하면 OS 맞춤 설정(OS Customisation) 대화상자가 나타납니다. 이 대화상자에서 헤드리스 통신에 필요한 정보를 입력합니다.
- Raspberry Pi Imager를 실행하고 대상 장치와 라즈베리파이 OS를 선택합니다.
- OS 맞춤 설정 편집 버튼을 클릭하거나 단축키
Ctrl + Shift + X를 눌러 고급 설정 창을 엽니다. - 호스트 이름, 사용자 이름 및 비밀번호 설정 항목을 활성화하고 사용할 계정을 지정합니다.
- 무선 LAN 설정을 활성화한 후 Wi-Fi SSID, 비밀번호, 국가 코드를 입력합니다.
- SSH 서비스 활성화 옵션을 선택하고 암호 인증 사용 또는 SSH 공개키를 등록합니다.
- 설정을 저장하고 SD 카드에 이미지를 작성합니다.
작성이 완료된 SD 카드를 라즈베리파이에 넣고 전원을 공급한 뒤, 동일한 무선 네트워크에 연결된 터미널에서 아래 명령어로 원격 접속을 진행합니다.
# 호스트 이름을 통한 SSH 원격 접속 예시
ssh myuser@raspberrypi.local
# 만약 호스트 이름 조회가 안 될 경우 IP 주소로 직접 접속
# ssh myuser@192.168.1.100SSH 열쇠 기반 인증을 사용할 경우 사용자 홈 디렉터리의 .ssh/authorized_keys 파일에 인증키가 올바르게 등록되었는지 검증해야 합니다.
자주 겪는 문제
- 증상: SSH 접속 시
Connection refused오류가 발생하며 접속되지 않습니다. - 원인: 고급 설정에서 SSH 활성화 옵션이 누락되었거나 부팅 시 SSH 데몬이 정상적으로 시작되지 않았습니다.
- 해결: SD 카드의 부팅 파티션(boot) 최상위 경로에 확장자가 없는
ssh빈 파일을 생성한 뒤 다시 부팅하거나, Imager에서 고급 설정을 재확인하여 다시 저장합니다.
- 증상:
raspberrypi.local호스트 이름으로 핑(Ping)이 가지 않고 IP를 찾지 못합니다. - 원인: 공유기 환경에서 mDNS(멀티캐스트 DNS)를 지원하지 않거나 무선 네트워크 SSID/비밀번호 오타로 인해 라즈베리파이가 Wi-Fi에 접속하지 못했습니다.
- 해결: 공유기 관리 페이지의 DHCP 할당 목록에서 라즈베리파이의 IP 주소를 직접 확인하여 IP로 접속하거나, 고급 설정에서 무선 네트워크 정보를 재입력합니다.
- 증상: SSH 접속 과정에서
Permission denied (publickey,password)오류가 발생합니다. - 원인: Imager에서 설정한 사용자 계정 이름 또는 비밀번호가 대소문자 차이 등으로 일치하지 않거나 SSH 공개키 형식이 올바르지 않습니다.
- 해결: Imager 고급 설정에서 사용자 계정 정보와 SSH 인증 방식을 정확히 다시 작성하여 SD 카드를 재생성합니다.
정리
- Raspberry Pi Imager의 고급 설정을 사용하면 모니터와 키보드 없이 무선 네트워크 접속 및 SSH 통신 환경을 즉시 구축할 수 있습니다.
- 원격 접속 시 보안 강화를 위해 기본 계정 정보를 변경하고 허락받은 네트워크 환경에서만 운영해야 합니다.
- 사용 중인 라즈베리파이 모델별 세부 전원 및 하드웨어 사양은 공식 문서에서 최신 값을 확인하세요.
참고 자료
- Raspberry Pi — Wikipedia · CC BY-SA
- Robertof/nixos-docker-sd-image-builder — GitHub · MIT
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.