Man page - calibre-server(1)

Packages contains this manual

Available languages:

en fr mr pt_BR is es kn it ca pl vi nb sl lv pt eo ms ko fa eu et nl ar da cs gl tr zh_HK sk hu bg sv hr ja he lt uk fi ru ro zh_TW sr ka el zh_CN de

Manual

CALIBRE-SERVER

NAME
[選 項 ]
AUTHOR
COPYRIGHT

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