CALIBRE-SERVER(1)

NAME
calibre-server - calibre-server

            calibre-server [オプション] [ライブラリフォルダへのパス...]

calibreのコンテンツサーバを開始。コンテンツサーバはcalibreライブラリを インターネット上に公開します。calibre-server の引数としてライブラリフォルダへのパスを 指定することができます。pathの指定がない場合には、calibreプログラムの知っている すべてのライブラリが対象となります。

スペースを含む引数を calibre-server に渡す場合には、クォーテーションマークでくくってください。例: "/some path/with spaces"

[オプション]

    --access-log
        アクセスログファイルへのパス。このログにはクライアントからサーバへの接続や、要求についての情報が記録されます。デフォルトでは、アクセスログは記録しません。

    --ajax-timeout
        クエリ実行時にサーバからの応答を待つ最大時間 (秒指定).

    --auth-mode
        使用する認証タイプ. サーバが使用するHTTP認証モード。SSLプロキシを介してサーバを公開する場合には "basic" を設定してください。そうでない場合には "auto" にしてください。"auto" は、SSLが設定されている場合には "basic" を使用し、それ以外の場合には "digest" を使用します。

    --auto-reload
        ソースコードが変更されたとき自動的にサーバの再読み込みを行います。デバッグ時に有用です。シャットダウンタイムアウトに小さい値を指定するのもよいでしょう。

    --ban-after
        利用停止するまでのログイン失敗回数. ログインに何回失敗したらIPアドレスを遮断するかを指定。

    --ban-for
        連続してログインに失敗したIPアドレスを遮断. 繰り返しログインに失敗したIPアドレスを、指定した時間 (分単位) だけ一時的に遮断します。ブルートフォース攻撃への対策として有効です。0 を設定すると、遮断しません。

    --book-list-mode
        デフォルトの本の一覧モードを選択. 新規ユーザ向けのデフォルトの本の一覧モードを設定します。個々のユーザは自分で設定することによりデフォルトのモードを上書きできます。初期設定ではカバーグリッドを使用します。

    --compress-min-size
        応答がデータ圧縮を使用する最小サイズ (バイト単位).

    --custom-list-template
        カスタムな本一覧モードのテンプレートを格納した JSON へのパス。このテンプレートを作成する最も簡単な方法は、calibreの 環境設定->ネット共有->本の一覧テンプレート へ行ってテンプレートを作成し、エクスポートすることです。

    --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ライブラリに変更を加えることができるようになることに注意してください。特に、Firefoxウェブブラウザでは、任意のウェブサイトからの変更も許可されます。 デフォルトでは、このオプションは無効に設定されています。

    --enable-log-not-found, --disable-log-not-found
        HTTP 404 (Not Found) 要求をログに保存. 通常、サーバはリソースが見つからなかったときのHTTP要求をログ保存します。しかしBOTの標的にされた場合には、ログがスパムであふれることになります。ログを止めるためにこのオプションを利用してください。 デフォルトでは、このオプションは有効に設定されています。

    --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
        接続を待ち受けするインタフェース. デフォルトでは、利用可能なすべての IPv6 および IPv4 インターフェースでリッスンします。これを変更することで、たとえば "127.0.0.1" に指定してローカルマシンからの IPv4 接続のみをリッスンしたり、 "0.0.0.0" に指定してすべてのIPv4 着信接続をリッスンしたりできます。

    --log
        サーバログファイルへのパス。このログにはサーバ情報とエラーが記録されますが、アクセスログは記録しません。デフォルトでは標準出力に出力されます。

    --manage-users
        このサーバへの接続が許可されているユーザのデータベースを管理します。-- を追加することで自動モードで使用できます。詳細については calibre-server --manage-users -- help を参照してください。また --userdb オプションも参照してください。

    --max-header-line-size
        単一のHTTPヘッダの最大サイズ (KB単位).

    --max-job-time
        ワーカープロセスの最大時間. ワーカープロセスの実行を許可する最大時間 (分単位)。制限しない場合にはゼロを指定。

    --max-jobs
        ワーカープロセスの最大数. ワーカープロセスは本の閲覧準備/追加/変換などの大きなジョブを扱うために、必要に応じて起動されます。通常、こうしたプロセスの最大数はCPUコア数に基づいて決定します。この設定では、そのプロセス最大数を制御できます。

    --max-log-size
        ログファイルの最大長 (MB単位). サーバが精製するログファイルの最大サイズ。ログが指定のサイズを超えると、先頭から上書きされます。0を設定すると、上書きしなくなります。

    --max-opds-items
        OPDSフィード中の最大冊数. サーバが単一のOPDSフィード内に返す本の最大数

    --max-opds-ungrouped-items
        OPDS フィード内のグループ化されていない項目の最大数. 著者やタグなどのカテゴリの1文字目の数がここで指定した数を超えた場合にグループ化します。0を指定するとグループ化しません。

    --max-request-body-size
        サーバへのアップロードを許可する最大サイズ (MB単位).

    --num-per-page
        1ページあたりに表示する本の数. ブラウザ1ページあたりに表示する本の数

    --pidfile
        プロセスPIDを書き込むファイルを指定

    --port
        コネクションの接続待ち用ポート.

    --search-the-net-urls
        「インターネットで検索」で使用する、URLを記述したJSONファイルへのパス。環境設定->ネット共有->インターネットで検索 へ行き、URLを作成してエクスポートすると簡単にファイルを作成できます。

    --shutdown-timeout
        クリーンシャットダウンを行う前の待ち時間 (秒単位).

    --ssl-certfile
        SSL 認証ファイルへのパス.

    --ssl-keyfile
        SSL プライベートキーファイルへのパス.

    --timeout
        アイドルな接続を切断するまでの時間 (秒単位).

    --trusted-ips
        指定したIPからの非認証接続での変更を許可. 通常、認証を有効にしない場合にはサーバは読み取り専用モードで動作し、匿名ユーザがキャリバーライブラリに変更を加えることを許可しません。このオプションを使用すると、指定した IP アドレスから接続しているすべてのユーザに変更を許可します。TRUSTED_IP はアドレスまたはネットワークをカンマ区切りで指定します。認証なし実行しているサーバ上で calibredb を使用して calibre ライブラリに変更を加えたい場合に使える機能です。このオプションを有効にした場合には、指定した IP アドレスから接続するユーザは誰でもライブラリに変更を加えることができることに注意してください。

    --url-prefix
        すべてのURLに追加するプレフィックス. リバースプロキシをはさんでサーバを運用する場合に有用です。使用例: URLプレフィックスとして /calibre

    --userdb
        認証に使用するユーザデータベースへのパス。データベースは SQLite ファイルです。データベース作成には:option:
        `
        --manage-users`を使用します。ユーザ管理についての詳細は <https://manual.calibre-ebook.com/ja/server.html#managing-user-accounts-from-the-command-line-only> を参照してください。

    --version
        プログラムのバージョン番号を表示して終了

    --worker-count
        要求を処理するワーカースレッド数.

Author
Kovid Goyal

Copyright
Kovid Goyal