3줄 요약

홈서버에서 여러 서비스를 운영하려면 직접 설치보다 Docker와 Docker Compose 기반 구성이 훨씬 관리하기 편했다.
서비스별로 디렉터리를 나누고, docker-compose.yml, .env, 데이터 볼륨을 한곳에 모아두면 나중에 문제를 찾기 쉽다.
처음부터 많은 서비스를 외부에 공개하기보다, 내부망에서 하나씩 띄우고 데이터가 유지되는지 확인하는 순서가 중요했다.

홈서버에 Docker로 self-hosted 서비스들을 올려보기

이전 글에서는 미니 PC를 준비하고, Ubuntu Server를 설치하고, SSH로 접속할 수 있는 상태까지 정리했다.

거기까지 하면 홈서버는 일단 “서버처럼 접속 가능한 장비”가 된다.
하지만 아직 실제로 쓸 수 있는 서비스가 올라간 것은 아니다.

홈서버를 만든 이유는 단순히 Linux 서버 하나를 켜두기 위해서가 아니라,
내가 필요한 서비스들을 직접 운영하고, 데이터를 내 쪽에 쌓고, 필요하면 자동화까지 붙이기 위해서다.

이번 글에서는 Ubuntu Server 위에 Docker와 Docker Compose를 설치하고
서비스별 폴더 구조를 잡고, 처음으로 self-hosted 서비스들을 하나씩 올려본 과정을 정리해보려고 한다.

왜 Docker로 운영하기로 했나

홈서버에서 서비스를 운영하는 방법은 여러 가지가 있다.

직접 실행 파일을 설치
패키지 매니저로 설치
가상머신으로 나눠서 운영
쿠버네티스 클러스터로 관리

하지만 나는 서비스를 Docker 기반으로 운영하기로 했다.
이유는 단순했다.

서비스가 하나일 때는 직접 설치해도 괜찮다.
하지만 서비스가 두 개, 세 개, 열 개로 늘어나면 어려워진다.

각 서비스마다 필요한 버전이 다를 수 있다.
DB 및 Redis 같은 추가 의존성이 필요할 수 있다.
설정 파일 위치 및 데이터를 저장하는 것도 제각각이다.

-> 이걸 전부 서버에 직접 설치하면 나중에 관리하기가 어려워진다.

그렇다고, 쿠버네티스로 관리하자니 아직 지식과 방향에 대해 정하지 않아서 YAGNI 라고 생각했다.

Docker, Docker Compose를 쓰면 서비스 실행 방법을 하나의 파일로 남길 수 있다.

어떤 서비스를 띄울 때 필요한 정보는 보통 이런 것들이다.

어떤 이미지를 사용할지
어떤 포트를 열지
어떤 환경변수를 사용할지
데이터를 어디에 저장할지
컨테이너가 죽었을 때 다시 실행할지
DB나 Redis 같은 의존 서비스가 있는지

Docker Compose를 사용하면 이런 구성을 docker-compose.yml 파일에 남길 수 있다.

즉, 홈서버를 운영하면서 중요한 것은 단순히 서비스를 실행하는 것이 아니라
“나중에 내가 다시 봐도 이해할 수 있는 형태로 남기는 것”이었다.
(내가 언제든, 다른 미니 PC 로 옮기거나 재사용이 가능하게)

그래서 나는 홈서버의 기본 실행 환경을 이렇게 잡았다.

Ubuntu Server
+ Docker
+ Docker Compose
+ 서비스별 디렉터리
+ docker-compose.yml
+ .env
+ 명시적 volume 경로

적어도 서비스가 어디에 있고, 어떻게 실행되는지는 알 수 있는 구조로 시작했다.

서비스

Docker, Docker-Compose 설치 및 기본적인 사용 방법은 생략한다.

가장 먼저 고민한 것은 폴더 구조였다.
처음에는 아무 위치에서나 docker-compose.yml을 만들고 실행해도 된다.

하지만 서비스가 늘어나면 금방 헷갈린다.

이 서비스 compose 파일이 어디 있는지
데이터는 어디에 저장되는지
.env 파일은 어디에 있는지
로그를 보려면 어느 디렉터리로 가야 하는지

이런 상태가 되면 홈서버 운영이 피곤해진다.

그래서 나는 Docker 관련 파일을 한 곳에 모아두기로 했다.

/home/yeongsu/docker/
├── homepage/
├── uptime-kuma/
├── memos/
├── filebrowser/
├── html-share/
├── immich/
├── ryot/
└── windmill/

기본 원칙은

서비스 하나 = 디렉터리 하나
설정 파일 = 해당 서비스 디렉터리 내부 세팅
데이터 볼륨 = 명시적으로 관리

docker-compose.yml 및 데이터 관리

처음 Docker Compose를 쓸 때는 단순히 컨테이너를 실행하는 설정 파일이라고 생각했다.
하지만 docker-compose.yml은 실행 파일이며 동시에 문서에 가깝다고 느꼈다.

예를 들어 Compose 파일을 보면 이런 것들을 알 수 있다.

이 서비스가 어떤 이미지를 쓰는지
어떤 포트를 사용하는지
어떤 데이터를 어디에 저장하는지
어떤 환경변수가 필요한지
재시작 정책이 있는지
DB나 Redis 같은 의존 컨테이너가 있는지

여기서 중요한 것은 volumes다.

컨테이너는 지웠다가 다시 만들 수 있다. 하지만 데이터는 사라지면 안 된다.
그래서 서비스 데이터는 가능한 한 호스트 디렉터리에 명시적으로 연결해두는 것이 좋다.

volumes:
  - ./data:/data

이렇게 해두면 컨테이너를 재생성해도 ./data 디렉터리에 저장된 데이터는 유지된다.

추가로, 서비스를 운영하다 보면 환경변수가 필요한 경우가 많다.

관리자 계정
DB 접속 정보
외부 API 설정
등등

이런 값들은 .env 파일로 분리했다.

구조는 대략 이런 식이다.

서비스명/
├── docker-compose.yml
├── .env
└── data/

띄운 서비스들

self-hosted 서비스는 찾아보면 정말 많다.

awesome-selfhosted Repo

그 중에서도 내가 올린 서비스들에 대해 간단하게 소개한다.

꽤나 많으니, 제목 보고 흥미로운 것만 선택해서 설치해도 좋을거 같다.

관련 포스트

ON THIS PAGE

관련 포스트

ON THIS PAGE