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 [選 項 ] [書 庫 資 料 夾 的 路 徑 ...]

啟 動 calibre 內 容 伺 服 器 。 calibre 內 容 伺 服 器 透 過 網 路 公 開 您 的 calibre 書 庫 。 您 可 以 將 書 庫 資 料 夾 的 路 徑 指 定 為 :command: calibre-server 的 參 數 。 如 果 未 指 定 任 何 路 徑 ， calibre 主 程 式 所 知 道 的 所 有 部 件 都 將 被 使 用 。

每 当 向 具 有 它 们 自 己 空 间 的 :command:
`
calibre-server`传 递 参 数 时 ， 用 引 号 括 起 这 些 参 数 。 例 如 : "/some path/with spaces"

[選 項 ]

--access-log

访 问 日 志 文 件 的 路 径 。 此 日 志 包 含 有 关 连 接 到 服 务 器 并 发 出 请 求 的 客 户 端 的 信 息 。 默 认 情 况 下 ， 不 进 行 访 问 日 志 记 录 。

--ajax-timeout

在 查 询 时 等 待 服 务 器 响 应 的 时 间 (秒 ).

--auth-mode

選 擇 認 證 方 式 . 設 定 此 伺 服 器 的 HTTP驗 證 方 式 ， 如 果 你 將 此 伺 服 器 至 於 反 向 代 理 後 面 的 話 請 選 擇 " basic " ； 除 此 之 外 請 選 擇 " auto " 。

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