이더패드

Access Etherpad

• User interface: https://<SERVER_IP>
• Admin interface: https://<SERVER_IP>/admin
• Admin credentials: Username admin, password stored in .env as ADMIN_PASSWORD

Add Users via Admin Settings

1. Visit: https://<SERVER_IP>/admin

2. Go to Settings.

3. A JSON configuration file will be displayed.

4. Locate the users section:

  "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. Add a new user (follow valid JSON syntax):

  "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. Click Save Settings.

7. Click Restart Etherpad.

중요한 파일 및 디렉터리

• 애플리케이션 설치: /root/etherpad
• Docker Compose 파일: /root/etherpad/docker-compose.yml
• 환경 변수: /root/etherpad/.env
• PostgreSQL database data: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Etherpad runtime data: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Plugins directory: /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

Follow Etherpad logs:

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 is served behind an Nginx reverse proxy for SSL termination and improved security.
• A self-signed certificate may trigger browser warnings; this is expected unless Let’s Encrypt is used.
• Some browsers may display errors or cause Etherpad to function incorrectly.
• Etherpad has been tested and confirmed working on Firefox, which is recommended for best compatibility.