「Ente サーバー」の版間の差分
Kusanaginoturugi (トーク | 投稿記録) (→Running ente-server: 翻訳) |
Kusanaginoturugi (トーク | 投稿記録) |
||
114行目: | 114行目: | ||
{{ic|ente-server.service}} を[[有効化/起動]]します。 |
{{ic|ente-server.service}} を[[有効化/起動]]します。 |
||
− | === |
+ | === Nginx プロキシの設定 === |
+ | サンプルの [[Nginx]] 設定ファイルとそれに付随する HTTP(S) セキュリティヘッダーファイルを、[[Nginx]] の設定ディレクトリにコピーします: |
||
− | Copy the example [[Nginx]] config and the accompanying HTTP(S) security header config files to the [[Nginx]] configuration directory: |
||
# cp -v /usr/lib/ente-server/ente-server-nginx.conf /etc/nginx/ |
# cp -v /usr/lib/ente-server/ente-server-nginx.conf /etc/nginx/ |
||
# cp -v /usr/lib/ente-server/http*security_headers.conf /etc/nginx/ |
# cp -v /usr/lib/ente-server/http*security_headers.conf /etc/nginx/ |
||
+ | このサンプル設定ファイルを編集し、''your_public_domain.tld'' を実際のパブリックドメイン名に置き換えてください。 |
||
− | Edit this example config, and replace ''your_public_domain.tld'' with your actual public domain name |
||
+ | Let's Encrypt の証明書 (または他のプロバイダーからの SSL 証明書) がまだない場合はリクエストしてください: |
||
− | Request a letsencrypt ceritifacte (or a SSL certificate from another provider) if not already done so: |
||
# certbot certonly --email ''your_email'' --agree-tos --preferred-challenge http --webroot -w /var/lib/letsencrypt -d ''your_public_domain.tld'' |
# certbot certonly --email ''your_email'' --agree-tos --preferred-challenge http --webroot -w /var/lib/letsencrypt -d ''your_public_domain.tld'' |
||
− | + | ''ente-server'' 設定を含む {{ic|include}} ステートメントを [[Nginx]] の {{ic|http}} 構成ファイルに追加します: |
|
{{hc|/etc/nginx/nginx.conf| |
{{hc|/etc/nginx/nginx.conf| |
||
135行目: | 135行目: | ||
}} |
}} |
||
+ | パーミッションを修正します: |
||
− | Fix permissions: |
||
# chmod 644 /etc/nginx/ente-server-nginx.conf |
# chmod 644 /etc/nginx/ente-server-nginx.conf |
||
# chmod 644 /etc/nginx/http*security_headers.conf |
# chmod 644 /etc/nginx/http*security_headers.conf |
||
− | + | 変更を反映させるために {{ic|nginx.service}} を[[再起動]]します。 |
|
=== Configuring ente-server and ente-cli === |
=== Configuring ente-server and ente-cli === |
2024年5月6日 (月) 20:05時点における版
関連記事
Ente サーバー は、Ente (モバイル) クライアントに暗号化されたデータの塊を保存・提供するサーバー部分です。クライアントは暗号化されたデータを送受信し、それが Ente サーバーに届き、ローカルの MinIO オブジェクト ストレージ サービスを通じて保存・読み取りが行われます。
例えば、Ente フォト クライアントを使用すると、クライアントは写真を暗号化し、それらはサーバーに保存されます。後に、クライアントは暗号化された写真を検索し、ローカルで復号できます (エンドツーエンド暗号化)。クライアント、もしくはクライアントが写真を共有した相手のみが暗号鍵を持っているため、データを復号して実際に写真を見ることができるのはその人たちだけであり、サーバーはその鍵の情報を持っていないため見ることができません。
目次
インストール
ente-server-gitAUR パッケージは、デフォルトで提供される Docker 化された Ente サーバーとは異なり、セルフホスティング用に設計されています。Docker 化またはホスティングソリューションが必要な場合は、ente.io を参照してください。
まず、ente-server-gitAUR パッケージをインストールしてください。
セルフホストのサーバー スペースは容量が限られていることが多いため、ente-server-gitAUR パッケージは、古くてリンクされていない Ente サーバー MinIO オブジェクトをより迅速にクリーンアップするように変更されています。デフォルトの Ente サーバーは通常 45 日ごとにオブジェクトをクリーンアップしますが、このパッケージではその期間が 5 分ごとに短縮されています。
Ente サーバーを稼働させるには、PostgreSQL データベース (Ente オブジェクトのメタデータやユーザーデータの保存用) と MinIO バケット (暗号化されたオブジェクトデータの保存用) が必要です。また、Ente サーバーにアクセスするための HTTPS プロキシとして Nginx の使用が推奨されます。最後に、ente-cli ツールを使うと、Ente サーバーのアカウントの容量制限や有効期限の更新が簡単に行えます。
これらの必要なコンポーネントをインストールするには、オプションの依存関係としてリストされているパッケージをインストールすることが推奨されます。同じホストにインストールする場合は、依存パッケージとしてインストールするのが望ましいです。例えば、これらのパッケージをインストールする際、pacman の場合は --asdeps
オプションを使用し、または yayAUR でインストールすることができます。
参考までに、以下のパッケージがオプションの依存関係としてリストされています。
minio
minio-client
nginx
postgresql
設定
MinIO のセットアップ
設定ファイルを以下のように編集してください:
/etc/minio/minio.conf
MINIO_VOLUMES="/srv/minio/data" MINIO_ROOT_USER=minio MINIO_ROOT_PASSWORD='YOUR-STRONG-MINIO-ROOT-PASSWORD' MINIO_OPTS="--address your_public_domain.tld:3200 --console-address 127.0.0.1:3201"
minio.service
を有効化/起動します。
mcli コマンドを使って (minio ユーザーとして) MinIO ente-server バケットを作成します:
# cd /srv/minio/data [minio]$ mcli mb -p ente-server
PostgreSQL のセットアップ
postgres ユーザーとしてデータベースを初期化します:
[postgres]$ initdb --locale en_US.UTF-8 -D '/var/lib/postgres/data' --data-checksums --auth=scram-sha-256 --pwprompt
AF_UNIX ソケットのみに接続するように設定してください:
/var/lib/postgres/data/postgresql.conf
listen_addresses = '' # AF_UNIX Socket only
postgresql.service
を編集して、PostgreSQL ユーザーまたはグループにソケットアクセスを制限します:
/etc/systemd/system/postgresql.d/socket-access-restriction.conf
[Service] RuntimeDirectoryMode=750
ente
を postgres
ユーザーグループ に追加し、postgresql.service
を有効化/起動します。
PostgreSQL データベースユーザーと、このユーザーが所有するデータベースを作成します (新しいパスワードを 2 回入力し、次に新しいアカウントを保存するために postgres パスワードを指定します):
[postgres]$ createuser -P ente
次に、新しいデータベースを作成するために postgres パスワードを指定します:
[postgres]$ createdb -T template0 -O ente -E unicode ente-server
ente-server の起動
MinIO バケットの詳細を追加します:
/etc/ente-server/local.yaml
b2-eu-cen: key: minio secret: "YOUR-STRONG-MINIO-ROOT-PASSWORD" endpoint: your_public_domain.tld:3200 region: eu-central-2 bucket: ente-server
PostgreSQL の詳細を追加します:
/etc/ente-server/local.yaml
db: host: /run/postgresql port: 5432 name: ente-server user: ente password: "YOUR-STRONG-ENTE-DATABASE-USER-PASSWORD"
ente-server-gen-random-keys コマンドを使って新しい秘密鍵を生成し、/etc/ente-server/local.yaml
設定ファイルのデフォルト値の代わりにこれらの値を使用してください。
your_public_domain.tld の IP アドレスにアクセスできるように ente-server.service
を編集します (デフォルトでは、サービスは localhost からのアクセスのみを許可しています):
[Service] IPAddressAllow=IP_address_of_your_public_domain.tld
ente-server.service
を有効化/起動します。
Nginx プロキシの設定
サンプルの Nginx 設定ファイルとそれに付随する HTTP(S) セキュリティヘッダーファイルを、Nginx の設定ディレクトリにコピーします:
# cp -v /usr/lib/ente-server/ente-server-nginx.conf /etc/nginx/ # cp -v /usr/lib/ente-server/http*security_headers.conf /etc/nginx/
このサンプル設定ファイルを編集し、your_public_domain.tld を実際のパブリックドメイン名に置き換えてください。
Let's Encrypt の証明書 (または他のプロバイダーからの SSL 証明書) がまだない場合はリクエストしてください:
# certbot certonly --email your_email --agree-tos --preferred-challenge http --webroot -w /var/lib/letsencrypt -d your_public_domain.tld
ente-server 設定を含む include
ステートメントを Nginx の http
構成ファイルに追加します:
/etc/nginx/nginx.conf
http { include /etc/nginx/ente-server-nginx.conf }
パーミッションを修正します:
# chmod 644 /etc/nginx/ente-server-nginx.conf # chmod 644 /etc/nginx/http*security_headers.conf
変更を反映させるために nginx.service
を再起動します。
Configuring ente-server and ente-cli
- Install
ente-cli
on the client:- Install the ente-cli-binAUR package
- Add
ente-cli
config on the client:
$ mkdir -p ~/.ente/export
~/.ente/config.yaml
endpoint: api: "https://your_public_domain.tld" >
- Add a user account via the photos mobile app or web app on the client, using a custom endpoint:
- In the photos mobile app:
- Click 7 times on the main screen to enable developers mode
- Define your custom Ente server API endpoint:
- In the photos mobile app:
URL: https://your_public_domain.tld
- In the web app on the client:
$ git clone https://github.com/ente-io/ente.git cd ente/web git submodule update --init --recursive yarn install NEXT_PUBLIC_ENTE_ENDPOINTテンプレート:=https://your_public_domain.tld yarn dev:photos
- Follow the photos app or web app (http://localhost:3000) instructions to create a new user
- Obtain the OTP code:
- Via email:
- Configure the
smtp
section in/etc/ente-server/local.yaml
- Make sure the configure SMTP server is working
- Wait for the mail to arrive and copy the OTP code
- Configure the
- Via the ente-server log:
# journalctl -u ente-server | grep SendEmailOTT | tail -n 1
- Via email:
- Obtain the new users account ID:
# psql -U ente ente-server -c 'select user_id from users order by user_id desc limit 1;'
- Configure this user as the admin:
/etc/ente-server/local.yaml
internal: admin: [ADD_USER_ID_HERE]
- Restart
ente-server.service
to activate the new admin privileges - Configure this admin within
ente-cli
on the client:
$ ente account add photos ~/.ente/export email_address_of_admin_account password_of_admin_account
Increasing user storage and account expiry limit
- Use ente-cli to increase storage limit with 100 TB and expiry with 100 years:
ente admin update-subscription -u "user@domain.tld"
(Optional) Copy and apply AppArmor profile
An AppArmor profile has been provided for those that wish to limit the access the ente-server binary has using AppArmor. Copy and apply this profile as follows (assuming that AppArmor has already been installed and enabled):
# install -Dvm600 -o root -g root /usr/lib/ente-server/usr.bin.ente-server -t /etc/apparmor.d/ # aa-enforce /usr/bin/ente-server
(Optional) Configure Firewall
If a host firewall like iptables or nftables has been enabled and configured, make sure the following is allowed:
- Traffic on
localhost
- Traffic from your Ente (mobile) client to TCP port
443
to reach Nginx - Traffic from your Ente (mobile) client to TCP port
3200
to reach the MinIO API port
Files
The ente-server-gitAUR package contains the ente-server(1) man page that lists and explains all files that are installed by this package.
See also
- Upstream Repository: ente.io Ente Server Repository