Self-Hosting-Guide 딥다이브
— "내 데이터를 내 서버에" 셀프호스팅 생태계 전체 지도

1프로젝트 한줄 요약

이 레포가 무엇을 하는 물건인가.

이 저장소의 주 언어가 Dockerfile로 잡히는 이유도 여기 있다. 실제 애플리케이션 코드는 거의 없지만, 레포에 포함된 Getting Started with Self-Hosting.dockerfile 예시 파일 하나 때문에 GitHub이 주 언어를 Dockerfile로 분류한 것이다(README 안의 코드블록은 언어 감지 대상이 아니다). 즉 "코드를 읽는 레포"가 아니라 "지도를 따라 직접 서버를 구축하는 레포"다.

2왜 주목받는가

왜 ★2만 개를 넘기고 지금도 트렌딩에 오르는가.

셀프호스팅은 최근 몇 년간 꾸준히 커지는 흐름이다. 구독료 인상, 클라우드 서비스의 갑작스러운 정책 변경·서비스 종료, 프라이버시 우려, 그리고 라즈베리파이·미니PC·중고 서버의 가격 하락이 맞물리면서 "내 데이터는 내가 들고 있겠다"는 사람이 늘었다. 이 가이드가 트렌딩에 오르는 이유는 다음과 같다.

3기술 스택 전체 지도

이 가이드가 다루는 기술을 "셀프호스팅 스택" 층위로 재배열했다.

README는 주제를 나열식으로 늘어놓지만, 실무에서는 아래에서 위로 쌓는 계층으로 이해하는 게 빠르다. 하드웨어 위에 OS, 그 위에 컨테이너 런타임, 네트워킹·보안으로 감싸고, 맨 위에 실제 앱을 올린다.

핵심 도구 4종 빠르게 짚기

4아키텍처 심화 — 셀프호스팅 스택의 해부

가이드의 도구들이 실제로 어떻게 한 시스템으로 엮이는가.

이 레포에는 "아키텍처"라는 코드가 없으므로, 가이드가 설명하는 개념을 현실적인 1대 서버 셀프호스팅 구성으로 조립해 보면 다음과 같다. 외부에서 들어온 요청이 어떤 길을 거쳐 컨테이너 안의 앱에 닿는지가 핵심이다.

핵심 설계 패턴 3가지

5문서 구조 해부 (디렉토리 대신 목차)

파일이 아니라 README의 목차가 곧 이 레포의 "구조"다.

이 저장소는 사실상 README.md(약 59만 자) 하나가 본문 전부이고, 그 외엔 짧은 Getting Started with Self-Hosting.dockerfile 예시와 CONTRIBUTING.md가 전부다. 따라서 "디렉토리 구조" 대신 목차를 학습 묶음으로 그룹핑해 두면 길을 잃지 않는다.

각 묶음은 거의 동일한 내부 패턴을 따른다 — ① 개념 정의 → ② Learning Resources(공식 문서·강의·자격증) → ③ Tools(도구·프레임워크 목록). 이 패턴을 알면 처음 보는 섹션도 빠르게 스캔할 수 있다.

6학습 포인트 (기술별)

이 가이드를 거치며 실제로 손에 남기면 좋은 것들.

Docker / 컨테이너 — 모든 것의 기초

셀프호스팅의 90%는 컨테이너로 한다. docker compose 파일 하나를 읽고 쓸 줄 알면 대부분의 앱을 올릴 수 있다. 아래는 셀프호스팅에서 가장 자주 보는 형태다.

# docker-compose.yml — Nextcloud + DB 최소 구성
services:
  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: change-me
    volumes:
      - ./db:/var/lib/postgresql/data   # 데이터는 볼륨에 영속
  app:
    image: nextcloud:latest
    ports:
      - "8080:80"                       # 호스트 8080 → 컨테이너 80
    depends_on: [db]
    volumes:
      - ./data:/var/www/html            # 파일/설정 보존

여기서 배울 핵심: volume(데이터 영속), ports(포트 매핑), depends_on(기동 순서), environment(비밀·설정 주입). 이 네 가지만 이해하면 README의 거의 모든 Docker 예시가 읽힌다.

네트워킹 — 가장 안 보이지만 가장 자주 막히는 곳

포트, DNS, 리버스 프록시, HTTPS 인증서, NAT/포트포워딩 — 셀프호스팅 트러블슈팅의 대부분이 네트워킹이다. 가이드의 "Networking" 섹션으로 OSI 계층·프로토콜 감을 잡고, 실제로는 리버스 프록시(Caddy가 입문 난이도 최저) 한 개를 세워 보는 게 가장 빠른 학습이다.

보안 — 옵션이 아니라 전제

내 서버를 인터넷에 두는 순간 공격 대상이 된다. 최소 권한, 정기 업데이트, 백업, 2FA, VPN 우선이 기본기다. 가이드의 OpenSSF·차등 프라이버시 섹션은 "조직 수준"까지 다루지만, 개인은 위 5개만 지켜도 안전도가 급상승한다.

7하드웨어 / 시스템 요구사항

"셀프호스팅 하려면 뭘 사야 하나"에 대한 현실적 답.

가이드는 라즈베리파이를 비중 있게 다룬다. 입문용으로 충분하지만, 무엇을 돌리느냐에 따라 권장 사양이 다르다.

8직접 해볼 수 있는 실습 과제

가이드를 "읽기"에서 "하기"로 바꾸는 난이도별 과제.

9관련 기술 심화 학습 로드맵

이 가이드를 4주 코스로 압축한다면.

10핵심 키워드 사전

가이드를 읽다 막히는 용어 빠른 참조.

11참고 링크

• GitHub: mikeroyal/Self-Hosting-Guide (README가 곧 본문)
• 설치 가능한 앱 카탈로그: awesome-selfhosted (이 가이드와 보완 관계)
• 컨테이너: Docker 공식 문서 · Compose
• VPN: WireGuard
• 대표 앱: Nextcloud · Immich(사진)
• 리버스 프록시(입문 추천): Caddy
• 커뮤니티: r/selfhosted