komga 도커 설치: 시놀로지(Synology)에서 나만의 개인 만화/도서관 구축하는 완벽 가이드
혹시 여러분도 취미로 모아둔 만화책, 소설, 각종 문서를 깔끔하게 정리해서 언제 어디서든 스마트폰이나 태블릿으로 보고 싶다는 생각을 해보신 적 있나요? 저 역시 수많은 디지털 파일을 보관하면서 '이걸 좀 더 편리하게 관리할 수 없을까?' 고민했거든요. 일반 폴더 관리로는 한계가 있고, 모바일로 볼 때마다 파일을 일일이 옮겨야 하는 것도 너무 번거롭죠.
이 글을 읽으시면 Komga라는 강력한 개인 도서관 서버를 시놀로지(Synology) NAS에 도커(Docker)로 설치하는 모든 과정을 A부터 Z까지 완벽하게 해결하실 수 있습니다. 도커가 처음이더라도 걱정 마세요! 가장 쉽고 안정적인 방법만 쏙쏙 뽑아 담았답니다! 😊
1. Komga란 무엇이며 왜 도커로 설치해야 할까요? 🤔
Komga는 만화(Comic Book), 잡지, EPUB 전자책 같은 디지털 미디어를 관리하고 스트리밍할 수 있게 해주는 오픈소스 개인 미디어 서버예요. 이미지 뷰어 기능은 기본이고, 제목, 작가, 출판사별로 메타데이터를 자동으로 정리해줘서 마치 넷플릭스처럼 나만의 도서관 인터페이스를 만들어주죠.
그럼 왜 시놀로지에서 이 Komga를 '도커'로 설치하는 게 좋을까요? 도커를 사용하면 Komga가 NAS의 다른 시스템 환경에 영향을 주지 않는 독립된 환경(컨테이너)에서 작동할 수 있거든요. 나중에 업데이트나 문제가 생겨도 메인 NAS 시스템에 손상을 줄 염려가 없어 안정성이 뛰어나답니다.
Komga는 Calibre나 Ubooquity 같은 다른 도서 관리 툴과 비교했을 때, 특히 만화책(CBZ, CBR) 관리에 특화되어 있고 모바일 앱(Tachiyomi, Panels 등) 연동성이 뛰어나다는 장점이 있어요. Java 기반으로 작동하므로, 도커를 이용해 필요한 Java 환경까지 한 번에 구성하는 것이 가장 편리합니다.
2. 시놀로지 NAS 도커 설치 사전 준비 사항 📊
본격적인 설치에 앞서, 시놀로지 NAS에서 몇 가지 환경 설정을 미리 해두셔야 해요. 이 과정을 건너뛰면 나중에 파일 접근 권한 문제나 설정 오류로 고생할 수 있거든요. 특별히 강조하고 싶은 내용은 '사용자/그룹 ID' 설정입니다.
필수 환경 설정 체크리스트
| 구분 | 설명 | 비고 | 기타 정보 |
|---|---|---|---|
| 도커 패키지 | 시놀로지 패키지 센터에서 'Docker' 설치 확인 | NAS 모델에 따라 지원 여부 확인 필요 | Docker 설치가 안되면 Komga 설치 불가 |
| Komga 데이터 폴더 | NAS 내 'docker/komga/data' 폴더 미리 생성 | Komga의 설정 및 데이터베이스 저장 경로 | NAS의 SSD나 성능 좋은 볼륨에 생성 권장 |
| 라이브러리 폴더 | 만화/도서 파일이 저장된 NAS 경로 확인 | 'comics', 'library' 등의 이름으로 폴더 준비 | 권한 문제가 없도록 읽기/쓰기 권한 부여 |
| 사용자 ID (UID/GID) | Komga 컨테이너가 사용할 권한을 가진 계정의 ID 확인 | SSH로 접속 후 `id 사용자명` 명령어로 확인 (예: 1026) | 파일 접근 권한 오류 방지를 위한 핵심 설정 |
UID/GID 설정이 가장 중요합니다! 도커 컨테이너는 기본적으로 `root` 권한으로 실행되는데, 보안상 위험하고 NAS 폴더에 접근 못 하는 경우가 많아요. NAS의 일반 계정 중 하나를 지정해서 해당 계정의 ID를 환경 변수에 넣어줘야 파일 접근 권한 문제가 깔끔하게 해결됩니다.
3. Komga 도커 이미지 다운로드 및 컨테이너 설정 🧮
이제 준비가 끝났으니 시놀로지 도커 앱을 열어서 Komga 이미지를 다운로드하고 컨테이너를 생성해볼 거예요. 이 과정이 조금 복잡하게 느껴질 수도 있지만, 저를 따라 차근차근 하시면 쉽게 하실 수 있을 거예요!
📝 Komga 도커 이미지 다운로드
1. 시놀로지 Docker 앱 실행 후 '레지스트리' 탭으로 이동합니다.
2. 검색창에 `komga`를 입력하고, `gotson/komga` 이미지를 선택 후 다운로드합니다.
이미지 다운로드가 완료되면, 이제 컨테이너를 생성하고 환경 변수와 볼륨을 설정할 차례입니다:
📝 핵심 환경 변수 설정
1) 첫 번째 단계: '환경' 탭에서 다음 변수들을 추가합니다.
- `PUID` : 준비 단계에서 확인한 사용자 ID (UID)를 입력합니다.
- `PGID` : 준비 단계에서 확인한 그룹 ID (GID)를 입력합니다.
- `KOMGA_SERVER_PORT` : Komga가 사용할 포트 번호를 입력합니다. (예: `25600`)
2) 두 번째 단계: '볼륨' 탭에서 NAS 폴더와 컨테이너 경로를 매핑합니다.
- NAS 경로 (`/docker/komga/data`) <--> 컨테이너 경로 (`/config`) : Komga 설정 파일 저장소
- NAS 경로 (`/Volume1/comics`) <--> 컨테이너 경로 (`/data`) : 여러분의 만화 파일 저장소 (NAS 경로를 실제 경로로 변경하세요!)
→ 마지막으로 '포트 설정' 탭에서 로컬 포트(예: 25600)를 컨테이너 포트(25600)에 연결합니다.
설정이 끝나면 컨테이너를 실행하고 웹 브라우저에서 `http://NAS_IP:25600` (포트는 설정하신 대로)으로 접속해 보세요. 처음 접속하면 관리자 계정을 생성하라는 화면이 뜰 거예요.
4. Komga 라이브러리 설정 및 모바일 연동 👩💼👨💻
Komga에 접속해서 계정 생성까지 완료했다면, 이제 가장 중요한 만화 라이브러리를 추가할 차례입니다. 이 섹션에서는 라이브러리 등록과 모바일에서 편하게 접속하는 방법까지 다뤄볼게요.
라이브러리 경로는 도커 컨테이너 내부 경로인 `/data`를 입력해야 해요. 이 경로가 바로 NAS의 실제 만화 폴더(예: `/Volume1/comics`)와 연결되어 있거든요. Komga가 파일을 읽어와서 자동으로 스캔하고 메타데이터를 정리해 주기 시작할 겁니다!
실전 예시: 40대 직장인 박모모씨의 도서관 구축 📚
저희 고객 중 한 분인 40대 직장인 박모모씨의 사례를 통해 실제 어떻게 적용되는지 구체적인 예시를 제공해 드릴게요. 박모모씨는 3,000권 이상의 만화책과 500여 권의 EPUB 파일을 가지고 계셨고, 출퇴근길에 태블릿으로 보고 싶어 하셨어요.
사례 주인공의 상황
- 정보 1: NAS 모델: Synology DS920+ (Docker 지원 모델)
- 정보 2: 만화 파일 경로: `/Volume1/Media/Comics`
설정 과정 요약
1) 첫 번째 단계: NAS에서 박모모씨 계정의 UID/GID 확인 (UID: 1027, GID: 100)
2) 두 번째 단계: 도커 환경 변수에 `PUID=1027`, `PGID=100` 설정
3) 세 번째 단계: 볼륨 설정에서 `/Volume1/Media/Comics`를 컨테이너의 `/data` 경로와 매핑
4) 네 번째 단계: Komga 웹에서 라이브러리 추가 시 경로를 `/data`로 입력
최종 결과
- 결과 항목 1: 모든 파일 메타데이터 자동 인식 완료. 깔끔한 웹 도서관 완성.
- 결과 항목 2: 모바일 앱(Panels)을 통해 외부 접속 설정 후 출퇴근길에도 스트리밍으로 만화 감상 가능.
이 사례처럼 Komga는 파일 관리에 드는 시간을 혁신적으로 줄여주고, 모바일 환경에서 압도적인 편리함을 제공합니다. 여러분도 이 가이드를 통해 자신만의 완벽한 디지털 라이브러리를 구축해 보세요!
마무리: 핵심 내용 요약 📝
지금까지 시놀로지 NAS에 Komga를 도커로 설치하고 설정하는 모든 핵심 과정을 짚어봤습니다. 이 모든 과정을 깔끔하게 정리한 핵심 포인트는 다음과 같습니다.
- 첫 번째 핵심 포인트. Komga는 만화/도서에 특화된 개인 미디어 서버입니다.
- 두 번째 핵심 포인트. 도커(Docker) 설치는 안정성과 유지보수 측면에서 가장 추천되는 방법입니다.
- 세 번째 핵심 포인트. PUID/PGID 환경 변수 설정은 파일 권한 문제 해결의 핵심입니다.
- 네 번째 핵심 포인트. NAS의 실제 폴더를 컨테이너의 `/data` 경로와 반드시 매핑해야 합니다.
- 다섯 번째 핵심 포인트. 모바일 앱과 연동하여 어디서든 편리하게 스트리밍으로 감상할 수 있습니다.
자, 이제 여러분도 나만의 디지털 만화/도서관 관장이 되실 준비가 되셨습니다! 궁금한 점이나 막히는 부분이 있다면 주저하지 마시고 댓글로 물어봐주세요~ 😊
Komga 설치 핵심 요약
