issueplus7

필요한 정보를 검색을 통해
쉽고 빠르게 찾아보세요.

신청 방법, 문제해결, 궁금한 내용을 검색해 보세요.

2026년 라즈베리 파이(Raspberry Pi) 설치부터 홈서버 구축까지|초보자를 위한 실전 프로젝트 완벽 가이드

RASPBERRY PI OS · LINUX · HOME SERVER

작은 컴퓨터 한 대로 나만의 24시간 홈서버 만들기

라즈베리 파이(Raspberry Pi)는 소형 컴퓨터이지만 리눅스 운영체제를 설치하면 파일 공유 서버, 개인 웹서버, 홈 자동화 시스템, 개발용 테스트 서버 등 다양한 용도로 활용할 수 있습니다. 일반 데스크톱보다 공간을 적게 차지하고 소비전력이 비교적 낮아 가정용 서버를 처음 경험하는 사용자에게 좋은 학습 도구입니다.

이번 글에서는 라즈베리 파이 4·5를 중심으로 준비물 선택, Raspberry Pi OS 설치, Wi-Fi와 SSH 설정, 고정 IP 구성, 시스템 업데이트, Samba 파일 서버, Docker 컨테이너, Nginx 웹서버, 보안 및 백업까지 실제 명령어와 함께 설명합니다.

※ 운영체제 버전과 하드웨어 모델에 따라 메뉴 이름, 장치 이름, 패키지 구성이 달라질 수 있습니다. 아래 예제는 Raspberry Pi OS의 Debian 기반 환경을 전제로 하며, 실제 설치 화면과 공식 문서를 함께 확인하는 것이 좋습니다.

추천 하드웨어

Raspberry Pi 4·5

운영체제

Raspberry Pi OS

서버 구성

SSH·Samba·Docker

활용 프로젝트

NAS·웹서버·자동화

1. 라즈베리 파이 홈서버 개념과 준비물

홈서버는 가정이나 소규모 사무실에서 직접 운영하는 서버입니다. 개인 파일을 저장하거나 웹서비스를 실행하고, 다른 기기에서 네트워크를 통해 접근하도록 구성할 수 있습니다.

① 라즈베리 파이란?

라즈베리 파이는 ARM 기반 프로세서를 사용하는 싱글보드 컴퓨터입니다. 일반 PC처럼 운영체제를 설치할 수 있으며, USB 장치와 네트워크를 연결해 다양한 프로그램을 실행할 수 있습니다.

특히 Raspberry Pi OS는 Debian 계열 리눅스를 기반으로 하므로 리눅스 명령어, 패키지 관리, 네트워크 서비스 운영 등을 학습하기 좋습니다.

② 홈서버로 활용할 수 있는 기능

  • 가족이나 개인을 위한 네트워크 파일 공유
  • 홈페이지와 테스트용 웹 애플리케이션 운영
  • 개인 개발 프로젝트 실행
  • Docker 기반 서비스 관리
  • 스마트홈 기기 자동화
  • 내부 네트워크 모니터링
  • 사진과 문서 백업
  • 간단한 데이터 수집 및 예약 작업

③ Raspberry Pi 4와 Raspberry Pi 5 비교

항목Raspberry Pi 4Raspberry Pi 5
CPU쿼드코어 Cortex-A72쿼드코어 Cortex-A76
네트워크기가비트 이더넷기가비트 이더넷
USBUSB 3.0 지원USB 3.0 지원
저장장치microSD·USB 저장장치microSD·USB·별도 장치 이용 시 NVMe
발열 관리부하에 따라 냉각 권장지속 부하에서 적극적인 냉각 권장
추천 용도기본 NAS·웹서버복수 서비스·상대적으로 높은 부하

기본적인 파일 공유와 웹서버 실습은 Raspberry Pi 4로도 가능하지만, 여러 컨테이너를 동시에 실행하거나 처리량이 많은 작업을 계획한다면 Raspberry Pi 5를 검토할 수 있습니다.

④ 홈서버 구축 준비물

  • Raspberry Pi 4 또는 Raspberry Pi 5 본체
  • 해당 모델에 적합한 공식 또는 권장 규격 전원 공급장치
  • 품질이 좋은 microSD 카드 또는 지원되는 부팅 저장장치
  • 유선 LAN 케이블 또는 Wi-Fi 연결 환경
  • 방열판과 케이스, 필요 시 냉각팬
  • 운영체제 설치용 PC
  • 선택 사항: USB 외장 SSD 또는 HDD

⑤ microSD와 SSD 중 무엇이 좋을까?

처음 설치하고 리눅스를 익히는 용도라면 microSD 카드로 시작해도 됩니다. 그러나 데이터베이스나 로그를 자주 기록하는 서버라면 SSD가 성능과 저장장치 관리 측면에서 유리할 수 있습니다.

단, SSD도 고장날 수 있으므로 중요한 데이터는 별도 백업이 필요합니다. Raspberry Pi 5에서 NVMe를 사용하려면 호환되는 어댑터나 HAT 등의 추가 장치가 필요합니다.

⑥ 전원 공급이 중요한 이유

전원이 불안정하면 갑작스러운 재부팅, USB 저장장치 연결 끊김, 파일시스템 손상 등이 발생할 수 있습니다.

Raspberry Pi 5는 연결된 USB 장치의 전력 소비량까지 고려해야 하므로 적합한 전원 공급장치를 사용해야 합니다. 외장 HDD처럼 전력 소모가 큰 장치는 별도 전원이나 전원 공급형 USB 허브가 필요할 수 있습니다.

⑦ 유선 LAN과 Wi-Fi 선택

홈서버는 장시간 안정적으로 연결되는 것이 중요하므로 가능하면 유선 LAN을 권장합니다. Wi-Fi도 사용할 수 있지만 무선 신호 간섭이나 공유기 환경에 따라 연결이 불안정할 수 있습니다.

⑧ 구축 목표 정하기

처음부터 모든 기능을 설치하기보다는 다음 순서로 목표를 정하면 좋습니다.

운영체제 설치 → SSH 접속 → 네트워크 주소 고정 → 시스템 보안 → 파일 서버 → 웹서버 → Docker 서비스

각 단계에서 정상 작동 여부를 확인한 후 다음 기능을 추가하면 문제 발생 시 원인을 찾기 쉽습니다.

초보자 추천 구성

Raspberry Pi 4 또는 5, 적절한 전원장치, 유선 LAN, Raspberry Pi OS Lite 64비트, 외장 SSD를 조합하면 모니터 없이 SSH로 관리하는 기본 홈서버를 구성할 수 있습니다.

2. Raspberry Pi OS 설치 및 첫 부팅

라즈베리 파이에 운영체제를 설치하는 가장 쉬운 방법은 공식 Raspberry Pi Imager를 사용하는 것입니다. 운영체제 이미지를 저장장치에 기록하고 초기 계정과 네트워크 설정을 미리 구성할 수 있습니다.

① Raspberry Pi Imager 다운로드

공식 사이트에서 사용하는 PC의 운영체제에 맞는 Raspberry Pi Imager를 다운로드합니다.

Raspberry Pi Imager 공식 다운로드 페이지

② 운영체제 종류 선택

Imager에서 Raspberry Pi 모델과 운영체제를 선택합니다.

  • Raspberry Pi OS Desktop: 그래픽 화면이 필요한 사용자
  • Raspberry Pi OS Lite: 모니터 없이 서버로 운영하려는 사용자
  • 64비트 버전: 호환되는 모델에서 일반적으로 권장되는 선택

홈서버만 운영할 계획이라면 그래픽 데스크톱이 없는 Lite 버전이 시스템 자원을 아끼는 데 도움이 됩니다.

③ 저장장치 선택 및 기록

Imager에서 microSD 카드나 대상 저장장치를 선택한 뒤 운영체제 이미지를 기록합니다.

저장장치 선택 주의

운영체제 이미지를 기록하면 대상 저장장치의 기존 데이터가 삭제될 수 있습니다. 중요한 파일을 백업하고 올바른 장치를 선택했는지 반드시 확인하세요.

④ 초기 사용자 계정 설정

Imager의 사용자 지정 설정에서 사용할 사용자 이름과 강력한 비밀번호를 지정합니다.

예전 튜토리얼에서 자주 등장하는 기본 계정 pi가 항상 존재한다고 가정하지 마세요. 최근 설치 방식에서는 사용자가 직접 계정을 구성하는 것이 일반적입니다.

⑤ Wi-Fi 및 지역 설정

무선 네트워크를 사용할 경우 Wi-Fi SSID와 비밀번호를 설정합니다. 국가와 시간대, 키보드 설정도 실제 사용 환경에 맞게 지정합니다.

한국에서 사용할 경우 시간대를 Asia/Seoul로 설정할 수 있습니다.

⑥ SSH 활성화

모니터 없이 라즈베리 파이를 관리하려면 SSH를 활성화하는 것이 편리합니다. Imager의 사용자 지정 설정에서 SSH를 켜고 비밀번호 인증 또는 공개키 인증 방식을 선택할 수 있습니다.

장기 운영을 계획한다면 SSH 공개키 인증을 권장합니다.

⑦ 첫 부팅 진행

이미지를 기록한 저장장치를 라즈베리 파이에 연결하고 LAN 케이블 및 전원을 연결합니다.

첫 부팅에는 초기 설정 작업이 진행되므로 평소 부팅보다 시간이 걸릴 수 있습니다. 부팅 도중 전원을 반복해서 차단하지 마세요.

⑧ 첫 부팅 후 운영체제 확인

터미널에 접속했다면 다음 명령으로 운영체제와 커널을 확인합니다.

cat /etc/os-release

uname -a

hostnamectl

운영체제 이름과 버전, 커널, 장치 이름 등이 출력되면 기본적인 시스템 상태를 확인할 수 있습니다.

⑨ 시스템 패키지 업데이트

설치 후에는 패키지 목록을 갱신하고 보안 업데이트를 적용합니다.

sudo apt update

sudo apt upgrade

필요에 따라 재부팅합니다.

sudo reboot

운영체제 업그레이드나 펌웨어 변경은 일반 패키지 업데이트와 다르므로 공식 안내를 확인한 뒤 진행하세요.

설치 완료 확인 기준

라즈베리 파이가 정상 부팅되고, 네트워크에 연결되며, 사용자 계정으로 로그인할 수 있고, apt update가 정상 실행되면 기본 설치가 완료된 것입니다.

3. SSH 원격 접속과 네트워크 기본 설정

홈서버는 모니터와 키보드를 항상 연결해 두지 않아도 됩니다. SSH를 설정하면 다른 PC에서 터미널로 접속해 파일 관리, 업데이트, 서버 프로그램 설치 등을 수행할 수 있습니다.

① 라즈베리 파이 IP 주소 확인

라즈베리 파이 터미널에서 다음 명령을 실행합니다.

hostname -I

출력 예시는 다음과 같습니다.

192.168.0.120

위 주소는 예시입니다. 실제 IP는 공유기와 네트워크 환경에 따라 달라집니다.

② Windows에서 SSH 접속하기

Windows PowerShell을 열고 다음 명령을 입력합니다.

ssh 사용자이름@192.168.0.120

처음 접속할 때 서버 호스트 키를 신뢰할지 묻는 메시지가 나타날 수 있습니다. 실제 접속 대상이 맞는지 확인한 후 승인합니다.

③ macOS·Linux에서 SSH 접속하기

터미널에서 같은 방식으로 접속합니다.

ssh 사용자이름@192.168.0.120

사용자 이름은 Raspberry Pi Imager에서 설정한 계정으로 바꿔야 합니다.

④ 호스트 이름으로 접속하기

로컬 네트워크에서 mDNS 이름 확인이 지원된다면 다음과 같이 접속할 수 있습니다.

ssh 사용자이름@raspberrypi.local

장치의 호스트 이름을 변경했다면 해당 이름을 사용해야 합니다. 일부 네트워크나 운영체제에서는 .local 이름 확인이 정상 작동하지 않을 수 있으므로 IP 주소 접속도 알아두는 것이 좋습니다.

⑤ SSH 서비스 상태 확인

sudo systemctl status ssh

서비스가 비활성화되어 있고 SSH 접속을 사용하려는 경우 다음 명령으로 활성화할 수 있습니다.

sudo systemctl enable --now ssh

SSH 서버 패키지가 설치되어 있어야 합니다. 원격 접속을 외부 인터넷에 직접 노출하는 것은 권장하지 않습니다.

⑥ 공유기에서 IP 주소 예약하기

홈서버는 주소가 자주 바뀌지 않아야 접속하기 편리합니다. 가장 간단한 방법 중 하나는 공유기의 DHCP 예약 기능을 이용하는 것입니다.

공유기 관리자 화면 → DHCP 또는 LAN 설정 → 주소 예약 → 라즈베리 파이 MAC 주소 선택 → 고정할 내부 IP 지정

공유기마다 메뉴 이름이 다르며, 예약할 주소는 공유기의 LAN 대역과 충돌하지 않아야 합니다.

⑦ NetworkManager 환경 확인

일부 Raspberry Pi OS 환경에서는 NetworkManager를 사용해 네트워크를 관리합니다.

nmcli device status

nmcli connection show

고정 IP를 직접 설정할 때는 현재 사용 중인 네트워크 관리 방식을 확인해야 합니다. 예전 자료의 dhcpcd.conf 설정을 모든 최신 Raspberry Pi OS 환경에 그대로 적용하지 마세요.

⑧ 시간대 및 시스템 시간 확인

timedatectl

시간대를 한국으로 변경하려면 다음 명령을 사용할 수 있습니다.

sudo timedatectl set-timezone Asia/Seoul

서버 시간이 정확해야 로그 분석과 예약 작업이 정상적으로 수행됩니다.

⑨ SSH 연결이 끊어질 때 확인할 사항

  • 라즈베리 파이에 전원이 정상 공급되는지 확인
  • 유선 LAN 또는 Wi-Fi 연결 상태 확인
  • 현재 IP 주소가 변경되었는지 확인
  • SSH 서비스가 실행 중인지 확인
  • 방화벽에서 SSH 포트가 허용되는지 확인
  • 접속하는 PC와 서버가 서로 통신 가능한 네트워크인지 확인
SSH 설정 변경 전 주의

원격으로 접속한 상태에서 SSH 포트, 방화벽, 네트워크 주소를 잘못 변경하면 서버에 다시 접속하지 못할 수 있습니다. 중요한 설정을 바꾸기 전에는 로컬 콘솔 접속 방법이나 복구 수단을 준비하세요.

4. 홈서버 필수 보안 및 시스템 관리

홈서버는 장시간 켜 두는 경우가 많으므로 보안과 안정성을 먼저 확보해야 합니다. 특히 SSH 원격 접속과 파일 공유 기능을 사용한다면 계정 관리, 업데이트, 접근 제한이 중요합니다.

① 관리자 계정과 비밀번호 관리

설치 과정에서 만든 계정에 강력한 비밀번호를 사용하고, 다른 서비스와 같은 비밀번호를 재사용하지 않는 것이 좋습니다.

passwd

현재 로그인한 계정의 비밀번호를 변경하는 명령입니다.

② SSH 공개키 인증 설정

SSH 공개키 인증을 사용하면 서버에 비밀번호를 직접 입력하지 않고 인증할 수 있습니다. 접속할 PC에서 키를 생성합니다.

ssh-keygen -t ed25519

생성한 공개키를 서버의 해당 사용자 계정에 등록합니다. macOS나 Linux에서 ssh-copy-id를 사용할 수 있는 환경이라면 다음 명령을 활용할 수 있습니다.

ssh-copy-id 사용자이름@192.168.0.120

공개키 로그인에 성공한 것을 확인한 후에만 비밀번호 인증 비활성화를 검토하세요. 기존 SSH 세션은 설정 변경 검증이 끝날 때까지 유지하는 것이 안전합니다.

③ 방화벽 설정

UFW를 사용하려면 먼저 설치 여부를 확인합니다.

sudo apt install ufw

sudo ufw status verbose

SSH로 접속 중이라면 방화벽을 활성화하기 전에 SSH를 허용해야 합니다.

sudo ufw allow OpenSSH

sudo ufw enable

방화벽 활성화 후에는 기존 SSH 연결을 끊기 전에 새 연결이 가능한지 확인하세요. 이후 Samba나 웹서버를 사용할 경우 필요한 포트만 신뢰할 수 있는 네트워크에 허용합니다.

④ 시스템 업데이트 습관 만들기

sudo apt update

apt list --upgradable

sudo apt upgrade

업데이트 전에는 변경되는 패키지를 확인하고, 중요한 서비스가 실행 중이라면 백업과 점검 시간을 확보하는 것이 좋습니다.

⑤ CPU 온도 확인

라즈베리 파이에서는 다음 명령으로 온도를 확인할 수 있습니다.

vcgencmd measure_temp

명령이 제공되지 않는 환경에서는 시스템의 온도 센서 정보를 확인하는 방법도 있습니다.

cat /sys/class/thermal/thermal_zone0/temp

두 번째 명령의 출력은 일반적으로 밀리도 단위이므로 예를 들어 45000은 약 45°C를 의미합니다. 실제 센서 경로와 값은 환경에 따라 달라질 수 있습니다.

⑥ 메모리와 디스크 상태 확인

free -h

df -h

lsblk -f

메모리가 부족하거나 저장장치 공간이 가득 차면 서버 서비스가 불안정해질 수 있습니다. 특히 로그 파일과 컨테이너 이미지가 저장 공간을 많이 사용할 수 있습니다.

⑦ 자동 재부팅보다 장애 원인 확인

서버가 느려지거나 멈춘다고 무조건 재부팅하기보다는 먼저 CPU, 메모리, 저장장치, 시스템 로그를 확인하는 것이 좋습니다.

uptime

systemctl --failed

journalctl -p err -b --no-pager

로그에는 개인정보나 서비스 관련 정보가 포함될 수 있으므로 외부에 공유할 때는 민감한 내용을 제거하세요.

⑧ 외부 접속은 VPN 방식 우선 검토

집 밖에서 홈서버에 접속하고 싶다면 공유기에서 SSH나 Samba 포트를 인터넷에 직접 개방하기보다 신뢰할 수 있는 VPN 솔루션을 먼저 검토하는 것이 좋습니다.

VPN도 계정 보호, 기기 인증, 업데이트, 접근 권한 관리가 필요합니다. 인터넷에 서비스를 공개해야 한다면 HTTPS, 인증, 방화벽, 로그 관리 등을 추가로 설계해야 합니다.

홈서버 보안의 핵심

SSH 22번 포트나 Samba 445번 포트를 무분별하게 인터넷에 공개하지 마세요. 내부 네트워크에서 먼저 안전하게 운영하고, 외부 접속이 필요할 때는 VPN이나 별도로 보호된 접속 방식을 구성하는 것이 좋습니다.

5. Samba로 개인 파일 공유 서버 구축

라즈베리 파이를 홈서버로 활용하는 가장 실용적인 프로젝트 중 하나는 네트워크 파일 공유입니다. Samba를 설치하면 Windows, macOS, Linux 등에서 SMB 프로토콜을 통해 공유 폴더에 접근할 수 있습니다.

① Samba 패키지 설치

sudo apt update

sudo apt install samba

설치 후 서비스 상태를 확인합니다.

sudo systemctl status smbd

② 공유 폴더 생성

현재 사용자 홈 디렉터리에 공유 폴더를 만듭니다.

mkdir -p "$HOME/shared"

chmod 700 "$HOME/shared"

이 예제는 해당 사용자 계정 중심의 개인 공유 폴더입니다. 여러 사용자에게 쓰기 권한을 제공하려면 별도의 그룹과 파일 권한 정책을 설계해야 합니다.

③ Samba 설정 파일 백업

설정을 변경하기 전에 원본을 백업합니다.

sudo cp /etc/samba/smb.conf \
/etc/samba/smb.conf.backup

④ 공유 폴더 설정 추가

설정 파일을 편집합니다.

sudo nano /etc/samba/smb.conf

파일 마지막에 다음 설정을 추가합니다. 사용자이름과 경로는 실제 계정에 맞게 변경합니다.

[HomeShare]
 path = /home/사용자이름/shared
 browseable = yes
 read only = no
 guest ok = no
 valid users = 사용자이름
 create mask = 0600
 directory mask = 0700

이 구성은 지정된 사용자만 인증을 거쳐 접근하도록 제한합니다. 실제 파일시스템 권한도 해당 계정에 맞게 설정되어 있어야 합니다.

⑤ Samba 사용자 비밀번호 설정

Samba에서 사용할 사용자를 등록합니다.

sudo smbpasswd -a 사용자이름

여기서 입력하는 비밀번호는 SMB 접속에 사용됩니다. 운영체제 계정의 비밀번호와 별도로 관리할 수 있습니다.

⑥ Samba 설정 검사 및 재시작

testparm

설정에 문제가 없는지 확인한 후 서비스를 다시 시작합니다.

sudo systemctl restart smbd

⑦ Windows에서 공유 폴더 접속

Windows 파일 탐색기 주소창에 다음과 같이 입력합니다.

\\192.168.0.120\HomeShare

실제 라즈베리 파이 IP로 변경하고, Samba 사용자 이름과 비밀번호를 입력합니다.

⑧ macOS에서 공유 폴더 접속

Finder에서 서버에 연결 기능을 열고 다음 주소를 입력합니다.

smb://192.168.0.120/HomeShare

사용자 인증 후 공유 폴더에 접근할 수 있습니다.

⑨ 외장 SSD를 저장 공간으로 활용하기

저장 용량이 부족하다면 외장 SSD를 연결할 수 있습니다. 먼저 장치를 확인합니다.

lsblk -f

외장 디스크를 마운트한 뒤 Samba의 path를 해당 경로로 변경할 수 있습니다. 단, 디스크 포맷과 파티션 작업은 데이터를 삭제할 수 있으므로 장치 이름을 정확히 확인하고 백업한 뒤 진행해야 합니다.

파일 서버 구축 완료 기준

다른 PC에서 공유 폴더에 로그인할 수 있고, 테스트 파일을 업로드·다운로드할 수 있으며, 권한 없는 계정에서는 접근할 수 없다면 기본적인 Samba 홈서버 구성이 완료된 것입니다.

6. Docker·Nginx 활용 실전 홈서버 프로젝트

파일 공유 서버를 완성했다면 Docker와 Nginx를 활용해 웹서비스를 운영할 수 있습니다. Docker는 애플리케이션을 컨테이너 단위로 실행하는 기술이며, Nginx는 웹페이지 제공이나 리버스 프록시 등에 활용되는 웹서버입니다.

① Docker를 사용하는 이유

Docker를 사용하면 프로그램과 실행에 필요한 환경을 컨테이너 단위로 관리할 수 있습니다. 여러 서비스를 분리해 설치하고 시작·중지·재배포하기 편리합니다.

단, Docker를 사용한다고 보안이나 백업 문제가 자동으로 해결되는 것은 아닙니다.

② Docker 설치 방법 선택

간단한 실습에서는 운영체제 패키지 저장소에서 Docker 관련 패키지를 설치할 수 있습니다.

sudo apt update

sudo apt install docker.io

설치 가능한 패키지와 버전은 Raspberry Pi OS 릴리스에 따라 다를 수 있습니다. 최신 Docker Engine이나 Compose 플러그인이 필요하다면 Docker 공식 Debian 설치 안내를 확인하세요.

③ Docker 서비스 상태 확인

sudo systemctl enable --now docker

sudo systemctl status docker

sudo docker version

Docker 데몬이 정상 실행되면 클라이언트와 서버 버전 정보를 확인할 수 있습니다.

④ 테스트 컨테이너 실행

sudo docker run --rm hello-world

이미지를 내려받아 테스트 컨테이너를 실행합니다. 정상 메시지가 표시되면 기본적인 Docker 실행 환경이 준비된 것입니다.

⑤ Nginx 웹서버 설치

먼저 Docker와 별개로 Nginx를 직접 설치하는 방법을 살펴보겠습니다.

sudo apt install nginx

sudo systemctl enable --now nginx

다른 PC의 웹브라우저에서 다음 주소로 접속합니다.

http://192.168.0.120

기본 Nginx 페이지가 표시되면 웹서버가 정상 실행된 것입니다.

⑥ 나만의 홈페이지 만들기

간단한 HTML 파일을 만들어 Nginx의 기본 웹 디렉터리에 배치할 수 있습니다.

sudo nano /var/www/html/index.html

예를 들어 다음과 같은 내용을 작성합니다.

<!DOCTYPE html>
<html lang="ko">
<head>
 <meta charset="UTF-8">
 <title>My Raspberry Pi Server</title>
</head>
<body>
 <h1>나의 라즈베리 파이 홈서버</h1>
 <p>Nginx 웹서버 실행 성공!</p>
</body>
</html>

저장 후 웹브라우저에서 새로고침하면 작성한 페이지를 확인할 수 있습니다.

⑦ Docker로 별도 웹서버 실행

기존 Nginx가 80번 포트를 사용하고 있으므로 Docker 컨테이너는 호스트의 8080번 포트를 사용하도록 설정합니다.

sudo docker run -d \
 --name home-nginx \
 --restart unless-stopped \
 -p 127.0.0.1:8080:80 \
 nginx:stable

위 명령은 컨테이너 웹서버를 라즈베리 파이의 로컬 루프백 주소에만 바인딩합니다. 따라서 다른 PC에서 직접 8080번 포트로 접속할 수 없으며, 서버 내부에서 다음 명령으로 테스트합니다.

curl http://127.0.0.1:8080

내부 네트워크의 다른 PC에서도 접속하도록 구성하려면 포트 바인딩과 방화벽을 별도로 설계해야 합니다. 인터넷 공개를 전제로 한 포트 개방은 신중하게 결정하세요.

⑧ 컨테이너 관리 명령어

# 실행 중인 컨테이너 확인
sudo docker ps

# 모든 컨테이너 확인
sudo docker ps -a

# 컨테이너 로그 확인
sudo docker logs home-nginx

# 컨테이너 중지
sudo docker stop home-nginx

# 컨테이너 시작
sudo docker start home-nginx

불필요한 컨테이너와 이미지는 저장 공간을 차지하므로 주기적으로 확인합니다. 다만 데이터 볼륨을 포함한 삭제 명령은 중요한 데이터를 제거할 수 있으므로 주의해야 합니다.

⑨ 홈서버 프로젝트 확장 아이디어

  • 개인 클라우드: 파일 동기화와 웹 접근 기능 구축
  • 스마트홈: Home Assistant 등 자동화 플랫폼 운영
  • 개발 서버: Python Flask 또는 FastAPI 프로젝트 실행
  • 모니터링: CPU·메모리·저장장치 상태 시각화
  • 사진 관리: 개인 사진 라이브러리 구성
  • 정기 백업: 외장 저장장치로 데이터 복사 자동화

확장 프로젝트를 선택할 때는 ARM 아키텍처 지원 여부, 메모리 요구량, 저장장치 용량, 컨테이너 이미지의 신뢰성을 확인하세요.

⑩ 정기 백업 자동화 기초

개인 파일 서버에서는 외장 저장장치나 다른 컴퓨터로 데이터를 백업하는 절차가 필요합니다. rsync를 사용하면 파일 복사 작업을 수행할 수 있습니다.

sudo apt install rsync

rsync -avh \
 "$HOME/shared/" \
 "$HOME/backup-test/"

위 코드는 동일한 홈 디렉터리 안에 테스트 백업을 만드는 예시입니다. 실제 재해 복구를 위해서는 별도 물리 저장장치나 다른 시스템에 백업해야 합니다.

백업 자동화 전에 파일 권한, 여유 공간, 복구 절차를 확인하고 실제 복원 테스트를 수행하세요.

Docker 권한과 인터넷 공개 주의

사용자를 docker 그룹에 추가하면 Docker 데몬을 통해 사실상 높은 시스템 권한을 행사할 수 있으므로 보안상 주의가 필요합니다. 또한 Docker가 공개하는 포트는 방화벽 정책과 상호작용할 수 있으므로 외부 공개 전 바인딩 주소, 라우터 설정, 접근 제어를 반드시 점검하세요.

7. 라즈베리 파이 홈서버 자주 묻는 질문 8가지

Q1. 라즈베리 파이를 24시간 켜 두어도 되나요?

가능합니다. 다만 적절한 전원 공급, 냉각, 저장장치 관리가 필요합니다. 장시간 운영 시 온도와 시스템 로그를 확인하고 정전이나 전원 차단에 대비한 백업 정책을 마련하는 것이 좋습니다.

Q2. Raspberry Pi 4와 5 중 어떤 모델이 홈서버에 좋나요?

기본 파일 공유와 가벼운 웹서버는 Raspberry Pi 4로도 가능합니다. 여러 컨테이너를 동시에 실행하거나 더 높은 처리 성능이 필요하다면 Raspberry Pi 5를 고려할 수 있습니다. 메모리 용량과 저장장치 구성도 중요합니다.

Q3. 모니터 없이 라즈베리 파이를 설치할 수 있나요?

가능합니다. Raspberry Pi Imager에서 사용자 계정, 네트워크, SSH를 미리 설정하면 모니터 없이 부팅한 뒤 다른 PC에서 원격 접속할 수 있습니다.

Q4. 라즈베리 파이로 NAS를 만들 수 있나요?

가능합니다. 외장 SSD나 HDD를 연결하고 Samba를 설치하면 내부 네트워크에서 파일을 공유하는 NAS 형태로 사용할 수 있습니다. 다만 전용 NAS와 비교하면 저장장치 관리, 이중화, 장애 복구 기능을 직접 설계해야 합니다.

Q5. 외부 인터넷에서 홈서버에 접속할 수 있나요?

가능하지만 보안 설정이 필요합니다. SSH나 SMB 포트를 인터넷에 직접 개방하기보다는 VPN 등 보호된 원격 접속 방식을 우선 검토하세요. 공유기와 인터넷 서비스 환경에 따라 추가 설정이 필요할 수 있습니다.

Q6. 라즈베리 파이에 Docker를 설치할 수 있나요?

지원되는 Raspberry Pi OS 환경에서 Docker를 사용할 수 있습니다. 다만 실행하려는 컨테이너 이미지가 ARM 아키텍처를 지원하는지 확인해야 하며, 서비스에 따라 필요한 메모리와 저장장치 용량이 다릅니다.

Q7. microSD 카드만으로 홈서버를 운영해도 되나요?

가벼운 실습과 소규모 서비스는 가능하지만 쓰기 작업이 많은 환경에서는 저장장치 수명과 성능을 고려해야 합니다. 중요한 데이터를 장기간 저장하려면 SSD 사용과 별도 백업을 검토하는 것이 좋습니다.

Q8. 홈서버 운영에 고정 공인 IP가 필요한가요?

집 안의 네트워크에서만 사용할 경우 고정 공인 IP는 필요하지 않습니다. 공유기의 DHCP 예약을 통해 내부 IP를 일정하게 유지할 수 있습니다. 외부 접속은 VPN이나 다른 접속 방식에 따라 요구사항이 달라집니다.

8. 최종 정리 및 라즈베리 파이 홈서버 구축 체크리스트

라즈베리 파이는 소형 컴퓨터이지만 리눅스와 네트워크 서비스를 익히고 개인용 홈서버를 구축하기에 충분히 유용한 플랫폼입니다. 중요한 것은 기능을 많이 설치하는 것보다 안정적으로 운영할 수 있는 구조를 만드는 것입니다.

단계 구축 작업 완료 기준
1하드웨어 준비전원·저장장치·냉각 확인
2Raspberry Pi OS 설치첫 부팅 성공
3SSH 접속 설정원격 로그인 성공
4네트워크 주소 관리내부 IP 예약
5보안 및 업데이트계정·방화벽 점검
6Samba 파일 공유PC에서 파일 접근 성공
7Nginx·Docker 설치웹서비스 실행 성공
8백업 및 운영 점검복원 테스트·상태 확인

☑️ 라즈베리 파이 홈서버 최종 체크리스트 18가지

  • 사용 목적에 맞는 라즈베리 파이 모델을 선택했는가?
  • 모델에 적합한 전원 공급장치를 준비했는가?
  • 저장장치와 냉각 환경을 점검했는가?
  • Raspberry Pi OS를 정상 설치했는가?
  • 사용자 계정과 강력한 비밀번호를 설정했는가?
  • 유선 LAN 또는 Wi-Fi 연결을 확인했는가?
  • SSH 원격 접속에 성공했는가?
  • 공유기에서 내부 IP 예약을 설정했는가?
  • 운영체제와 패키지를 업데이트했는가?
  • 시스템 시간대를 올바르게 설정했는가?
  • SSH 공개키 인증을 검토했는가?
  • 방화벽과 접근 권한을 확인했는가?
  • CPU 온도와 메모리 상태를 점검했는가?
  • Samba 파일 공유를 정상 구성했는가?
  • 다른 PC에서 공유 폴더에 접근할 수 있는가?
  • Nginx 웹서버를 실행했는가?
  • Docker 컨테이너를 테스트했는가?
  • 중요 데이터의 별도 백업과 복구 방법을 준비했는가?

정리하면 하드웨어 준비 → Raspberry Pi OS 설치 → SSH 원격 관리 → 네트워크·보안 설정 → Samba 파일 공유 → Docker·Nginx 서비스 구축 → 백업 및 유지보수 순서로 진행하면 초보자도 단계적으로 홈서버를 구축할 수 있습니다.

홈서버 운영 전 반드시 확인할 사항

홈서버를 24시간 운영할 때는 안정적인 전원, 적절한 냉각, 저장장치 상태, 보안 업데이트, 정기 백업이 중요합니다. 외부 인터넷에 SSH·Samba·관리자 페이지를 무분별하게 공개하지 마세요. 특히 저장장치 포맷, 파일 권한 변경, 방화벽 설정, Docker 볼륨 삭제와 같은 작업은 데이터 손실이나 접속 장애를 유발할 수 있으므로 변경 전에 백업과 복구 방법을 확인해야 합니다.

공식 문서 및 참고 자료

※ 작성 기준: 2026년 10월. 본 글은 Raspberry Pi OS를 활용한 가정용 리눅스 서버 구축 실습 가이드입니다. Raspberry Pi 모델, 운영체제 릴리스, 네트워크 환경, 저장장치 구성에 따라 설치 명령과 설정 방식이 달라질 수 있습니다. 실제 운영 환경에 적용하기 전 공식 문서와 백업 상태를 확인하시기 바랍니다.

이 글 공유하기

댓글