Komga 코미가: Synology Docker로 나만의 만화/도서 서버 구축 완벽 가이드
혹시 여러분의 NAS에 수많은 만화책, 소설, 디지털 도서 파일이 정리되지 않은 채 잠들어 있지는 않으신가요? ㅠㅠ 파일을 찾을 때마다 폴더를 헤매거나, 모바일로 보려면 일일이 옮겨야 하는 불편함은 정말...😩 저도 예전에 그 문제 때문에 골머리를 앓았거든요. 하지만 이젠 개인 미디어 서버의 끝판왕 중 하나인 **Komga(코미가)** 덕분에 모든 게 해결되었답니다!
이 글에서는 Synology NAS를 사용하시는 분들을 위해 **Docker 환경에서 Komga를 쉽고 완벽하게 설치하고 설정**하는 방법을 단계별로 안내해 드릴 거예요. 이 가이드를 따라 하시면, 복잡한 설정 없이 나만의 강력한 디지털 도서관 서버를 구축할 수 있답니다. 만화와 도서를 사랑하는 모든 분들, 지금 바로 시작해 보세요! 😊
Komga(코미가)란 무엇이며 왜 Synology Docker가 좋은가요? 🤔
**Komga(코미가)**는 디지털 만화(CBR/CBZ)와 도서(PDF, EPUB 등) 파일을 위한 오픈 소스 개인 도서관 관리 서버예요. 쉽게 말해, 넷플릭스처럼 웹 브라우저나 전용 앱을 통해 어디서든 내 만화/도서를 스트리밍해서 볼 수 있게 해주는 프로그램이죠. 특히, 메타데이터 관리, 읽은 기록 저장, 다중 사용자 지원 등 기능이 굉장히 강력합니다.
그렇다면 왜 **Komga 설치에 Synology NAS의 Docker 환경**을 추천할까요? Komga는 자바(Java) 기반으로 작동하는데, Docker를 이용하면 운영체제와 상관없이 독립된 환경에 Komga를 깔끔하게 설치할 수 있어요. Synology의 'Container Manager(이전 Docker)' 패키지는 설치와 관리가 매우 편리해서 초보자도 쉽게 서버를 구축할 수 있게 도와주거든요. 게다가 설정 오류가 생겨도 컨테이너만 삭제하면 되니, NAS 시스템 자체에 영향을 주지 않아 안전합니다!
Komga는 만화/도서 스트리밍에 최적화된 반면, Plex나 Jellyfin은 주로 영상 스트리밍에 특화되어 있어요. 오직 만화/도서 관리가 목적이라면 Komga가 훨씬 전문적이고 강력한 기능을 제공합니다. 전용 리더 인터페이스도 최고 수준이거든요!
Synology NAS에 Docker(Container Manager) 환경 준비하기 📊
Komga를 설치하기 전에 먼저 Synology NAS에 **Container Manager(도커)** 패키지가 설치되어 있어야 해요. DSM 7.2 이상 버전부터는 'Container Manager'라는 이름으로 바뀌었으니 참고해 주세요!
Container Manager 설치 및 필수 폴더 생성
| 구분 | 설명 | 비고 | 기타 정보 |
|---|---|---|---|
| Container Manager 설치 | **패키지 센터**에서 'Container Manager' 검색 후 설치합니다. | DSM 7.2 기준 이름 | 설치 시 'docker' 공유 폴더 자동 생성 확인 |
| Komga 설정 폴더 생성 | `/docker` 폴더 내에 `komga`라는 이름의 새 폴더를 생성합니다. | **필수** (`/docker/komga`) | Komga의 설정 파일과 데이터베이스가 저장될 위치 |
| 만화/도서 폴더 확인 | 만화/도서 파일이 저장된 공유 폴더의 경로를 확인합니다. | 예: `/volume1/Comics` | 나중에 컨테이너에 마운트할 때 사용 |
| 권한 설정 | 생성한 `komga` 폴더와 도서 폴더에 **`everyone` 또는 사용 중인 계정**의 읽기/쓰기 권한을 부여합니다. | **매우 중요** | 권한 오류 시 실행 불가 또는 파일 접근 불가 발생 |
Docker를 처음 설치하면 자동으로 생성되는 `/docker` 공유 폴더를 사용해야 컨테이너 관리가 용이합니다. 또한, **볼륨 설정 시 경로를 오타 없이 정확하게 입력**해야 Komga가 데이터를 저장하고 만화 파일에 접근할 수 있어요. 권한 설정은 설치 오류의 90%를 차지하는 부분이므로 꼭 확인해 주세요!
Komga Docker 이미지 다운로드 및 컨테이너 생성 🧮
이제 Container Manager를 열고 Komga 이미지를 다운로드한 다음, 컨테이너를 생성하여 실행할 차례예요. 가장 중요한 부분은 볼륨(경로) 설정과 포트 설정이랍니다.
📝 Komga Docker 이미지 정보
**이미지 이름 = `komga/komga`**
아래 단계에 따라 Komga 컨테이너를 설정해 봅시다:
1) **첫 번째 단계: 이미지 다운로드.** Container Manager의 **레지스트리** 탭에서 `komga/komga`를 검색하고 다운로드합니다.
2) **두 번째 단계: 컨테이너 생성 및 설정.** 다운로드된 이미지를 선택하고 **실행**을 눌러 설정 창을 엽니다. **일반 설정**에서 컨테이너 이름(예: `komga-server`)을 지정하고 **자동 재시작 활성화**를 체크합니다.
3) **세 번째 단계: 포트 설정.** **포트 설정** 탭에서 **로컬 포트**와 **컨테이너 포트**를 매핑합니다. Komga의 기본 **컨테이너 포트**는 **8080**이며, **로컬 포트**는 사용자가 원하는 포트(예: 8888)로 설정합니다. 외부에서 접속 시 NAS_IP:**로컬 포트**를 사용하게 됩니다.
4) **네 번째 단계: 볼륨(경로) 설정 (가장 중요!).** **볼륨 설정** 탭에서 아래와 같이 두 가지 경로를 추가합니다.
- **파일/폴더**: `/docker/komga` → **마운트 경로**: `/config` (Komga 설정/DB 파일 경로)
- **파일/폴더**: `/volume1/Comics` (여러분의 실제 도서 폴더 경로) → **마운트 경로**: `/books` (Komga가 만화 파일을 읽을 경로)
5) **다섯 번째 단계: 환경 변수 설정 (선택 사항).** **환경 변수** 탭에서 메모리 할당 등을 지정할 수 있지만, 기본 설정으로도 충분합니다.
→ 최종 결론을 여기에 명시합니다. **설정 완료 후 컨테이너를 실행합니다.**
🔢 Komga 접속 주소 계산기
Komga 최초 실행 및 도서관 설정하기 👩💼👨💻
컨테이너가 정상적으로 실행되었다면, 웹 브라우저를 열고 위에서 확인한 접속 URL로 이동하세요. **가장 먼저 할 일은 관리자 계정을 생성**하는 것입니다. 강력한 비밀번호로 설정하는 것, 잊지 마세요!
최초 관리자 계정 생성 후에는 **도서관(Library)**을 추가해야 합니다. 좌측 메뉴에서 'Libraries'로 이동하여 새로운 도서관을 만들고, 앞서 Docker 설정에서 지정한 만화/도서 파일의 마운트 경로, 즉 **`/books`**를 입력해야 Komga가 파일을 인식하고 스캔을 시작합니다.
실전 예시: 40대 직장인 박모모 씨의 Komga 서버 구축 📚
실제 예시를 통해 설정을 한번 더 점검해 봅시다. **40대 직장인 박모모 씨**는 Synology DS220+ NAS에 3TB 분량의 만화/도서 파일을 저장해 두었고, 외부에서도 안전하게 보고 싶어 Komga 서버를 구축하기로 결정했어요.
사례 주인공의 상황
- 정보 1: **NAS 모델** - Synology DS220+, **DSM 버전** - 7.2.1
- 정보 2: **도서 파일 실제 경로** - `/volume1/Digital_Books`
- 정보 3: **NAS 내부 IP 주소** - `192.168.10.50`
Komga 컨테이너 설정 과정
1) **볼륨 매핑**: `/docker/komga` → `/config` (설정/DB 경로)
2) **볼륨 매핑**: `/volume1/Digital_Books` → `/books` (도서 파일 경로)
3) **포트 매핑**: 로컬 포트 `9090` → 컨테이너 포트 `8080`
최종 결과
- 결과 항목 1: **NAS 내부 접속 URL**: `http://192.168.10.50:9090`
- 결과 항목 2: **Komga 라이브러리 설정 경로**: `/books`를 입력하여 만화/도서 스캔 시작
박모모 씨는 이 과정을 통해 성공적으로 Komga 서버를 구축하고, 이제 출퇴근길 지하철에서 끊김 없이 만화를 즐기고 있다고 하네요! 여러분도 포기하지 마시고 꼭 성공하시길 바랍니다. **핵심은 경로와 권한!** 기억하세요.
마무리: 핵심 내용 요약 📝
Komga 서버 구축은 복잡해 보이지만, 핵심만 알면 누구나 쉽게 할 수 있답니다. 오늘 배운 내용을 다시 한번 요약해 드릴게요. 이 4가지 핵심만 기억하세요!
- 첫 번째 핵심 포인트. Synology **Container Manager** (Docker)를 설치하고 **`komga` 설정 폴더**를 먼저 생성하고 권한을 부여하세요.
- 두 번째 핵심 포인트. `komga/komga` 이미지를 다운로드 후, 컨테이너 생성 시 **로컬 포트(예: 9090)**를 지정하여 NAS의 IP와 연결하세요.
- 세 번째 핵심 포인트. **볼륨 매핑**은 `NAS 경로` → `컨테이너 경로` 형식으로 정확하게 설정해야 합니다. 특히 도서 파일 경로는 **`/books`**로 통일하는 것이 편리합니다.
- 네 번째 핵심 포인트. 최초 접속 후 **관리자 계정**을 생성하고, 라이브러리 추가 시 마운트 경로인 **`/books`**를 입력하여 스캔을 시작하세요.
이 가이드를 통해 여러분만의 디지털 도서관을 성공적으로 구축하셨기를 바랍니다! 혹시 설치 중 막히는 부분이 있거나 궁금한 점이 있다면 언제든지 댓글로 물어봐주세요~ 제가 아는 선에서 최대한 도와드릴게요! 😊
Komga 설치 핵심 요약
