Etherpad

Truy cập Etherpad

• Giao diện người dùng: https://<SERVER_IP>
• Giao diện quản trị: https://<SERVER_IP>/admin
• Thông tin đăng nhập quản trị: Tên đăng nhập admin, mật khẩu được lưu trữ trong .env as ADMIN_PASSWORD

Thêm người dùng qua cài đặt quản trị

1. Truy cập: https://<SERVER_IP>/admin

2. Đi đến Cài đặt.

3. Một file cấu hình JSON sẽ được hiển thị.

4. Xác định vị trí của users phần:

  "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. Thêm người dùng mới (theo đúng cú pháp 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. Nhấn Save Settings.

7. Nhấn Restart Etherpad.

Các tệp và thư mục quan trọng

• Cài đặt ứng dụng: /root/etherpad
• Tệp Docker Compose: /root/etherpad/docker-compose.yml
• Biến môi trường: /root/etherpad/.env
• Dữ liệu database PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Dữ liệu runtime của Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Thư mục plugin: /var/lib/docker/volumes/etherpad_plugins/_data
• Cấu hình Nginx: /etc/nginx/sites-available/etherpad
• Chứng chỉ SSL: /etc/nginx/ssl/

Quản lý Dịch vụ

Liệt kê các container:

docker ps

Khởi động lại các container:

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

Xem log của Etherpad:

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

Khởi động lại Nginx:

systemctl restart nginx

Kích hoạt SSL với tên miền

1. Trỏ tên miền của bạn về địa chỉ IP của máy chủ.

2. Chỉnh sửa cấu hình Nginx và thay thế cả hai server_name <IP>; với tên miền của bạn (<your-domain>) cho cả HTTP (cổng 80) và HTTPS (cổng 443) như sau:

vim /etc/nginx/sites-available/etherpad

3. Cài đặt Certbot:

apt install -y certbot python3-certbot-nginx

4. Chạy lệnh sau để tạo chứng chỉ Let's Encrypt hợp lệ:

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

5. Thay thế đường dẫn SSL trong cấu hình Nginx:

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. Khởi động lại Nginx để áp dụng các thay đổi:

systemctl restart nginx

7. Trình duyệt của bạn và truy cập: https://yourdomain.com

Ghi chú

• Etherpad chạy sau một reverse proxy Nginx để xử lý SSL và tăng cường bảo mật.
• Chứng chỉ tự ký có thể gây cảnh báo trên trình duyệt - đây là điều bình thường trừ khi bạn dùng Let's Encrypt.
• Một số trình duyệt có thể báo lỗi hoặc khiến Etherpad hoạt động không đúng.
• Etherpad đã được kiểm thử và xác nhận hoạt động tốt trên Firefox - đây là trình duyệt được khuyến nghị để đảm bảo tương thích tốt nhất.