Scroll to navigation

CALIBRE-SERVER(1) calibre CALIBRE-SERVER(1)

NAME

calibre-server - calibre-server

calibre-server [options] [path to library folder...]


calibre 콘텐츠 서버를 시작합니다. calibre 콘텐츠 서버는 calibre 라이브러리를 인터넷을 통해 제공합니다. 라이브러리 폴더 경로를 :command:

`
calibre-server`의 인수로 지정할 수 있습니다. 경로를 지정하지 않으면 기본 calibre 프로그램이 알고 있는 모든 라이브러리가 사용됩니다.

:command:

`
calibre-server`에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

[옵션]

접근 로그 파일 경로입니다. 이 로그에는 서버에 접속하여 요청을 수행한 클라이언트 정보가 기록됩니다. 기본적으로 접근 로그는 기록하지 않습니다.

쿼리 전송 후 서버 응답을 기다리는 시간(초).

사용할 인증 방식 선택. 서버에서 사용할 HTTP 인증 모드를 설정합니다. 이 서버를 SSL 프록시 뒤에 둘 경우 "basic"으로 설정하십시오. 그렇지 않으면 "auto"로 두면 되며, SSL이 구성된 경우 "basic"을, 그렇지 않으면 "digest"를 사용합니다.

소스 코드가 바뀌면 서버를 자동으로 다시 불러옵니다. 개발 시 유용합니다. 종료 대기 시간에도 작은 값을 지정하는 것이 좋습니다.

차단을 위한 로그인 실패 횟수. IP 주소를 차단할 로그인 실패 횟수입니다

로그인 실패가 반복된 IP 주소 차단. 로그인 실패가 반복된 IP 주소의 접근을 지정한 분 수 동안 임시 차단합니다. 비밀번호 추측 시도를 막는 데 유용합니다. 0으로 설정하면 차단하지 않습니다.

기본 책 목록 모드 선택. 새 사용자에게 적용할 기본 책 목록 모드를 설정합니다. 개별 사용자는 자기 설정에서 이 기본값을 덮어쓸 수 있습니다. 기본값은 표지 격자입니다.

응답에 데이터 압축을 사용할 최소 크기(바이트).

사용자 정의 책 목록 모드용 템플릿이 들어 있는 JSON 파일의 경로입니다. 이런 템플릿 파일을 만드는 가장 쉬운 방법은 calibre의 환경설정-> 네트워크 공유-> 책 목록 템플릿으로 가서 템플릿을 만든 뒤 내보내는 것입니다.

프로세스를 백그라운드에서 데몬으로 실행(Linux 전용).

표시할 사용자 정의 필드 제한. 콘텐츠 서버의 /opds 및 /mobile 보기에서 표시할 사용자 정의 메타데이터 필드의 쉼표 구분 목록입니다. 이 옵션을 지정하면 이 목록에 없는 필드는 표시되지 않습니다. 예: my_rating,my_tags

예를 들어 systemd 소켓 활성화와 같은 소켓 사전 할당. 기본적으로 이 옵션은 활성화되어 있습니다.

서버 접근용 비밀번호 기반 인증. 기본적으로 서버는 제한 없이 누구나 접근할 수 있습니다. 이 옵션으로 미리 정의한 사용자로 접근을 제한할 수 있습니다. 기본적으로 이 옵션은 비활성화되어 있습니다.

자동 감지된 인터페이스로 대체. 어떤 이유로든 서버가 listen_on 옵션에 지정된 인터페이스에 바인딩할 수 없으면, 외부 네트워크와 연결되는 인터페이스를 감지해 그쪽에 바인딩을 시도합니다. 기본적으로 이 옵션은 활성화되어 있습니다.

인증되지 않은 로컬 연결의 변경 허용. 기본적으로 인증을 켜지 않으면 서버는 읽기 전용 모드로 동작하여 익명 사용자가 calibre 라이브러리를 변경하지 못하게 합니다. 이 옵션을 사용하면 서버가 실행 중인 같은 컴퓨터에서 연결하는 누구나 변경할 수 있습니다. 인증 없이 서버를 실행하면서도 calibredb로 calibre 라이브러리를 변경하려는 경우 유용합니다. 이 옵션을 켜면 컴퓨터에서 실행 중인 어떤 프로그램이든 calibre 라이브러리를 변경할 수 있다는 점에 유의하십시오. 특히 Firefox 웹 브라우저는 임의의 웹사이트에도 이를 허용합니다. 기본적으로 이 옵션은 비활성화되어 있습니다.

HTTP 404(찾을 수 없음) 요청 기록. 기본적으로 서버는 찾을 수 없는 리소스에 대한 모든 HTTP 요청을 기록합니다. 서버가 봇의 대상이 되면 로그가 과도하게 쌓일 수 있습니다. 이 옵션으로 끌 수 있습니다. 기본적으로 이 옵션은 활성화되어 있습니다.

Bonjour를 통해 OPDS 피드 광고. Bonjour 서비스를 통해 OPDS 피드를 알리므로, OPDS 기반 읽기 앱이 서버를 자동으로 감지하고 연결할 수 있습니다. 기본적으로 이 옵션은 활성화되어 있습니다.

성능 향상을 위한 제로 카피 파일 전송. 네트워크로 파일을 보낼 때 커널 내 제로 카피 전송을 사용해 성능을 높입니다. 하지만 일부 문제가 있는 파일 시스템에서는 전송 파일이 손상될 수 있습니다. 파일 전송 손상이 발생하면 이 옵션을 끄십시오. 기본적으로 이 옵션은 활성화되어 있습니다.

이 도움말 메시지를 표시한 후 종료

무시할 사용자 정의 메타데이터 필드. 콘텐츠 서버의 /opds 및 /mobile 보기에서 표시하지 않을 사용자 정의 메타데이터 필드의 쉼표 구분 목록입니다. 예: my_rating,my_tags

연결을 수신할 인터페이스. 기본값은 사용 가능한 모든 IPv6 및 IPv4 인터페이스에서 수신하는 것입니다. 예를 들어 로컬 시스템의 IPv4 연결만 수신하려면 "127.0.0.1"로, 모든 들어오는 IPv4 연결을 수신하려면 "0.0.0.0"으로 바꿀 수 있습니다.

서버 로그용 로그 파일 경로입니다. 이 로그에는 서버 정보와 오류가 기록되며, 접근 로그는 포함되지 않습니다. 기본값은 stdout에 기록하는 것입니다.

이 서버에 연결할 수 있는 사용자 데이터베이스를 관리합니다. --를 추가하여 자동화 모드로 사용할 수 있습니다. 자세한 내용은 calibre-server --manage-users -- help을 참고하십시오. --userdb 옵션도 함께 보십시오.

단일 HTTP 헤더의 최대 크기(KB).

작업자 프로세스 최대 실행 시간. 작업자 프로세스가 실행될 수 있는 최대 시간(분)입니다. 0으로 설정하면 제한이 없습니다.

작업자 프로세스 최대 수. 작업자 프로세스는 필요할 때 시작되며 책 보기 준비, 책 추가, 변환 같은 큰 작업에 사용됩니다. 일반적으로 이러한 프로세스의 최대 수는 CPU 코어 수를 기준으로 결정됩니다. 이 설정으로 제어할 수 있습니다.

로그 파일 최대 크기(MB). 서버가 생성하는 로그 파일의 최대 크기입니다. 로그가 이 크기를 넘으면 자동으로 순환됩니다. 0으로 설정하면 로그 순환이 비활성화됩니다.

OPDS 피드의 최대 책 수. 서버가 단일 OPDS 수집 피드에서 반환할 최대 책 수입니다.

OPDS 피드에서 그룹화되지 않은 항목의 최대 수. 저자/태그 같은 범주의 항목 수가 이 값보다 많으면 첫 글자 기준으로 그룹화합니다. 0으로 설정하면 비활성화됩니다.

서버에 업로드할 수 있는 파일의 최대 크기(MB).

한 페이지에 표시할 책 수. 브라우저에서 한 페이지에 표시할 책 수입니다.

프로세스 PID를 지정한 파일에 기록

접속 대기용으로 사용할 서버측 포트 번호:.

"인터넷 검색" 기능용 URL이 들어 있는 JSON 파일 경로입니다. 이런 파일을 만드는 가장 쉬운 방법은 calibre의 환경설정-> 네트워크 공유-> 인터넷 검색으로 가서 URL을 만든 뒤 내보내는 것입니다.

정상 종료를 기다리는 총 시간(초).

SSL 인증서 파일 경로.

SSL 개인 키 파일 경로.

유휴 연결을 닫기까지의 시간(초).

특정 IP 주소의 인증되지 않은 연결에 변경 허용. 기본적으로 인증을 켜지 않으면 서버는 읽기 전용 모드로 동작하여 익명 사용자가 calibre 라이브러리를 변경하지 못하게 합니다. 이 옵션을 사용하면 지정한 IP 주소에서 연결하는 누구나 변경할 수 있습니다. 주소 또는 네트워크 규격의 쉼표로 구분된 목록이어야 합니다. 인증 없이 서버를 실행하면서도 calibredb로 calibre 라이브러리를 변경하려는 경우 유용합니다. 이 옵션을 켜면 지정한 IP 주소에서 연결하는 누구나 calibre 라이브러리를 변경할 수 있습니다.

모든 URL 앞에 붙일 접두어. 이 서버를 리버스 프록시 뒤에서 실행하려는 경우 유용합니다. 예를 들어 URL 접두어로 /calibre를 사용하십시오.

인증에 사용할 사용자 데이터베이스 파일 경로입니다. 데이터베이스는 SQLite 파일입니다. 만들려면 :option: 
`
--manage-users`을 사용하십시오. 사용자 관리에 대한 자세한 내용: <https://manual.calibre-ebook.com/ko/server.html#managing-user-accounts-from-the-command-line-only>

프로그램의 버전을 표시한 후 종료합니다.

요청 처리에 사용할 작업자 스레드 수.

Author

Kovid Goyal

Copyright

Kovid Goyal

5월 01, 2026 9.8.0