개인 도서관 komga docker synology 설치하기

개인 도서관 시놀로지 도커를 이용한 komga 설치

 

시놀로지 도커는 쉬운 인터페이스 덕분에 관리하기가 쉬운 편에 속하지만 도커라는 용어 자체가 낯선 분들이 많으시니 따라만 하면 설치와 운영이 가능하게 최대한 쉽게 설명해 보겠습니다.

 

저는 시놀로지 DSM 7.0으로 업데이트한 상태이지만 DSM 6.XX 버전과 설치와 운영이 100% 동일합니다.

 

도커 설치화면

1.  ① 패키지 센터를 클릭해서 오픈합니다.
2.  ② 모든 패키지 탭을 눌러서 'Docker' 아이콘을 찾아서 설치 버튼만 눌러주면 끝입니다.
3.  ③ 도커를 설치하고 나면 버튼이 '설치'에서 '열기'로 바뀝니다.
4.  설치가 되어도 바탕화면에는 변화가 없습니다. 왼쪽 상단 ④번 위치의 '모든 메뉴'라는 곳에 고래모양 도커 아이콘 생성됩니다.  도커 패키지를 설치하는 과정에선 도커대시보드에 접근할 일이 의외로 많기 때문에 고래모양 아이콘을 마우스 우클릭 해서  '바탕화면에 추가' 선택  ⑤번 처럼 바탕화면에 바로가기 아이콘이 생성해 놓습니다. 

도커 실행화면

도커를 실행하면 나오는 첫 화면입니다.

1.  ① 개요는 말그대로 도커의 전체와 실행 중인 각각의 컨테이너의 메모리, CPU 사용 현황을 볼수있습니다. 
2.  도커를 설치할때  ③ 레지스트리에서 도커 이미지를 검색해서 다운로드 하고  ④ 탭에서 이미지들을 관리합니다.
3. 밑에 있는 네트워크나 로그 탭은 특별한일 없으면 일부러 볼 필요는 없습니다.

이제 본격적으로 komga 도커를 찾아서 설치해보겠습니다.

 

 

도커 검색화면

1.  ① 검색탭에서 'komga'를 검색하면 생각보다 많은 komga로 검색됩니다.
2.  우리는 제일 상단 'gotson/komga'라고 적힌 공식 이미지를 다운로드합니다.   더블클릭해서 다운로드합니다.
3. 버전 선택하는 화면에서 최종 버전 'lastet' 선택하고 엔터. 

이미지탭

1. 이미지 탭에서 다운로드 완료된 이미지를 확인합니다. 버전에 따라서 이미지 사이즈는 조금씩 달라질 수 있습니다. 제가 받은 건 420MB네요.
2. 이미지를 실행해서 설치를 진행합니다. 더블클릭해서 실행. 

컨테이너 설정

1. 이미지를 실행시키면 바로 컨테이너 환경설정 화면으로 진입합니다.
2. 자신의 상황에 맞게 설정해주면 됩니다. 저는 ① 리소스 제한 활성화를 선택해서 komga 도커가 사용하는 CPU 우선 순의를 높음으로 했습니다. 
3. ②의 메모리 제한은 제가 가진 8기가 중 komga 도커가 5087MB 이상을 못 넘게 설정했습니다. 이것도 자신의 도커 상황에 맞게 설정해 주시면 됩니다.
4. 자동 재시작 활성화를 체크해서 나스가 재부팅되면 자동으로 komga 도커가 실행되게 했습니다.
5. '적용' 버튼을 눌러서 다음 탭으로 이동합니다.

 

볼륨설정

1. 볼륨 탭에서는 komga 라이브러리를 설정할 수 있습니다. 나스 실제 폴더를 komga의 카테고리와 매칭 시키는 과정입니다.
2. komga 설치에 필히 만들어져 있어야 하는 폴더 2개가 있습니다. 'config' 폴더와 'data' 폴더입니다.
   docker/komga/config
   docker/komga/data
   나스의 '파일 스테이션'을 이용해서 볼륨 최상단에 'docker'폴더를 만들고 그 안에 'komga' 폴더 만들고 또 그 안에 'config'와 'data'를 만들었습니다. 이렇게 딱 두 개만 만들어 주고 마운트 경로에 매칭 시켜 주면 komga는 잘 작동합니다.
   대신, 모든 책을 data 폴더에 다 넣어야 합니다. 그게 아니면 data 폴더를 세분화해서 나눠주시면 됩니다.
3. 저 같은 경우 나스의 home에 'ebooks'라는 폴더를 만들고 'ebooks' 폴더 안에 '소설', '컴퓨터', '만화' 등 필요한 카테고리별로 폴더를 만들었습니다.
   homes/yourID/ebooks/소설
   homes/yourID/ebooks/컴퓨터
   homes/yourID/ebooks/만화
   이런 형식입니다. 'yourID'는 자신의 아이디로 바꿔 주시면 됩니다.
4. '폴더 추가' 클릭해서 하나씩 매칭 시킵니다. 왼쪽은 나스의 실제 폴더이고 오른쪽은 komga 가 사용하는 카테고리 이름입니다. 모든 책을 한 폴더에 넣고 쓸 수도 있고 또는 자신이 원하는 카테고리를 세분화해서 수량만큼 폴더를 더 만들 수도 있습니다. 나를 위한 도서관을 만드는 중이니까 내 마음대로.
   즉, 왼쪽의 '파일/폴더'는 나스의 실제 폴더, 오른쪽의  '마운트 경로'는 komga에서 관리하는 카테고리로 이해하시면 됩니다.

많은 분들이 komga 만화만 볼 수 있는 걸로 오해하시는 분들이 계신 것 같습니다. 저는 제가 가진 모든 전자책을 komga로 관리합니다. 
종이책을 스캔한 이미지를 ZIP로 압축해서 확장자만 cbz 바꾸고, RAR로 압축해서 확장자를 cbr로 바꿔주면 바로 comics로 인식이 됩니다. 엄밀한 따져보면 제대로 출판된 cbz와 확장자만 cbz로 바꾼 것은 차이가 나지만 komga에서 잘 인식된다는 정도로 이해해주시면 됩니다. 

또 그냥 ZIP로 사용할 수도 있지만 ZIP 자체가 대표적인 압축 포맷이기 때문에 파일 확장자를  comics로 구분할 필요가 있습니다.

komga는 pdf, epub 등등 여러 포맷을 다 지원을 하지만 실물 책을 스캔해서 보관할 때는  OCR 하지 않는 이상 이미지 파일로 관리할 수밖에 없고, 이럴 때 cbz포맷으로 통일시켜서 komga에서 관리하는 것이 여러모로 편합니다.

 

 

포트설정

1. 포트 설정은 간단합니다. 가능하면 두 번째 칸의 '컨테이너 포트'는 바꾸지 마시길 권합니다.
2. 로컬 포트는 기본값인 auto로 두지 마시고 원하는 값으로 변경하시길 바랍니다. 여기서 변경하는 '로컬 포트'를 이용해서 공유기의 포트 포워딩하시면 됩니다.
3. 저는 3자 하나 더 붙여서 38080으로 설정했습니다.

 

환경설정

1. 환경설정은 크게 손 안 대지 않아도 됩니다.  기본값 그대로 사용했습니다.
2. 문자코드도 수정 안 해도 별 문제없었습니다.
3. PUIP, PGID는  폴더 권한 때문에 입력하라고 하는데 혼자 사용하는 저로서는 설정하지 않아도 괜찮았습니다. 혹시 문제가 생기면 넣어주세요.
   '추가' 버튼 클릭하시고 '변수'에 PUID '값'에 1000 입력하시고 같은 방식으로 PGID, 1000 넣어 주시면 됩니다.
   간혹 ssh로 접속해서  id를 조회해서 uid(PUID), gid(PGID) 넣으라는 분도 계시는데 폴더 권한에 문제가 있으신 분들은 참고 바랍니다.
4. 마지막 줄 TimeZone 세팅도 기본값에 빠져 있으면 추가하시면 됩니다.
   '추가' 버튼 클릭하시고 '변수'에 'TZ' '값'에 "Asia/Seoul'

이제 웹브라우저로 komga 서버에 접속합니다. 나스가 할당받은 공유기 아이피가 192.168.0.100이라고 가정하면

http://192.168.0.100:38080 또는 https://192.168.0.1000:38080으로 접속하시면 됩니다.

 

여기까지가 komga 도커에서의 설정입니다.