Debian Codegraph @

man-pages/ko/man1/calibre-server.1

raw
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.