시놀로지 도커에 calibre-web (ebook) 설치하기

또 이것저것 보다가 calibre-web에서 txt파일이 지원이 된다고 하길래 설치해봤습니다.

 

설치하고 이런저런 문제가 생겼는데 이렇게 저렇게 해보다보니 해결이 돼서 기록으로 남깁니다.

 

우선 calibre 가 뭔가 하면

calibre - E-book management (calibre-ebook.com)

이북 관리 프로그램 입니다.

 

여러 확장자를 지원하고 다운로드 페이지에서 OS별로 다운 받아서 사용 가능합니다.

 

그리고 이 프로그램을 docker에서 사용가능 하게 해주는 게 

linuxserver/calibre - Docker Image | Docker Hub

이겁니다

calibre 서버용 이미지라고 보시면 되고요

 

우리가 설치할 이미지는 

linuxserver/calibre-web - Docker Image | Docker Hub

이거네요

 

뒤에 web이 붙은 걸 보시면 아시겠지만 웹기반 인터페이스에서 사용 가능합니다.

저장 된 ebook을 웹에서 바로 보는 것도 가능합니다.

 

사전준비사항 

a. 시놀로지 docker 설치

b. 맨 위위의 calibre 링크에서 PC용 설치 파일을 다운로드 받아주세요

(나중에 DB파일 만들 때 사용합니다)

c. raidrive를 통해 나스의 폴더를 PC에서 선택 할 수 있게 세팅해주세요

(PC용 calibre를 설치 할 때 DB가 저장될 폴더를 나스에 지정할 겁니다

다른 경로에 저장 된 DB파일을 복사해서 사용해도 작동할지는 모르겠습니다.)

 

우선 1. 폴더를 생성 합니다.

파일 스테이션을 열어 주시고 

/docker/calibreweb/books

/docker/calibreweb/config

/docker/calibreweb/tmp

/docker/calibreweb/ 아래에 3개의 폴더를 만들어 주세요 

 

2. 시놀로지 도커를 실행 하시고 

레지스트리에서 calibre 이미지를 검색해줍니다. 

 

맨위에 linuxserver/calibre-web 을 선택해서 다운 받아주세요

 

다운로드 한 이미지를 더블클릭 해서 실행해 줍니다. 

 

그대로 다음 누르시고

 

계속 사용 하실 거면 자동 재시작 체크 해주시고요

 

고급 설정 눌러주세요

 

5개의 변수를 추가해 주세요

TZ = Asia/Seoul

PUID = 1026

PGID = 100

DOCKER_MODS = linuxserver/mods:universal-calibre

OAUTHLIB_RELAX_TOKEN_SCOPE = 1

 

다 입력하셨으면 저장 - 다음

 

로컬 포트는 편한대로 설정해주세요 

컨테이너 포트는 안 건드리는 걸 추천합니다.

 

1번에서 만들었던 폴드를 매핑해줍니다.

각각 /books /config /tmp 로 매핑 해줍니다. 

 

다음

 

완료!

 

이러면 우선 컨테이너 생성은 완료가 됐습니다.

컨테이너가 시작이 안 되면 뭔가 문제가 있는 거니까요 로그를 확인해보시고 수정을 하시면 됩니다.

 

이제 나스 아이피/8888 (위에서 정한 포트) 로 접속해줍니다. 

 

이런 로그인 창이 뜨면 admin / admin123 으로 접속을 해줍니다.

 

그러면 이런 창이 뜰 겁니다.

DB 경로를 지정 해야 하는데 docker 자체에서 db생성 하는 건 좀 복잡하더라고요 

 

간단하게 설치하기 위해서 사전 준비 a에서 받아 둔 PC용 calibre를 설치해줍니다. 

도커 컨테이너는 우선 정지 해주세요

 

설치 법은

동의 후 인스톨

완료

raidrive를 통해 1번에서 만들었던 나스의 /docker/calibreweb/books 폴더를 선택해주시면 됩니다.

그 후 다음 누르시고 

그대로 다음

완료 누르시고 프로그램을 종료 하신 후에 나스 폴더에 metadata.db 파일이 생성 됐나 확인을 해보시면 됩니다.

만약 파일이 안 생겼다면 프로그램에서 아무 책이나 추가를 해보세요 

txt파일도 추가가 되니 아무 txt파일이나 추가해보셔도 됩니다

 

어쨌든 

이렇게 db파일이 생성이 됐다면

다시 컨테이너 실행 후 접속 해서 로그인 해주세요

 

이 화면에서 /books 폴더를 저장 하시면 다음 화면으로 넘어갈 수 있습니다.

(구글 드라이브랑도 연동 가능하다고 합니다만 저는 안 해봤습니다.)

 

그러면 이런 창이 뜨게 되는데요 

 

(저는 조금 세팅이 된 상태라 화면이 다를 수 있습니다.)

 

우측 상단 관리자 메뉴로 들어가시면 사용자 관리, 추가, 테마, 언어 등등 세팅할 수 있는 메뉴가 있습니다.

사용자 admin 클릭 하시면 아이디 비번 자유롭게 변경 가능합니다.

우선 다른 메뉴들은 천천히 보시고 계정 비번 변경 하시고 언어 한국어로 바꿔주시고 저장

 

다시 이 화면에서 가운데 환경 설정에 기본 환경 설정 편집을 눌러 주세요

 

여기도 여러가지 설정이 있는데 우선 외부 바이너리 설정에 저렇게 입력해주세요

/usr/bin/ebook-convert

/usr/bin/kepubify

/usr/bin/unrar

참고로 이 내용은 ebook 형식을 변환 하기 위한 옵션인데요

x86 cpu만 지원된다고 합니다. txt 같은 경우 짧은 글들은 잘 읽히는데

용량 큰 파일은 out of memory 뜨더라고요 epub은 잘 되고요 

 

위 설정을 완료하면 파일을 업로드 할 때 또는 업로드 된 파일을 다른 형식으로 변환 할 수 있습니다.

 

PC에서 하는 것보다 느리긴 한데 쓸만 하더라고요

사양이 안좋으셔서 느리신 분들은 PC에서 따로 변환 하셔서 업로드 하시길 추천합니다.

 

아까 PC에 설치한 calibre 프로그램에서 변환이나 업로드 가능합니다.

 

uI 설정에서는 테마를 변경 하거나 이런 저런 설정이 가능합니다.

전 다크모드 테마가 훨씬 낫더라고요 

 

그 외에 새로운 사용자 추가 했을 때 무슨 권한을 줄지 정할 수 있고요

 

신규 사용자에게 보여지는 카테고리? 메뉴? 설정도 가능합니다.

 

웹에서 바로 업로드를 하시려면 

아까 사용자 설정 화면에서 스샷 맨 아래 오른쪽 보시면 업로드 허용 체크 해주시면 됩니다.

 

파일 업로드 시 DB권한 에러가 나오면 파일스테이션이나 컨테이너 터미널을 이용해서

DB파일 권한을 수정을 해주시면 됩니다.

 

그 외에 다운로드 허용을 했으면 업로드 한 파일을 다운로드 할 수 있는데 

 

한글 파일의 경우 소리나는 대로 쓴 영문자로 다운이 되더라고요 

 

이거 수정 하실 거면 

 

컨테이너에서 /app/calibre-web/cps/helper.py 를 수정 해줘야 합니다.

 

calibre-web 에서 한글로 다운로드받기 : 기록 (apoolog.com)

여기 글 참고해서 수정해주시면 됩니다.

 

 

참고로 업로드나 변환은 

 

바뀐 테마 입니다만 우측 상단 업로드 누르고 파일 선택 하면 이런 화면이 뜹니다.

 

좌측 메뉴를 통해서 파일 변환을 할 수 있고요

표지나 기타 내용들 수정 가능 합니다.

 

지원 되는 확장자는 저 정도 이고 선택 후 책 변경을 눌러주면 

우측 상단 작업 메뉴에서 진행도를 확인 할 수 있습니다.

 

완료가 되면 같은 내용의 다른 확장자 txt, epub 파일 두 개가 됩니다 

필요없는 확장자는 삭제 해주시면 됩니다

다운로드용으로 함께 쓰셔도 상관은 없고요

 

 

설정하고 써보니까 텍스트 북 보는데는 나쁘지 않습니다.

만화책은 안 해봐서 잘 모르겠네요.