에테르패드

Etherpad에 액세스

• 사용자 인터페이스: 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에서 작동하는 것으로 테스트 및 확인되었습니다.