| 1 |
.\" Man page generated from reStructuredText |
| 2 |
.\" by the Docutils 0.22.4 manpage writer. |
| 3 |
. |
| 4 |
. |
| 5 |
.nr rst2man-indent-level 0 |
| 6 |
. |
| 7 |
.de1 rstReportMargin |
| 8 |
\\$1 \\n[an-margin] |
| 9 |
level \\n[rst2man-indent-level] |
| 10 |
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 11 |
- |
| 12 |
\\n[rst2man-indent0] |
| 13 |
\\n[rst2man-indent1] |
| 14 |
\\n[rst2man-indent2] |
| 15 |
.. |
| 16 |
.de1 INDENT |
| 17 |
.\" .rstReportMargin pre: |
| 18 |
. RS \\$1 |
| 19 |
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] |
| 20 |
. nr rst2man-indent-level +1 |
| 21 |
.\" .rstReportMargin post: |
| 22 |
.. |
| 23 |
.de UNINDENT |
| 24 |
. RE |
| 25 |
.\" indent \\n[an-margin] |
| 26 |
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 27 |
.nr rst2man-indent-level -1 |
| 28 |
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] |
| 29 |
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u |
| 30 |
.. |
| 31 |
.TH "CALIBRE-SERVER" "1" "9월 18, 2026" "9.15.0" "calibre" |
| 32 |
.SH NAME |
| 33 |
calibre-server \- calibre-server |
| 34 |
.INDENT 0.0 |
| 35 |
.INDENT 3.5 |
| 36 |
.sp |
| 37 |
.EX |
| 38 |
calibre\-server [options] [path to library folder...] |
| 39 |
.EE |
| 40 |
.UNINDENT |
| 41 |
.UNINDENT |
| 42 |
.sp |
| 43 |
calibre 콘텐츠 서버를 시작합니다. calibre 콘텐츠 서버는 |
| 44 |
calibre 라이브러리를 인터넷을 통해 제공합니다. 라이브러리 |
| 45 |
폴더 경로를 :command: |
| 46 |
.nf |
| 47 |
\(ga |
| 48 |
.fi |
| 49 |
calibre\-server\(ga의 인수로 지정할 수 있습니다. 경로를 지정하지 않으면 |
| 50 |
기본 calibre 프로그램이 알고 있는 모든 라이브러리가 사용됩니다. |
| 51 |
.sp |
| 52 |
:command: |
| 53 |
.nf |
| 54 |
\(ga |
| 55 |
.fi |
| 56 |
calibre\-server\(ga에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: \(dq/some path/with spaces\(dq |
| 57 |
.SH [옵션] |
| 58 |
.INDENT 0.0 |
| 59 |
.TP |
| 60 |
.B \-\-access\-log |
| 61 |
접근 로그 파일 경로입니다. 이 로그에는 서버에 접속하여 요청을 수행한 클라이언트 정보가 기록됩니다. 기본적으로 접근 로그는 기록하지 않습니다. |
| 62 |
.UNINDENT |
| 63 |
.INDENT 0.0 |
| 64 |
.TP |
| 65 |
.B \-\-ajax\-timeout |
| 66 |
쿼리 전송 후 서버 응답을 기다리는 시간(초). |
| 67 |
.UNINDENT |
| 68 |
.INDENT 0.0 |
| 69 |
.TP |
| 70 |
.B \-\-auth\-mode |
| 71 |
사용할 인증 방식 선택. 서버에서 사용할 HTTP 인증 모드를 설정합니다. 이 서버를 SSL 프록시 뒤에 둘 경우 \fB\(dq\fPbasic\fB\(dq\fP으로 설정하십시오. 그렇지 않으면 \fB\(dq\fPauto\fB\(dq\fP로 두면 되며, SSL이 구성된 경우 \fB\(dq\fPbasic\fB\(dq\fP을, 그렇지 않으면 \fB\(dq\fPdigest\fB\(dq\fP를 사용합니다. |
| 72 |
.UNINDENT |
| 73 |
.INDENT 0.0 |
| 74 |
.TP |
| 75 |
.B \-\-auto\-reload |
| 76 |
소스 코드가 바뀌면 서버를 자동으로 다시 불러옵니다. 개발 시 유용합니다. 종료 대기 시간에도 작은 값을 지정하는 것이 좋습니다. |
| 77 |
.UNINDENT |
| 78 |
.INDENT 0.0 |
| 79 |
.TP |
| 80 |
.B \-\-ban\-after |
| 81 |
차단을 위한 로그인 실패 횟수. IP 주소를 차단할 로그인 실패 횟수임 |
| 82 |
.UNINDENT |
| 83 |
.INDENT 0.0 |
| 84 |
.TP |
| 85 |
.B \-\-ban\-for |
| 86 |
로그인 실패가 반복된 IP 주소 차단. 로그인 실패가 반복된 IP 주소의 접근을 지정한 분 수 동안 임시 차단합니다. 비밀번호 추측 시도를 막는 데 유용합니다. 0으로 설정하면 차단하지 않습니다. |
| 87 |
.UNINDENT |
| 88 |
.INDENT 0.0 |
| 89 |
.TP |
| 90 |
.B \-\-book\-list\-mode |
| 91 |
기본 책 목록 모드 선택. 새 사용자에게 적용할 기본 책 목록 모드를 설정합니다. 개별 사용자는 자기 설정에서 이 기본값을 덮어쓸 수 있습니다. 기본값은 표지 격자입니다. |
| 92 |
.UNINDENT |
| 93 |
.INDENT 0.0 |
| 94 |
.TP |
| 95 |
.B \-\-compress\-min\-size |
| 96 |
응답에 데이터 압축을 사용할 최소 크기(바이트). |
| 97 |
.UNINDENT |
| 98 |
.INDENT 0.0 |
| 99 |
.TP |
| 100 |
.B \-\-custom\-list\-template |
| 101 |
사용자 지정 책 목록 모드용 템플릿이 들어 있는 JSON 파일의 경로입니다. 이런 템플릿 파일을 만드는 가장 쉬운 방법은 calibre의 환경설정\-> 네트워크 공유\-> 책 목록 템플릿으로 가서 템플릿을 만든 뒤 내보내는 것입니다. |
| 102 |
.UNINDENT |
| 103 |
.INDENT 0.0 |
| 104 |
.TP |
| 105 |
.B \-\-daemonize |
| 106 |
프로세스를 백그라운드에서 데몬으로 실행(Linux 전용). |
| 107 |
.UNINDENT |
| 108 |
.INDENT 0.0 |
| 109 |
.TP |
| 110 |
.B \-\-displayed\-fields |
| 111 |
표시할 사용자 지정 필드 제한. 콘텐츠 서버의 /opds 및 /mobile 보기에서 표시할 사용자 지정 메타데이터 필드의 쉼표 구분 목록입니다. 이 옵션을 지정하면 이 목록에 없는 필드는 표시되지 않습니다. 예: my_rating,my_tags |
| 112 |
.UNINDENT |
| 113 |
.INDENT 0.0 |
| 114 |
.TP |
| 115 |
.B \-\-enable\-allow\-socket\-preallocation, \-\-disable\-allow\-socket\-preallocation |
| 116 |
예를 들어 systemd 소켓 활성화와 같은 소켓 사전 할당. 기본적으로 이 옵션은 활성화되어 있습니다. |
| 117 |
.UNINDENT |
| 118 |
.INDENT 0.0 |
| 119 |
.TP |
| 120 |
.B \-\-enable\-auth, \-\-disable\-auth |
| 121 |
서버 접근용 비밀번호 기반 인증. 기본적으로 서버는 제한 없이 누구나 접근할 수 있습니다. 이 옵션으로 미리 정의한 사용자로 접근을 제한할 수 있습니다. 기본적으로 이 옵션은 비활성화되어 있습니다. |
| 122 |
.UNINDENT |
| 123 |
.INDENT 0.0 |
| 124 |
.TP |
| 125 |
.B \-\-enable\-fallback\-to\-detected\-interface, \-\-disable\-fallback\-to\-detected\-interface |
| 126 |
자동 감지된 인터페이스로 대체. 어떤 이유로든 서버가 listen_on 옵션에 지정된 인터페이스에 바인딩할 수 없으면, 외부 네트워크와 연결되는 인터페이스를 감지해 그쪽에 바인딩을 시도합니다. 기본적으로 이 옵션은 활성화되어 있습니다. |
| 127 |
.UNINDENT |
| 128 |
.INDENT 0.0 |
| 129 |
.TP |
| 130 |
.B \-\-enable\-local\-write, \-\-disable\-local\-write |
| 131 |
인증되지 않은 로컬 연결의 변경 허용. 기본적으로 인증을 켜지 않으면 서버는 읽기 전용 모드로 동작하여 익명 사용자가 calibre 라이브러리를 변경하지 못하게 합니다. 이 옵션을 사용하면 서버가 실행 중인 같은 컴퓨터에서 연결하는 누구나 변경할 수 있습니다. 인증 없이 서버를 실행하면서도 calibredb로 calibre 라이브러리를 변경하려는 경우 유용합니다. 이 옵션을 켜면 컴퓨터에서 실행 중인 어떤 프로그램이든 calibre 라이브러리를 변경할 수 있다는 점에 유의하십시오. 특히 Firefox 웹 브라우저는 임의의 웹사이트에도 이를 허용합니다. 기본적으로 이 옵션은 비활성화되어 있습니다. |
| 132 |
.UNINDENT |
| 133 |
.INDENT 0.0 |
| 134 |
.TP |
| 135 |
.B \-\-enable\-log\-not\-found, \-\-disable\-log\-not\-found |
| 136 |
HTTP 404(찾을 수 없음) 요청 기록. 기본적으로 서버는 찾을 수 없는 리소스에 대한 모든 HTTP 요청을 기록합니다. 서버가 봇의 대상이 되면 로그가 과도하게 쌓일 수 있습니다. 이 옵션으로 끌 수 있습니다. 기본적으로 이 옵션은 활성화되어 있습니다. |
| 137 |
.UNINDENT |
| 138 |
.INDENT 0.0 |
| 139 |
.TP |
| 140 |
.B \-\-enable\-use\-bonjour, \-\-disable\-use\-bonjour |
| 141 |
Bonjour를 통해 OPDS 피드 광고. Bonjour 서비스를 통해 OPDS 피드를 알리므로, OPDS 기반 읽기 앱이 서버를 자동으로 감지하고 연결할 수 있습니다. 기본적으로 이 옵션은 활성화되어 있습니다. |
| 142 |
.UNINDENT |
| 143 |
.INDENT 0.0 |
| 144 |
.TP |
| 145 |
.B \-\-enable\-use\-sendfile, \-\-disable\-use\-sendfile |
| 146 |
성능 향상을 위한 제로 카피 파일 전송. 네트워크로 파일을 보낼 때 커널 내 제로 카피 전송을 사용해 성능을 높입니다. 하지만 일부 문제가 있는 파일 시스템에서는 전송 파일이 손상될 수 있습니다. 파일 전송 손상이 발생하면 이 옵션을 끄십시오. 기본적으로 이 옵션은 활성화되어 있습니다. |
| 147 |
.UNINDENT |
| 148 |
.INDENT 0.0 |
| 149 |
.TP |
| 150 |
.B \-\-help, \-h |
| 151 |
이 도움말 메시지를 표시한 후 종료 |
| 152 |
.UNINDENT |
| 153 |
.INDENT 0.0 |
| 154 |
.TP |
| 155 |
.B \-\-ignored\-fields |
| 156 |
무시할 사용자 지정 메타데이터 필드. 콘텐츠 서버의 /opds 및 /mobile 보기에서 표시하지 않을 사용자 지정 메타데이터 필드의 쉼표 구분 목록입니다. 예: my_rating,my_tags |
| 157 |
.UNINDENT |
| 158 |
.INDENT 0.0 |
| 159 |
.TP |
| 160 |
.B \-\-listen\-on |
| 161 |
연결을 수신할 인터페이스. 기본값은 사용 가능한 모든 IPv6 및 IPv4 인터페이스에서 수신하는 것입니다. 예를 들어 로컬 시스템의 IPv4 연결만 수신하려면 \fB\(dq\fP127.0.0.1\fB\(dq\fP로, 모든 들어오는 IPv4 연결을 수신하려면 \fB\(dq\fP0.0.0.0\fB\(dq\fP으로 바꿀 수 있습니다. |
| 162 |
.UNINDENT |
| 163 |
.INDENT 0.0 |
| 164 |
.TP |
| 165 |
.B \-\-log |
| 166 |
서버 로그용 로그 파일 경로입니다. 이 로그에는 서버 정보와 오류가 기록되며, 접근 로그는 포함되지 않습니다. 기본값은 stdout에 기록하는 것입니다. |
| 167 |
.UNINDENT |
| 168 |
.INDENT 0.0 |
| 169 |
.TP |
| 170 |
.B \-\-manage\-users |
| 171 |
이 서버에 연결할 수 있는 사용자 데이터베이스를 관리합니다. \-\-를 추가하여 자동화 모드로 사용할 수 있습니다. 자세한 내용은 calibre\-server \fB\-\-manage\-users\fP \fB\-\-\fP help을 참고하십시오. \fB\-\-userdb\fP 옵션도 함께 보십시오. |
| 172 |
.UNINDENT |
| 173 |
.INDENT 0.0 |
| 174 |
.TP |
| 175 |
.B \-\-max\-header\-line\-size |
| 176 |
단일 HTTP 헤더의 최대 크기(KB). |
| 177 |
.UNINDENT |
| 178 |
.INDENT 0.0 |
| 179 |
.TP |
| 180 |
.B \-\-max\-job\-time |
| 181 |
작업자 프로세스 최대 실행 시간. 작업자 프로세스가 실행될 수 있는 최대 시간(분)입니다. 0으로 설정하면 제한이 없습니다. |
| 182 |
.UNINDENT |
| 183 |
.INDENT 0.0 |
| 184 |
.TP |
| 185 |
.B \-\-max\-jobs |
| 186 |
작업자 프로세스 최대 수. 작업자 프로세스는 필요할 때 시작되며 책 보기 준비, 책 추가, 변환 같은 큰 작업에 사용됩니다. 일반적으로 이러한 프로세스의 최대 수는 CPU 코어 수를 기준으로 결정됩니다. 이 설정으로 제어할 수 있습니다. |
| 187 |
.UNINDENT |
| 188 |
.INDENT 0.0 |
| 189 |
.TP |
| 190 |
.B \-\-max\-log\-size |
| 191 |
로그 파일 최대 크기(MB). 서버가 생성하는 로그 파일의 최대 크기입니다. 로그가 이 크기를 넘으면 자동으로 순환됩니다. 0으로 설정하면 로그 순환이 비활성화됩니다. |
| 192 |
.UNINDENT |
| 193 |
.INDENT 0.0 |
| 194 |
.TP |
| 195 |
.B \-\-max\-opds\-items |
| 196 |
OPDS 피드의 최대 책 수. 서버가 단일 OPDS 수집 피드에서 반환할 최대 책 수입니다. |
| 197 |
.UNINDENT |
| 198 |
.INDENT 0.0 |
| 199 |
.TP |
| 200 |
.B \-\-max\-opds\-ungrouped\-items |
| 201 |
OPDS 피드에서 그룹화되지 않은 항목의 최대 수. 저자/태그 같은 범주의 항목 수가 이 값보다 많으면 첫 글자 기준으로 그룹화합니다. 0으로 설정하면 비활성화됩니다. |
| 202 |
.UNINDENT |
| 203 |
.INDENT 0.0 |
| 204 |
.TP |
| 205 |
.B \-\-max\-request\-body\-size |
| 206 |
서버에 업로드할 수 있는 파일의 최대 크기(MB). |
| 207 |
.UNINDENT |
| 208 |
.INDENT 0.0 |
| 209 |
.TP |
| 210 |
.B \-\-num\-per\-page |
| 211 |
한 페이지에 표시할 책 수. 브라우저에서 한 페이지에 표시할 책 수입니다. |
| 212 |
.UNINDENT |
| 213 |
.INDENT 0.0 |
| 214 |
.TP |
| 215 |
.B \-\-pidfile |
| 216 |
프로세스 PID를 지정한 파일에 기록 |
| 217 |
.UNINDENT |
| 218 |
.INDENT 0.0 |
| 219 |
.TP |
| 220 |
.B \-\-port |
| 221 |
접속 대기용으로 사용할 서버측 포트 번호. |
| 222 |
.UNINDENT |
| 223 |
.INDENT 0.0 |
| 224 |
.TP |
| 225 |
.B \-\-search\-the\-net\-urls |
| 226 |
\fB\(dq\fP인터넷 검색\fB\(dq\fP 기능용 URL이 들어 있는 JSON 파일 경로입니다. 이런 파일을 만드는 가장 쉬운 방법은 calibre의 환경설정\-> 네트워크 공유\-> 인터넷 검색으로 가서 URL을 만든 뒤 내보내는 것입니다. |
| 227 |
.UNINDENT |
| 228 |
.INDENT 0.0 |
| 229 |
.TP |
| 230 |
.B \-\-shutdown\-timeout |
| 231 |
정상 종료를 기다리는 총 시간(초). |
| 232 |
.UNINDENT |
| 233 |
.INDENT 0.0 |
| 234 |
.TP |
| 235 |
.B \-\-ssl\-certfile |
| 236 |
SSL 인증서 파일 경로. |
| 237 |
.UNINDENT |
| 238 |
.INDENT 0.0 |
| 239 |
.TP |
| 240 |
.B \-\-ssl\-keyfile |
| 241 |
SSL 개인 키 파일 경로. |
| 242 |
.UNINDENT |
| 243 |
.INDENT 0.0 |
| 244 |
.TP |
| 245 |
.B \-\-timeout |
| 246 |
유휴 연결을 닫기까지의 시간(초). |
| 247 |
.UNINDENT |
| 248 |
.INDENT 0.0 |
| 249 |
.TP |
| 250 |
.B \-\-trusted\-ips |
| 251 |
특정 IP 주소의 인증되지 않은 연결에 변경 허용. 기본적으로 인증을 켜지 않으면 서버는 읽기 전용 모드로 동작하여 익명 사용자가 calibre 라이브러리를 변경하지 못하게 합니다. 이 옵션을 사용하면 지정한 IP 주소에서 연결하는 누구나 변경할 수 있습니다. 주소 또는 네트워크 규격의 쉼표로 구분된 목록이어야 합니다. 인증 없이 서버를 실행하면서도 calibredb로 calibre 라이브러리를 변경하려는 경우 유용합니다. 이 옵션을 켜면 지정한 IP 주소에서 연결하는 누구나 calibre 라이브러리를 변경할 수 있습니다. |
| 252 |
.UNINDENT |
| 253 |
.INDENT 0.0 |
| 254 |
.TP |
| 255 |
.B \-\-url\-prefix |
| 256 |
모든 URL 앞에 붙일 접두어. 이 서버를 리버스 프록시 뒤에서 실행하려는 경우 유용합니다. 예를 들어 URL 접두어로 /calibre를 사용하십시오. |
| 257 |
.UNINDENT |
| 258 |
.INDENT 0.0 |
| 259 |
.TP |
| 260 |
.B \-\-userdb |
| 261 |
인증에 사용할 사용자 데이터베이스 파일 경로입니다. 데이터베이스는 SQLite 파일입니다. 만들려면 :option: |
| 262 |
.nf |
| 263 |
\(ga |
| 264 |
.fi |
| 265 |
\-\-manage\-users\(ga을 사용하십시오. 사용자 관리에 대한 자세한 내용: \%<https://\:manual\:.calibre-ebook\:.com/\:ko/\:server\:.html#\:managing-user-accounts-from-the-command-line-only> |
| 266 |
.UNINDENT |
| 267 |
.INDENT 0.0 |
| 268 |
.TP |
| 269 |
.B \-\-version |
| 270 |
프로그램의 버전을 표시한 후 종료함 |
| 271 |
.UNINDENT |
| 272 |
.INDENT 0.0 |
| 273 |
.TP |
| 274 |
.B \-\-worker\-count |
| 275 |
요청 처리에 사용할 작업자 스레드 수. |
| 276 |
.UNINDENT |
| 277 |
.SH Author |
| 278 |
Kovid Goyal |
| 279 |
.SH Copyright |
| 280 |
Kovid Goyal |
| 281 |
.\" End of generated man page. |