NAME

       calibre-server - calibre-server

          calibre-server [选项] [库文件夹的路径...]

       启动caliber内容服务器。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地址的访
              问。有助于防止猜测密码的尝试。如果设置为零则不禁止。

       --book-list-mode
              选择默认的书籍列表显示模式.      设置默认的书籍显示模式. 每一名用户都可以单独重新设
              置此选项. The default is to use a cover grid.

       --compress-min-size
              响应使用数据压缩的最小尺寸(字节).

       --custom-list-template
              包含自定义图书列表模式的JSON模板文件的路径。创建这种模板文件的最简单方法是
              在caliber中转到首选项->通过网络分享->书籍列表模板，创建模板并导出它。

       --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 库进行更改。 默认情况下, 此选项是
              禁用的。

       --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
              侦听连接的界面.    The default  is  to  listen  on  all  available  IPv6  and  IPv4
              interfaces.  You  can  change  this to, for example, "127.0.0.1" to only listen for
              IPv4 connections from the local machine, or to "0.0.0.0" to listen to all  incoming
              IPv4 connections.

       --log  服务器日志的日志文件路径。此日志包含服务器信息和错误，而不是访问日志。默认情况
              下，它被写入标准输出(stdout)。

       --manage-users
              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-header-line-size
              单个 HTTP 标头的最大尺寸（KB）.

       --max-job-time
              作业单元进程的最大时间.        允许作业单元进程运行的最大时间量(分钟)。设为零则无限
              制。

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

       --max-log-size
              日志文件最大大小（MB）.        由服务器生成的日志文件的最大容量。当日志变得大于这个
              容量时，它将自动旋转。设置为零时禁用日志旋转。

       --max-opds-items
              OPDS供稿的最大书目数.       服务器将在单个OPDS采集原料中返回的最大图书数量。

       --max-opds-ungrouped-items
              在OPDS源中未分组项目的最大项目数.         当有超过这个设定数量的项目时将以如作者/标
              签的首字母对类别进行分组。设置为零以禁用。

       --max-request-body-size
              服务器允许上传的最大文件大小（MB）.

       --num-per-page
              在一页中显示的图书数量.        浏览器中单个页面显示的图书数量。

       --pidfile
              將程序 PID 寫入指定的檔案

       --port 侦听连接的端口.

       --search-the-net-urls
              包含“搜索Internet”功能的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的一个前缀.       如果希望在逆向代理后面运行此服务器，则非常有用。例如使
              用, /calibre 作为URL前缀。

       --userdb
              用于身份验证的用户数据库路径。数据库是SQLite文件。使用:option:
              `
              --manage-users`创建它。您可以阅读以下更多关于管理用户的信息：‐
              https://manual.calibre-ebook.com/server.html#managing-user-accounts-from-the-command-line-only

       --version
              顯示程式版本編號並退出

       --worker-count
              用于处理请求的作业单元线程数.

AUTHOR

       Kovid Goyal

COPYRIGHT

       Kovid Goyal