Etherpad

Etherpádにアクセス

• ユーザーインターフェース: https://<SERVER_IP>
• 管理インターフェース: https://<SERVER_IP>/admin
• 管理者認証情報：ユーザー名 adminパスワードが保存されている .env as ADMIN_PASSWORD

管理者設定からユーザーを追加する

1. 訪問してください： https://<SERVER_IP>/admin

2. 設定に移動します。

3. JSON の設定ファイルが表示されます。

4. ロケーションを確認してください users セクション:

  "users": {
    "admin": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "${ADMIN_PASSWORD:null}",
      "is_admin": true
    },
    "user": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "test",
      "is_admin": false
    }
  },

5. 新しいユーザーを追加します（有効な JSON 構文に従ってください）：

  "users": {
    "admin": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "${ADMIN_PASSWORD:null}",
      "is_admin": true
    },
    "user": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "test",
      "is_admin": false
    },
    "newuser": {
      "password": "strongpassword",
      "is_admin": false
    }
  },

6. 「設定を保存」をクリックします。

7. 「Etherpad を再起動」をクリックします。

主要ファイルとディレクトリ

• アプリケーションのインストール: /root/etherpad
• Docker Compose ファイル： /root/etherpad/docker-compose.yml
• 環境変数: /root/etherpad/.env
• PostgreSQL データベースのデータ： /var/lib/docker/volumes/etherpad_postgres_data/_data
• Etherpad のランタイムデータ： /var/lib/docker/volumes/etherpad_etherpad-var/_data
• プラグインディレクトリ: /var/lib/docker/volumes/etherpad_plugins/_data
• Nginx設定: /etc/nginx/sites-available/etherpad
• SSL証明書: /etc/nginx/ssl/

サービス管理

コンテナを一覧表示:

docker ps

コンテナを再起動:

docker compose -f /root/etherpad/docker-compose.yml restart

Etherpad のログを確認する：

docker compose -f /root/etherpad/docker-compose.yml logs -f

Nginx を再起動:

systemctl restart nginx

ドメインを使った SSL の有効化

1. ドメインをサーバーのIPアドレスに向けてください。

2. Nginx の設定ファイルを開き、以下の両方を置き換えてください server_name <IP>; ドメイン（<your-domain>) は HTTP (ポート 80) と HTTPS (ポート 443) の両ブロックに適用されます:

vim /etc/nginx/sites-available/etherpad

3. Certbotをインストールします:

apt install -y certbot python3-certbot-nginx

4. 以下のコマンドを実行して、有効な Let's Encrypt 証明書を生成します：

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Nginx の設定ファイルで SSL のパスを置き換える：

vim /etc/apache2/sites-available/etherpad
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. 変更を反映するために、Nginxを再起動します。

systemctl restart nginx

7. ブラウザを開いて、次のURLにアクセスしてください： https://yourdomain.com

注釈

• Etherpad は、SSL 終端とセキュリティ強化のため、Nginx リバースプロキシ経由で提供されています。
• 自己署名証明書を使用している場合、ブラウザに警告が表示されることがあります。Let's Encrypt を使用していない場合は想定内の動作です。
• ブラウザによっては、エラーが表示されたり Etherpad が正常に動作しないことがあります。
• Etherpad は Firefox での動作を確認済みです。最も互換性が高いため、Firefox の使用を推奨します。