calibre-server - calibre-server
calibre-server [オプション] [ライブラリフォルダへのパス...]
calibreのコンテンツサーバを開始。コンテンツサーバはcalibreライブラリを
インターネット上に公開します。calibre-server
の引数としてライブラリフォルダへのパスを
指定することができます。pathの指定がない場合には、calibreプログラムの知っている
すべてのライブラリが対象となります。
スペースを含む引数を
calibre-server
に渡す場合には、クォーテーションマークでくくってください。例:
"/some path/with spaces"
- --access-log
- アクセスログファイルへのパス。このログにはクライアントからサーバへの接続や、要求についての情報が記録されます。デフォルトでは、アクセスログは記録しません。
- --auth-mode
- 使用する認証タイプ.
サーバが使用するHTTP認証モード。SSLプロキシを介してサーバを公開する場合には
"basic"
を設定してください。そうでない場合には
"auto"
にしてください。"auto"
は、SSLが設定されている場合には
"basic"
を使用し、それ以外の場合には
"digest"
を使用します。
- --auto-reload
- ソースコードが変更されたとき自動的にサーバの再読み込みを行います。デバッグ時に有用です。シャットダウンタイムアウトに小さい値を指定するのもよいでしょう。
- --ban-after
- 利用停止するまでのログイン失敗回数.
ログインに何回失敗したらIPアドレスを遮断するかを指定。
- --ban-for
- 連続してログインに失敗したIPアドレスを遮断.
繰り返しログインに失敗したIPアドレスを、指定した時間
(分単位)
だけ一時的に遮断します。ブルートフォース攻撃への対策として有効です。0
を設定すると、遮断しません。
- --book-list-mode
- デフォルトの本の一覧モードを選択.
新規ユーザ向けのデフォルトの本の一覧モードを設定します。個々のユーザは自分で設定することによりデフォルトのモードを上書きできます。初期設定ではカバーグリッドを使用します。
- --custom-list-template
- カスタムな本一覧モードのテンプレートを格納した
JSON
へのパス。このテンプレートを作成する最も簡単な方法は、calibreの
環境設定->ネット共有->本の一覧テンプレート
へ行ってテンプレートを作成し、エクスポートすることです。
- --displayed-fields
- 表示するユーザ定義フィールドを限定.
コンテンツサーバ /opds
および /mobile
ビューで表示させるユーザ定義の書誌フィールドを、カンマ区切りで指定。このオプションを指定したとき、リストにないフィールドは表示されなくなります。例:
my_rating,my_tags
- --enable-auth,
--disable-auth
- サーバアクセスにパスワード認証を使用.
通常、サーバへのアクセスには制限を設けず、誰にでもアクセスできるようになっています。このオプションを使うと、アクセスを事前に定義したユーザに限定することができます。
デフォルトでは、このオプションは無効に設定されています。
- --enable-local-write,
--disable-local-write
- 認証されていないローカルコネクションでの変更を許可.
通常、認証を有効にしていない場合には、匿名ユーザがcalibreライブラリに変更を加えることができないよう、サーバは読み取り専用モードで動作します。このオプションを有効にすると、サーバと同じコンピュータからの接続の場合には、誰でも変更を加えることができるようになります。認証なしでサーバを運用しながら、calibreライブラリを変更するのにcalibredbを利用する場合に便利です。
デフォルトでは、このオプションは無効に設定されています。
- --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
- サーバログファイルへのパス。このログにはサーバ情報とエラーが記録されますが、アクセスログは記録しません。デフォルトでは標準出力に出力されます。
- --manage-users
- このサーバへの接続が許可されているユーザのデータベースを管理します。--
を追加することで自動モードで使用できます。詳細については
calibre-server --manage-users -- help
を参照してください。また
--userdb
オプションも参照してください。
- --max-job-time
- ワーカープロセスの最大時間.
ワーカープロセスの実行を許可する最大時間
(分単位)。制限しない場合にはゼロを指定。
- --max-jobs
- ワーカープロセスの最大数.
ワーカープロセスは本の閲覧準備/追加/変換などの大きなジョブを扱うために、必要に応じて起動されます。通常、こうしたプロセスの最大数はCPUコア数に基づいて決定します。この設定では、そのプロセス最大数を制御できます。
- --max-log-size
- ログファイルの最大長
(MB単位).
サーバが精製するログファイルの最大サイズ。ログが指定のサイズを超えると、先頭から上書きされます。0を設定すると、上書きしなくなります。
- --search-the-net-urls
- 「インターネットで検索」で使用する、URLを記述したJSONファイルへのパス。環境設定->ネット共有->インターネットで検索
へ行き、URLを作成してエクスポートすると簡単にファイルを作成できます。
- --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
を参照してください。