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"

[옵션]

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

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

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

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

--ban-after
    차단을 위한 로그인 실패 횟수. IP 주소를 차단할 로그인 실패 횟수임

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

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

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

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

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

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

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

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

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

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

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

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

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

--help, -h
    이 도움말 메시지를 표시한 후 종료

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

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

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

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

--max-header-line-size
    단일 HTTP 헤더의 최대 크기(KB).

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

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

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

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

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

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

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

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

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

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

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

--ssl-certfile
    SSL 인증서 파일 경로.

--ssl-keyfile
    SSL 개인 키 파일 경로.

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

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

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

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

--version
    프로그램의 버전을 표시한 후 종료함

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

Author
Kovid Goyal

Copyright
Kovid Goyal