라즈베리파이 SSH 활성화와 접속 확인 방법

라즈베리파이 SSH 활성화와 접속 확인 방법

라즈베리파이에서 SSH를 켜면 모니터와 키보드를 연결하지 않아도 다른 PC에서 터미널로 접속할 수 있다. 2026년 7월 28일 확인 기준 Raspberry Pi 공식 문서는 Raspberry Pi OS에서 SSH 서버가 기본적으로 비활성화되어 있으며, 데스크톱, Raspberry Pi Imager, raspi-config, 부팅 파티션의 ssh 파일 생성 방식으로 활성화할 수 있다고 안내한다.

실무에서는 "처음 설치할 때 미리 켜 둘지", "이미 부팅한 장치에서 나중에 켤지", "접속이 안 될 때 무엇부터 확인할지"가 핵심이다. 이 글은 Raspberry Pi 공식 문서를 기준으로 SSH 활성화 방법, 첫 접속 조건, IP 확인, 접속 점검 순서를 한 번에 정리한다.

라즈베리파이에서 SSH는 언제 켜는 편이 좋을까?

라즈베리파이를 헤드리스로 운영하거나, 네트워크 안에서 원격 터미널이 필요하거나, 파일 복사와 자동화 작업을 SSH 기반으로 처리할 계획이라면 처음부터 활성화하는 편이 편하다. 반대로 로컬 디스플레이와 입력 장치를 항상 연결해 두고 원격 셸이 필요 없다면 기본 비활성 상태를 유지하는 쪽이 단순하다.

공식 문서 기준 첫 부팅 직후 원격 제어 수단으로 가장 먼저 쓰기 쉬운 방법은 SSH다. 특히 설치 단계에서 Raspberry Pi Imager로 계정과 인증 방식을 함께 미리 넣어 두면 이후 접속 과정이 가장 매끄럽다.

가장 간단한 방법은 Raspberry Pi Imager에서 미리 SSH를 켜는 것이다

새 OS 이미지를 준비하는 단계라면 Raspberry Pi Imager의 Remote Access 설정이 가장 안전하다. 공식 문서는 Customisation의 Remote Access 탭에서 SSH를 켜고, 비밀번호 인증 또는 공개키 인증을 선택할 수 있다고 설명한다.

이 방법의 장점은 첫 부팅 전부터 사용자 계정과 접속 수단이 준비된다는 점이다. 모니터 없이 설치하는 경우에도 별도 수동 파일 작업 없이 바로 접속을 시도할 수 있다.

• 새 microSD 또는 저장장치에 Raspberry Pi OS를 기록할 때 SSH를 함께 설정할 수 있다.
• 비밀번호 인증과 공개키 인증 중 하나를 선택할 수 있다.
• 공개키 인증을 쓰면 이후 비밀번호 입력 없이 접속하도록 구성하기 쉽다.

이미 부팅한 Raspberry Pi OS에서는 어떻게 SSH를 켤까?

공식 문서는 이미 설치된 시스템에서 세 가지 대표 경로를 제시한다. 데스크톱 환경에서는 Control Centre의 Interfaces 탭에서 SSH를 Enabled로 바꾸면 된다. 터미널만 있다면 sudo raspi-config에서 Interface Options > SSH로 들어가 활성화할 수 있다.

직접 파일을 만지는 수동 방식도 가능하다. 공식 Remote access 문서는 부팅 파티션에 빈 ssh 파일을 만들고 재부팅하면 SSH 서버가 활성화된다고 설명한다. 최근 문서에서는 이 부팅 파티션을 bootfs로 표기한다.

sudo touch /boot/firmware/ssh
sudo reboot

다만 이 수동 방식은 "SSH 활성화"만 해결한다. 첫 부팅 단계에서 사용할 계정이 준비되어 있지 않다면, 공식 Getting started 문서처럼 userconf.txt를 함께 만들어 사용자와 암호 해시를 미리 제공해야 한다.

처음 설치한 장치에서 왜 userconf.txt가 중요할까?

Raspberry Pi 공식 Getting started 문서는 헤드리스 첫 부팅에서 ssh 파일만 두는 것으로는 충분하지 않을 수 있다고 설명한다. 접속할 사용자 계정이 있어야 SSH 로그인 자체가 가능하기 때문이다.

따라서 Raspberry Pi Imager로 사용자 계정을 미리 설정하지 않았다면, 부팅 파티션 루트에 userconf.txt를 만들고 한 줄에 사용자이름:암호해시 형태를 넣어야 한다. 문서 기준 암호 해시는 다른 컴퓨터에서 openssl passwd -6로 생성할 수 있다.

openssl passwd -6

즉 새 장치를 완전히 헤드리스로 올릴 때는 두 가지를 같이 생각하면 된다. SSH 기능을 켜는 ssh 파일, 그리고 실제 로그인 계정을 준비하는 userconf.txt다.

접속 전에는 IP 주소부터 확인해야 한다

SSH가 켜져 있어도 Raspberry Pi의 로컬 IP 주소를 모르면 접속할 수 없다. Raspberry Pi 공식 Remote access 문서는 IP 확인 방법으로 데스크톱의 네트워크 아이콘 확인, 부팅 메시지 확인, 그리고 터미널에서 hostname -I 실행을 안내한다.

hostname -I

같은 로컬 네트워크 안에서 접속한다면 이 주소를 그대로 사용하면 된다. DHCP 환경에서는 주소가 바뀔 수 있으므로, 자주 접속하는 장치라면 공유기 DHCP 예약이나 고정 주소 전략을 따로 고민하는 편이 운영상 편하다.

SSH 접속은 어떤 명령으로 확인할까?

공식 문서가 제시하는 기본 접속 형식은 다음과 같다. 사용자 이름과 Raspberry Pi의 IP 주소를 넣어 접속한다.

ssh <username>@<ip-address>

처음 접속할 때는 상대 호스트 키를 신뢰할 것인지 묻는 경고가 보일 수 있다. 공식 문서는 이 첫 연결에서 yes를 입력해 계속 진행하고, 이후 계정 비밀번호를 입력하면 Raspberry Pi의 셸 프롬프트가 나타난다고 설명한다.

접속이 되면 SSH 서버 활성화와 계정 정보, 네트워크 경로가 모두 정상일 가능성이 높다. 반대로 접속이 실패하면 SSH 기능, 사용자 계정, IP 주소, 같은 네트워크 여부를 순서대로 확인하는 편이 빠르다.

비밀번호 인증과 공개키 인증 중 무엇을 고를까?

Raspberry Pi 공식 문서는 두 방식을 모두 지원한다. 설정을 단순하게 끝내려면 비밀번호 인증이 가장 빠르다. 반면 반복 접속이 많거나 자동화 환경에서 로그인할 계획이라면 공개키 인증이 더 실용적이다.

공개키 인증을 쓸 때는 Raspberry Pi Imager 단계에서 공개키를 넣거나, 이미 설치된 시스템에 나중에 공개키를 복사할 수 있다. 공식 문서는 일반적으로 ssh-copy-id 사용을 설명하며, 필요하면 scp와 authorized_keys 파일을 직접 구성하는 방법도 제시한다.

ssh-copy-id <username>@<ip-address>

키 기반 인증은 비밀번호를 매번 입력하지 않아도 된다는 장점이 있지만, 개인 키 보관과 접근 제어는 접속하는 쪽 장치에서 별도로 책임져야 한다.

접속이 안 될 때는 무엇부터 점검해야 할까?

공식 문서에서 직접 언급하는 대표적인 실패 원인 중 하나는 잘못된 IP 주소다. 따라서 가장 먼저 Raspberry Pi 쪽에서 다시 hostname -I를 확인하는 편이 좋다. 그다음에는 SSH가 실제로 활성화됐는지, 그리고 로그인에 사용할 사용자 계정이 준비됐는지 확인한다.

점검 항목	확인 기준
IP 주소	hostname -I 결과가 현재 접속 시도 주소와 같은지 확인
SSH 활성화	Imager, Control Centre, raspi-config, ssh 파일 방식 중 하나를 실제로 적용했는지 확인
사용자 계정	첫 부팅 전이라면 Imager 또는 userconf.txt로 계정이 준비됐는지 확인
네트워크 위치	같은 로컬 네트워크에 있는지, 중간 라우팅 정책이 없는지 확인
인증 방식	비밀번호 인증인지 공개키 인증인지, 접속 명령과 실제 설정이 일치하는지 확인

FAQ

Q. 새 Raspberry Pi OS를 설치할 때는 어떤 방법이 가장 실수가 적을까?

공식 문서 기준으로는 Raspberry Pi Imager에서 SSH와 사용자 계정, 인증 방식을 함께 미리 설정하는 방법이 가장 단순하다. 헤드리스 설치에서는 특히 이 경로가 편하다.

Q. 부팅 파티션에 ssh 파일만 만들면 바로 로그인할 수 있나?

항상 그렇지는 않다. 첫 부팅에 사용할 사용자 계정이 이미 준비되어 있어야 한다. 공식 Getting started 문서는 필요할 경우 userconf.txt로 사용자와 암호 해시를 함께 준비하라고 설명한다.

Q. 접속 확인은 어떤 명령 하나로 시작하면 될까?

대부분은 Raspberry Pi에서 hostname -I로 IP를 확인한 뒤, 다른 컴퓨터에서 ssh 사용자이름@IP주소를 실행하는 순서면 충분하다.

정리

라즈베리파이 SSH 설정의 핵심은 세 가지다. 첫째, Raspberry Pi OS에서는 SSH 서버가 기본 비활성일 수 있으므로 활성화 경로를 먼저 정해야 한다. 둘째, 헤드리스 첫 부팅이라면 SSH 자체뿐 아니라 로그인할 사용자 계정도 함께 준비해야 한다. 셋째, 접속 검증은 IP 주소 확인과 실제 SSH 로그인 시도로 끝내는 편이 가장 분명하다.

새 설치라면 Raspberry Pi Imager에서 미리 SSH와 인증 방식을 설정하는 방법이 가장 단순하고, 이미 부팅한 장치라면 Control Centre나 raspi-config가 실용적이다. 수동 파일 방식은 유용하지만, userconf.txt 필요 여부까지 함께 봐야 혼란이 줄어든다.

참고 자료

• Raspberry Pi Documentation: Remote access
• Raspberry Pi Documentation: Configuration
• Raspberry Pi Documentation: Getting started