イーサパッド

イーサパッドにアクセスする

• ユーザーインターフェース: 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. ブラウザを開いて次にアクセス: https://yourdomain.com

注意事項

• Etherpad は、SSL 終端とセキュリティの向上のために Nginx リバース プロキシの背後で提供されます。
• 自己署名証明書によりブラウザの警告が表示される場合があります。 Let’s Encrypt が使用されていない限り、これは予想されることです。
• 一部のブラウザではエラーが表示されたり、Etherpad が正しく機能しなくなる場合があります。
• Etherpad は Firefox 上でテストされ、動作することが確認されており、互換性を最大限に高めるために推奨されています。