「Radicale」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎参照: add TranslationStatus)
 
(同じ利用者による、間の4版が非表示)
11行目: 11行目:
 
== インストール ==
 
== インストール ==
   
{{Pkg|radicale}} パッケージを[[インストール]]してください
+
{{Pkg|radicale}} パッケージを[[インストール]]します
  +
  +
このパッケージは、[https://radicale.org/v3.html#running-as-a-service Radicale systemd の指示]に従って {{ic|radicale}} ユーザーとサービスを作成し、{{ic|/var/lib/radicale/collections}} データフォルダーを作成します。したがって、{{ic|radicale.service}} を[[有効化]]するだけで済みます。
   
 
== 設定 ==
 
== 設定 ==
   
  +
最も簡単な方法は、[https://radicale.org/v3.html Radicale] のウェブサイトの指示に従うことです。
メインの設定ファイルは {{ic|/etc/radicale/config}} です。
 
  +
  +
メインの設定ファイルは {{ic|/etc/radicale/config}} にあります。
  +
  +
これがリモートやヘッドレスシステムに設定されている場合、組み込みのウェブインターフェイスへのリモートアクセスを有効にするために {{ic|hosts}} オプションを追加することを検討してください。
   
ほとんどの設定オプションはコマンドラインから変更することができます:
+
多くの設定オプションはコマンドライン変更できます:
   
 
$ radicale --help
 
$ radicale --help
   
=== 統合 ===
+
=== 認証 ===
   
  +
デフォルトでは、'''誰でも'''ウェブインターフェイスにアクセスしてアドレス帳やカレンダーを作成できるため、認証を考慮する必要があります。
Radicale は Apache などの mod_wgsi インターフェイスをサポートしている HTTP ウェブサーバーと統合することができます。Radicale のオプションのいくつかが無視されます: [server] セクションの hosts, daemon, pid, ssl, certificate, key, protocol, ciphers keys の設定。Python のパスに radicale モジュールをインストールして (ドキュメントルートに) .wgsi ファイルを書いてください:
 
   
  +
認証は {{ic|/etc/radicale/users}} で制御されており、Apache httpasswd 形式のパスワード(プレーンテキストや他のオプションも利用可能)を使用できます。[[Apache HTTP Server]] をインストールする予定がない場合は、オンラインの htpasswd ジェネレーターを使用して {{ic|user:password}} ハッシュを生成するだけで構いません。
{{bc|1=
 
# import radicale
 
# radicale.log.start()
 
# application = radicale.Application()}}
 
   
  +
=== デフォルト以外のストレージ場所 ===
そして radicale のバーチャルホストを設定します。例:
 
   
  +
デフォルトでは、Radicale パッケージはデータを {{ic|/var/lib/radicale/collections}} に保存するように設定されています。これを変更したい場合は、設定ファイルで別の場所を指定できますが、同時に [[systemd]] 設定も調整する必要があります。含まれている {{ic|radicale.service}} ファイルは {{ic|1=ProtectSystem=strict}} を設定しており、これは [[systemd]] が {{ic|/var/lib/radicale/}} の外側の領域へのサービスの読み書きアクセスを許可しないことを意味します。これを回避するには、次の内容で [[ドロップインファイル]] を作成します:
{{bc|1=
 
<VirtualHost *:80>
 
ServerName cal.yourdomain.org
 
   
  +
{{hc|/etc/systemd/system/radicale.service.d/override.conf|2=
WSGIDaemonProcess radicale user=http group=http threads=1
 
  +
[Service]
WSGIScriptAlias / /srv/http/radicale.wsgi
 
  +
ReadWritePaths=/path/to/storage
  +
}}
   
  +
次に、Radicale に設定ファイルを編集して選択した場所を使用するよう指示できます。詳細は [https://radicale.org/v3.html#storage Radicale ドキュメント] に従ってください。
<Directory /var/www>
 
  +
WSGIProcessGroup radicale
 
  +
{{hc|/etc/radicale/config|2=
WSGIApplicationGroup %{GLOBAL}
 
  +
[storage]
AllowOverride None
 
  +
filesystem_folder = /path/to/storage
Order allow,deny
 
  +
}}
allow from all
 
  +
</Directory>
 
  +
両方のファイルで {{ic|/path/to/storage}} を選択した場所に変更します。
</VirtualHost>}}
 
  +
  +
== 統合 ==
  +
  +
=== メールサーバー ===
  +
  +
もしメールサーバーを運用している場合、{{AUR|radicale-imap-git}} や {{AUR|radicale-dovecot-auth}} の IMAP 認証プラグインが役立つかもしれません。''radicale-dovecot-auth'' を UNIX ソケットで使用する場合、次の内容で {{ic|radicale.service}} の[[ドロップインファイル]]を作成します:
  +
  +
[Service]
  +
RestrictAddressFamilies=
  +
RestrictAddressFamilies=~AF_PACKET AF_NETLINK
  +
  +
これにより、プロセスが {{ic|AF_UNIX}} ソケットを開くことができます。
  +
  +
=== ウェブサーバー ===
  +
  +
Radicale は独自のウェブサーバーを提供しており(最初は {{ic|localhost}} のみに制限され、任意のユーザー名とパスワードで {{ic|localhost:5232}} にアクセス可能)、[[Apache HTTP Server]] などの HTTP ウェブサーバーとリバースプロキシや WSGI インターフェースを介して統合することができます。
   
 
== クライアントのサポート ==
 
== クライアントのサポート ==
68行目: 87行目:
 
== 参照 ==
 
== 参照 ==
 
* [http://radicale.org/ プロジェクトウェブサイト]
 
* [http://radicale.org/ プロジェクトウェブサイト]
  +
  +
{{TranslationStatus|Radicale|2024-08-22|810650}}

2024年8月22日 (木) 18:39時点における最新版

関連記事

Radicale は CalDav と CardDav プロトコルに対応するサーバーです。最低でも Python 3.3 が必要です。

インストール

radicale パッケージをインストールします。

このパッケージは、Radicale systemd の指示に従って radicale ユーザーとサービスを作成し、/var/lib/radicale/collections データフォルダーを作成します。したがって、radicale.service有効化するだけで済みます。

設定

最も簡単な方法は、Radicale のウェブサイトの指示に従うことです。

メインの設定ファイルは /etc/radicale/config にあります。

これがリモートやヘッドレスシステムに設定されている場合、組み込みのウェブインターフェイスへのリモートアクセスを有効にするために hosts オプションを追加することを検討してください。

多くの設定オプションはコマンドラインで変更できます:

$ radicale --help

認証

デフォルトでは、誰でもウェブインターフェイスにアクセスしてアドレス帳やカレンダーを作成できるため、認証を考慮する必要があります。

認証は /etc/radicale/users で制御されており、Apache httpasswd 形式のパスワード(プレーンテキストや他のオプションも利用可能)を使用できます。Apache HTTP Server をインストールする予定がない場合は、オンラインの htpasswd ジェネレーターを使用して user:password ハッシュを生成するだけで構いません。

デフォルト以外のストレージ場所

デフォルトでは、Radicale パッケージはデータを /var/lib/radicale/collections に保存するように設定されています。これを変更したい場合は、設定ファイルで別の場所を指定できますが、同時に systemd 設定も調整する必要があります。含まれている radicale.service ファイルは ProtectSystem=strict を設定しており、これは systemd/var/lib/radicale/ の外側の領域へのサービスの読み書きアクセスを許可しないことを意味します。これを回避するには、次の内容で ドロップインファイル を作成します:

/etc/systemd/system/radicale.service.d/override.conf
[Service]
ReadWritePaths=/path/to/storage

次に、Radicale に設定ファイルを編集して選択した場所を使用するよう指示できます。詳細は Radicale ドキュメント に従ってください。

/etc/radicale/config
[storage]
filesystem_folder = /path/to/storage

両方のファイルで /path/to/storage を選択した場所に変更します。

統合

メールサーバー

もしメールサーバーを運用している場合、radicale-imap-gitAURradicale-dovecot-authAUR の IMAP 認証プラグインが役立つかもしれません。radicale-dovecot-auth を UNIX ソケットで使用する場合、次の内容で radicale.serviceドロップインファイルを作成します:

[Service]
RestrictAddressFamilies=
RestrictAddressFamilies=~AF_PACKET AF_NETLINK

これにより、プロセスが AF_UNIX ソケットを開くことができます。

ウェブサーバー

Radicale は独自のウェブサーバーを提供しており(最初は localhost のみに制限され、任意のユーザー名とパスワードで localhost:5232 にアクセス可能)、Apache HTTP Server などの HTTP ウェブサーバーとリバースプロキシや WSGI インターフェースを介して統合することができます。

クライアントのサポート

Radicale は CalDav と CardDav プロトコルを使用しているため、ほとんどのクライアントに対応しています。特に、公式にサポートされているクライアント

以下のリストは、正確でない可能性があります:

  • Thunderbird
    • カレンダーを追加するには、カレンダー表示で「新しいカレンダー」をクリックし -> ネットワーク上で、ロケーションフィールドに radicale がリッスンしているルートアドレス、例えば http://localhost:5232 を追加します。単一のカレンダーのアドレスではなく、Thunderbird は radicale が共有するすべてのカレンダーを自動的に検出します。
  • GNOME/Evolution, Contacts と Calendar
  • KOrganizer (korganizer)
  • InfCloud (infcloudAUR), CalDavZAP, CardDavMATE
  • syncEvolution (syncevolutionAUR)
  • DAVx⁵, Infomaniak kSync, Simple Contacts Pro SE for Android (ICSx⁵ は単一のカレンダーには対応しますが、radicale が公開するすべてのカレンダーとアドレス帳を自動的に検出するためには DAVx⁵ が強く推奨されます)。
  • Mac OSX Calendar/Contacts
  • Apple iOS
    • iOS では CalDAV/CarDAV を同期するために SSL が必要であることに注意してください (iOS14 時点では自己署名 SSL で Radicale をアカウントとして統合することが可能です) [1]。自己署名 SSL を作成する手順は、OpenSSL#Generate a self-signed certificate with private key in a single command の指示に従ってください。
      • また、鍵サイズは 2048 ビット以上である必要があることにも注意してください [2]

参照

翻訳ステータス: このページは en:Radicale の翻訳バージョンです。最後の翻訳日は 2024-08-22 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。