시놀로지 NAS에 Komga 도서관 서버를 Docker로 구축하는 완벽 가이드
혹시 여러분도 저처럼 소장하고 있는 수많은 디지털 만화나 소설 파일들을 깔끔하게 정리하고 싶지 않으셨나요? 스마트폰이나 태블릿으로 어디서든 편하게 보고 싶지만, 매번 파일을 옮기는 것도 번거롭고 정리도 잘 안 돼서 답답하셨을 거예요. 제가 딱 그런 상황이었거든요. 😎
이런 고민을 한 번에 해결해 줄 수 있는 멋진 솔루션이 바로 'Komga'입니다. Komga는 개인용 미디어 서버인데, 특히 만화나 소설 같은 디지털 콘텐츠를 도서관처럼 관리하고 웹 브라우저나 전용 앱으로 스트리밍해서 볼 수 있게 해주는 아주 유용한 도구예요. 오늘은 그 Komga를 여러분의 시놀로지 NAS에 Docker로 설치하는 방법을 A부터 Z까지 아주 쉽게 알려드릴게요. 저만 따라오시면 여러분도 멋진 개인 도서관을 갖게 될 거예요! 😊
Komga, 대체 무엇인가요? 🤔
Komga는 만화(Comic)와 소설(Novel)을 위한 오픈소스 개인 미디어 서버예요. 쉽게 말해, 여러분의 NAS에 저장된 CBR, CBZ, PDF 같은 디지털 만화 파일을 자동으로 스캔하고, 표지 이미지를 가져와서 도서관처럼 예쁘게 정리해 주는 프로그램이죠. 웹 브라우저나 전용 앱(예: Panels, Komga-iOS 등)을 통해 언제 어디서든 스트리밍해서 볼 수 있는 강력한 기능을 제공합니다.
보통 만화 파일은 여러 권이 하나의 폴더에 뭉쳐 있거나 파일명만으로 내용을 알기 어려울 때가 많은데요. Komga는 이런 파일들을 자동으로 인식해서 시리즈별로 묶어주고, 읽은 페이지를 기억하는 등 독서에 최적화된 환경을 만들어줍니다. 특히, Komga는 자체적인 뷰어 기능도 뛰어나서 별도의 프로그램 없이도 편리하게 이용할 수 있어요.
Komga는 무료 오픈소스 프로그램이에요. 따라서 서버 구축에 필요한 비용은 여러분이 이미 가지고 있는 NAS와 하드웨어뿐입니다. 그리고 다양한 플랫폼(Windows, macOS, Linux)을 지원하지만, NAS 사용자에게는 Docker를 이용하는 것이 가장 효율적이고 안정적인 방법입니다.
Komga 설치 전 필수 준비물 📝
Komga를 설치하기 전에 몇 가지 준비해야 할 것들이 있어요. 준비가 되어있어야 설치 과정이 훨씬 매끄럽고 빠르답니다. 아래 목록을 보면서 하나씩 체크해 보세요!
- 시놀로지 NAS: Docker를 지원하는 모델이어야 합니다. 대부분의 최신 시놀로지 NAS는 Docker를 지원해요.
- Docker 패키지: 시놀로지 NAS의 패키지 센터에서 Docker를 설치해야 합니다.
- 공유 폴더: Komga가 만화 파일을 스캔하고 데이터를 저장할 전용 공유 폴더를 미리 만들어두는 것이 좋아요. 저는 'docker/komga' 폴더를 추천해요.
- 포트 포워딩: 외부에서 접속하고 싶다면 NAS의 관리자 페이지에서 포트 포워딩 설정을 해야 합니다. Komga의 기본 포트는 25600번입니다.
이렇게 필요한 것들을 미리 준비해두면, 나중에 헤매지 않고 한 번에 설치를 끝낼 수 있어요. 특히, NAS의 ‘Docker’ 패키지가 꼭 설치되어 있어야 한다는 점을 잊지 마세요!
필요한 폴더 구조 생성
Komga의 데이터와 만화 파일을 저장할 폴더를 미리 생성해야 합니다. File Station에서 아래와 같은 구조로 폴더를 만들어주세요.
| 폴더명 | 용도 |
|---|---|
| `docker` | Docker 컨테이너 관련 파일들을 모아두는 상위 폴더입니다. |
| `komga` | Komga의 설정 및 데이터베이스 파일이 저장될 폴더입니다. |
| `comics` | 실제 만화 파일(.cbz, .cbr 등)을 저장할 폴더입니다. |
폴더 이름은 자유롭게 정해도 되지만, 관리의 편의를 위해 위와 같이 구조를 잡아두는 것을 추천합니다. 특히 Komga 데이터 폴더와 만화 파일 폴더는 권한 설정이 중요하니, 해당 폴더의 권한을 NAS의 Docker 사용자에게 읽기/쓰기 권한을 부여해야 합니다.
Komga는 NAS의 'guest'나 'everyone' 권한으로 동작하지 않습니다. Docker를 실행하는 사용자가 해당 폴더에 접근할 수 있도록 ‘제어판 > 공유 폴더 > 폴더 선택 > 편집 > 권한’에서 적절한 권한을 부여했는지 반드시 확인해주세요. 권한 문제로 인해 컨테이너가 제대로 실행되지 않는 경우가 많습니다.
Docker 컨테이너 설치 및 실행 방법 🚀
이제 가장 중요한 Docker 컨테이너 설치 단계입니다. 어렵게 생각하실 필요 없어요. 시놀로지 NAS의 Docker GUI(그래픽 사용자 인터페이스)를 이용하면 아주 간단하게 Komga를 실행할 수 있습니다.
Docker Run 명령어 사용하기
Docker 명령어를 직접 입력하여 설치할 수 있습니다. 터미널에 익숙하시다면 아래 명령어를 복사하여 붙여넣고, 경로만 수정해서 사용하세요.
docker run -d \
--name komga \
-p 25600:25600 \
-v /volume1/docker/komga:/config \
-v /volume1/comics:/data \
-e KOMGA_HOME=/config \
-e PUID=1026 -e PGID=100 \
-e TZ=Asia/Seoul \
--restart unless-stopped \
gotson/komga만약 Docker 명령어가 어려우시다면, 시놀로지 NAS의 Docker GUI를 이용하면 더 쉽게 설치할 수 있습니다. 아래 단계를 따라해 보세요.
1) Docker 패키지 실행: 시놀로지 NAS의 'Docker' 패키지를 실행합니다.
2) 이미지 다운로드: '레지스트리' 탭에서 'komga'를 검색하고, 'gotson/komga' 이미지를 더블클릭하여 다운로드합니다.
3) 컨테이너 실행: '이미지' 탭으로 이동하여 다운로드한 'gotson/komga' 이미지를 선택하고 '실행' 버튼을 누릅니다.
4) 컨테이너 설정: '일반 설정'에서 '자동 재시작 활성화'를 체크하고, '고급 설정'에서 환경 변수와 볼륨 설정을 진행합니다.
- 볼륨 설정: '폴더 추가'를 눌러 NAS의 `/volume1/docker/komga`와 `/volume1/comics` 폴더를 각각 `/config`와 `/data` 경로에 연결합니다.
- 포트 설정: '포트 설정' 탭에서 로컬 포트와 컨테이너 포트를 모두 25600으로 설정합니다.
5) 최종 실행: 모든 설정을 마친 후 '다음'과 '완료'를 눌러 컨테이너를 실행합니다. 잠시 후 '컨테이너' 탭에서 Komga 컨테이너가 실행 중인 것을 확인할 수 있습니다.
Komga 접속 및 초기 설정 💻
이제 Komga 서버가 성공적으로 실행되었습니다! 웹 브라우저를 열고 'NAS_IP_주소:25600'으로 접속해 보세요. Komga의 웹 인터페이스가 나타날 거예요.
- 초기 관리자 계정 생성: 첫 접속 시 관리자 계정을 생성하라는 화면이 나타납니다. 이 계정으로 모든 설정을 관리할 수 있으니 비밀번호를 잘 기억해두세요.
- 라이브러리 추가: 로그인 후 '라이브러리(Libraries)' 메뉴로 이동하여 '새 라이브러리 추가'를 클릭합니다. 만화 파일이 저장된 폴더(`/data`)를 추가하고, 스캔 옵션을 설정합니다.
- 자동 스캔: 라이브러리를 추가하면 Komga가 자동으로 만화 파일을 스캔하기 시작합니다. 파일이 많을수록 시간이 오래 걸릴 수 있으니 잠시 기다려주세요.
스캔이 완료되면 여러분의 디지털 도서관이 멋지게 정리된 모습을 볼 수 있을 거예요. 이제 웹 브라우저나 전용 앱으로 언제든지 만화를 볼 수 있습니다! 정말 간단하죠? 😉
Komga 설정 시 유용한 팁 💡
- Komga의 설정에서 '책 읽기' 옵션을 조절하면 페이지 넘김 방식이나 자동 스크롤 같은 기능을 사용자 취향에 맞게 바꿀 수 있어요.
- 만약 외부에서 접속이 안 된다면, NAS의 방화벽 설정이나 공유기 포트 포워딩이 제대로 되어 있는지 다시 한번 확인해 보세요.
- Komga는 메타데이터 스크래퍼 기능도 제공합니다. 외부 사이트에서 책 정보를 가져와서 더 풍부한 도서관을 만들 수 있으니 꼭 활용해 보세요.
실전 예시: 40대 직장인 김도서씨의 Komga 활용기 📚
저와 비슷한 고민을 했던 40대 직장인 김도서씨의 사례를 통해 Komga의 유용성을 더 자세히 알아볼까요? 김도서씨는 수십 년간 모아온 만화책을 모두 디지털 파일로 스캔해 두었지만, 정리가 안 되어 방치하고 있었어요. 컴퓨터로만 볼 수 있어서 접근성도 매우 낮았죠.
사례 주인공의 상황
- 문제점: 디지털 만화 파일(약 2TB)이 여러 하드디스크에 분산되어 있고, 파일명 규칙이 없어 관리가 어려움.
- 목표: 모든 파일을 한곳에 모으고, 스마트폰이나 태블릿으로 언제든 쉽게 볼 수 있는 시스템 구축.
Komga 구축 과정
1) NAS에 Docker와 Komga 컨테이너를 설치합니다.
2) `/volume1/comics` 폴더에 모든 만화 파일을 옮겨놓습니다.
3) Komga 웹 페이지에 접속해 `comics` 폴더를 라이브러리로 추가합니다.
최종 결과
- 접근성 향상: 회사 점심시간이나 출퇴근길에도 스마트폰으로 만화를 볼 수 있게 되었습니다.
- 체계적인 관리: Komga가 시리즈별로 파일을 자동으로 묶어주고, 읽은 권수나 마지막 읽은 페이지를 기억해 주어 관리가 매우 편해졌습니다.
김도서씨는 Komga 덕분에 잊고 지냈던 만화들을 다시 즐길 수 있게 되었고, 주변 친구들에게도 적극 추천하고 있다고 해요. 여러분도 김도서씨처럼 멋진 디지털 도서관을 만들어 보세요!
마무리: 핵심 내용 요약 📝
오늘 Komga를 시놀로지 NAS에 Docker로 설치하는 방법을 자세히 알아봤는데요. 글이 조금 길었지만, 핵심만 정리하면 다음과 같아요!
- 첫 번째 핵심 포인트. Komga는 만화와 소설을 위한 개인 미디어 서버로, 소장 파일을 체계적으로 관리하고 스트리밍할 수 있게 해줍니다.
- 두 번째 핵심 포인트. 시놀로지 NAS에 Docker 패키지를 설치하고, Komga 데이터와 만화 파일을 위한 전용 폴더를 미리 만들어야 해요.
- 세 번째 핵심 포인트. Docker GUI나 CLI를 이용해 Komga 컨테이너를 쉽게 설치할 수 있습니다. 볼륨과 포트 설정을 정확하게 하는 것이 가장 중요합니다.
- 네 번째 핵심 포인트. 컨테이너 실행 후 웹 브라우저로 접속해 관리자 계정을 만들고, 라이브러리를 추가하여 파일을 스캔하면 모든 준비가 끝납니다.
- 다섯 번째 핵심 포인트. Komga는 모바일 앱을 통해서도 접속 가능해서 언제 어디서든 나만의 도서관을 이용할 수 있다는 큰 장점이 있어요.
저처럼 디지털 콘텐츠 관리에 어려움을 겪으셨던 분들에게 이 글이 큰 도움이 되었으면 좋겠습니다. 혹시 설치 과정에서 궁금한 점이 있다면 언제든지 댓글로 남겨주세요~ 제가 아는 선에서 최대한 도와드릴게요! 😊
Komga 설치 핵심 요약
자주 묻는 질문 ❓
