Scroll to navigation

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

NAME

calibre-server - calibre-server

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


Start the calibre Content server. The calibre Content server exposes your calibre libraries over the internet. You can specify the path to the library folders as arguments to calibre-server. If you do not specify any paths, all the libraries that the main calibre program knows about will be used.

Whenever you pass arguments to calibre-server that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"

[選項]

Path to the access log file. This log contains information about clients connecting to the server and making requests. By default no access logging is done.

Time (in seconds) to wait for a response from the server when making queries.

Choose the type of authentication used. 設定此伺服器的HTTP驗證方式,如果你將此伺服器至於反向代理後面的話請選擇"basic";除此之外請選擇"auto"

Automatically reload server when source code changes. Useful for development. You should also specify a small value for the shutdown timeout.

Number of login failures for ban. The number of login failures after which an IP address is banned

Ban IP addresses that have repeated login failures. Temporarily bans access for IP addresses that have repeated login failures for the specified number of minutes. Useful to prevent attempts at guessing passwords. If set to zero, no banning is done.

Choose the default book list mode. Set the default book list mode that will be used for new users. Individual users can override the default in their own settings. The default is to use a cover grid.

Minimum size for which responses use data compression (in bytes).

Path to a JSON file containing a template for the custom book list mode. The easiest way to create such a template file is to go to Preferences-> Sharing over the net-> Book list template in calibre, create the template and export it.

Run process in background as a daemon (Linux only).

Restrict displayed user-defined fields. Comma separated list of user-defined metadata fields that will be displayed by the Content server in the /opds and /mobile views. If you specify this option, any fields not in this list will not be displayed. For example: my_rating,my_tags

Socket pre-allocation, for example, with systemd socket activation. By default, this option is enabled.

Password based authentication to access the server. Normally, the server is unrestricted, allowing anyone to access it. You can restrict access to predefined users with this option. By default, this option is disabled.

Fallback to auto-detected interface. If for some reason the server is unable to bind to the interface specified in the listen_on option, then it will try to detect an interface that connects to the outside world and bind to that. By default, this option is enabled.

Allow un-authenticated local connections to make changes. Normally, if you do not turn on authentication, the server operates in read-only mode, so as to not allow anonymous users to make changes to your calibre libraries. This option allows anybody connecting from the same computer as the server is running on to make changes. This is useful if you want to run the server without authentication but still use calibredb to make changes to your calibre libraries. Note that turning on this option means any program running on the computer can make changes to your calibre libraries. By default, this option is disabled.

Log HTTP 404 (Not Found) requests. Normally, the server logs all HTTP requests for resources that are not found. This can generate a lot of log spam, if your server is targeted by bots. Use this option to turn it off. By default, this option is enabled.

Advertise OPDS feeds via BonJour. Advertise the OPDS feeds via the BonJour service, so that OPDS based reading apps can detect and connect to the server automatically. By default, this option is enabled.

Zero copy file transfers for increased performance. 當透過網路傳送檔案時這將在核心傳輸中使用零複製,從而提高效能。然而,它可能導致損壞的檔案傳輸在一些崩潰的檔案系統上。如果您經歷了損壞的檔案傳輸,關掉它。 By default, this option is enabled.

顯示說明訊息並退出

Ignored user-defined metadata fields. Comma separated list of user-defined metadata fields that will not be displayed by the Content server in the /opds and /mobile views. For example: my_rating,my_tags

The interface on which to listen for connections. The default is to listen on all available IPv4 interfaces. You can change this to, for example, "127.0.0.1" to only listen for connections from the local machine, or to "::" to listen to all incoming IPv6 and IPv4 connections.

Path to log file for server log. This log contains server information and errors, not access logs. By default it is written to stdout.

Manage the database of users allowed to connect to this server. You can use it in automated mode by adding a --. See calibre-server --manage-users -- help for details. See also the --userdb option.

Max. size of single HTTP header (in KB).

Maximum time for worker processes. Maximum amount of time worker processes are allowed to run (in minutes). Set to zero for no limit.

Maximum number of worker processes. 對於大型作業任務設定執行作業單元的處理程序數是必需和有用的,如準備一本書供預覽、加入書籍、轉換等。通常,此類處理程序的最大數量基於 CPU 核心的數量。您可以透過這個設定來控制它。

Max. log file size (in MB). The maximum size of log files, generated by the server. When the log becomes larger than this size, it is automatically rotated. Set to zero to disable log rotation.

Maximum number of books in OPDS feeds. The maximum number of books that the server will return in a single OPDS acquisition feed.

Maximum number of ungrouped items in OPDS feeds. Group items in categories such as author/tags by first letter when there are more than this number of items. Set to zero to disable.

Max. allowed size for files uploaded to the server (in MB).

Number of books to show in a single page. The number of books to show in a single page in the browser.

將程序 PID 寫入指定的檔案

The port on which to listen for connections.

Path to a JSON file containing URLs for the "Search the internet" feature. The easiest way to create such a file is to go to Preferences-> Sharing over the net->Search the internet in calibre, create the URLs and export them.

Total time in seconds to wait for clean shutdown.

SSL證書檔案路徑.

SSL私鑰檔案路徑.

Time (in seconds) after which an idle connection is closed.

Allow un-authenticated connections from specific IP addresses to make changes. Normally, if you do not turn on authentication, the server operates in read-only mode, so as to not allow anonymous users to make changes to your calibre libraries. This option allows anybody connecting from the specified IP addresses to make changes. Must be a comma separated list of address or network specifications. This is useful if you want to run the server without authentication but still use calibredb to make changes to your calibre libraries. Note that turning on this option means anyone connecting from the specified IP addresses can make changes to your calibre libraries.

A prefix to prepend to all URLs. Useful if you wish to run this server behind a reverse proxy. For example use, /calibre as the URL prefix.

Path to the user database to use for authentication. The database is a SQLite file. To create it use --manage-users. You can read more about managing users at: https://manual.calibre-ebook.com/server.html#managing-user-accounts-from-the-command-line-only

顯示程式版本編號並退出

Number of worker threads used to process requests.

AUTHOR

Kovid Goyal

COPYRIGHT

Kovid Goyal

9月 24, 2021 5.28.0