서버 설치 · 6 min read · Sep 10, 2025

우분투 24.04 서버에 Etherpad 협업 편집기 설치하는 방법

Etherpad는 팀을 위한 오픈 소스 협업 및 실시간 텍스트 편집기로, Etherpad는 웹 기반 텍스트 편집기이기 때문에 언제 어디서나 접근할 수 있습니다. Etherpad는 버전 관리 및 팀을 위한 내장 형식을 지원하며, 다양한 플러그인을 지원하는 매우 사용자 정의 가능한 편집기를 제공합니다. 또한 doc, pdf, odt, markdown 등과 같은 현대 문서 형식을 지원합니다.

이 가이드에서는 우분투 24.04 서버에 Etherpad 협업 편집기를 설치하는 과정을 안내합니다. MariaDB 데이터베이스 서버로 Etherpad를 설정하고, Nginx를 리버스 프록시로 사용한 다음, Certbot과 Letsencrypt를 통해 Etherpad를 HTTPS로 보호합니다.

필수 조건

이 가이드를 시작하기 전에 다음 사항을 확인하십시오:

우분투 24.04 서버.
관리자 권한이 있는 비루트 사용자.
서버 IP 주소를 가리키는 도메인 이름.

의존성 설치

Etherpad는 Node.js로 작성된 협업 실시간 편집기입니다. 이를 설치하려면 Node.js, NPM 및 Git과 같은 패키지 의존성을 설치해야 합니다. Etherpad는 데이터베이스를 위해 Python3 및 MySQL/MariaDB도 필요합니다.

먼저, 다음 명령어로 우분투 저장소를 업데이트합니다:

sudo apt update

update repo

이제 아래 명령어를 사용하여 Etherpad의 의존성을 설치합니다. 이 명령어로 MariaDB 서버, Nginx, Node.js, Python3, Git 및 몇 가지 필수 도구를 설치합니다.

sudo apt install mariadb-server nginx nodejs npm gzip git curl python3 libssl-dev

설치를 확인하려면 Y를 입력합니다.

install deps

설치 후, MariaDB 및 Nginx 서비스가 모두 실행 중인지 확인합니다.

다음 명령어로 MariaDB 서비스를 확인합니다:

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

아래와 같이 MariaDB 서비스가 실행 중이며 부팅 시 자동으로 시작됨을 확인할 수 있습니다.

check mariadb

이제 아래 명령어를 사용하여 Nginx 서비스를 확인합니다. Nginx 서비스가 실행 중이고 활성화되어 있으면 유사한 출력을 얻을 수 있습니다.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

check nginx

마지막으로, 다음 명령어로 Node.js 버전을 확인합니다.

node -v

Node.js v18.x 이상이 설치되어 있는지 확인하십시오. Etherpad는 Node.js v18 이상을 지원합니다.

MariaDB 서버 설정

의존성을 설치한 후, MariaDB 서버를 구성하고 Etherpad를 위한 새로운 데이터베이스와 사용자를 생성합니다. ‘mariadb-secure-installation’ 유틸리티를 사용하여 MariaDB를 보호한 다음, MariaDB 클라이언트를 통해 데이터베이스와 사용자를 설정합니다.

MariaDB 서버를 보호하려면 다음을 실행합니다:

sudo mariadb-secure-installation

MariaDB 서버 구성에 대한 프롬프트가 표시됩니다:

  1. 기본 MariaDB 설치는 비밀번호 없이 제공되므로 비밀번호 프롬프트에서 ENTER를 누릅니다.
  2. 이제 Y를 입력하여 MariaDB 루트 비밀번호를 설정합니다. 그런 다음, MariaDB의 새 비밀번호를 입력하고 비밀번호를 반복합니다.
  3. MariaDB 설치에서 익명 사용자를 제거하려면 Y를 입력합니다.
  4. MariaDB 루트 사용자의 원격 로그인을 비활성화하라는 프롬프트에서 다시 Y를 입력합니다.
  5. MariaDB의 기본 데이터베이스 테스트를 제거하려면 Y를 입력합니다.
  6. 마지막으로, 테이블 권한을 다시 로드하고 새 변경 사항을 적용하려면 Y를 입력합니다.

MariaDB 서버를 보호하고 구성한 후, Etherpad를 위한 새로운 데이터베이스와 사용자를 생성합니다.

다음 명령어로 MariaDB 서버에 로그인합니다. 프롬프트에서 MariaDB 루트 비밀번호를 입력합니다.

sudo mariadb -u root -p

다음으로, 다음 MariaDB 쿼리를 실행하여 새로운 데이터베이스 ‘etherpad_db‘와 사용자 ‘etherpad‘를 생성하고 비밀번호 ‘StrongPasswordEtherpadDB‘를 설정합니다. 다음 데이터베이스 세부정보를 귀하의 정보로 조정할 수 있습니다.

CREATE DATABASE etherpad_db;  
CREATE USER etherpad@localhost IDENTIFIED BY 'StrongPasswordEtherpadDB';  
GRANT CREATE,ALTER,SELECT,INSERT,UPDATE,DELETE on etherpad_db.* to etherpad@localhost;  
FLUSH PRIVILEGES;

create database and user

이제 다음 쿼리를 실행하여 사용자 ‘etherpad‘가 데이터베이스 ‘etherpad_db‘에 접근할 수 있는지 확인합니다.

SHOW GRANTS FOR etherpad@localhost;

아래에서 사용자 ‘etherpad‘가 데이터베이스 ‘etherpad_db‘에 대한 여러 권한을 가지고 있는 것을 볼 수 있습니다.

마지막으로, MariaDB 서버에서 종료하려면 quit를 입력합니다.

check db user

Etherpad Lite 설치

데이터베이스와 사용자를 생성한 후, Etherpad 소스 코드를 다운로드하고 설치 스크립트를 사용하여 Etherpad 의존성을 설치한 다음, MariaDB 서버와 함께 Etherpad 설치를 구성합니다.

기본적으로 Etherpad는 설치 관리를 위해 pnpm 패키지 관리자를 사용하므로 먼저 시스템에 ‘pnpm’을 전역적으로 설치해야 합니다.

먼저, 다음 npm 명령어를 사용하여 pnpm 패키지를 전역적으로 (-g) 설치합니다. 기본적으로 Etherpad 프로젝트는 표준 npm 대신 pnpm을 Node.js 패키지 관리자로 사용합니다.

npm install pnpm -g

이제 아래 명령어를 실행하여 새로운 시스템 사용자 ‘etherpad‘를 생성합니다. 이 사용자는 Etherpad 애플리케이션을 실행하는 데 사용됩니다.

sudo adduser --system --no-create-home --home=/opt/etherpad-lite --group etherpad

다음으로, /opt로 이동하여 git을 사용하여 ‘etherpad-lite‘ 디렉토리에 Etherpad 소스 코드를 다운로드합니다. 그런 다음 ‘/opt/etherpad-lite‘ 디렉토리의 소유권을 사용자 ‘etherpad‘로 변경합니다.

cd /opt && git clone --branch master https://github.com/ether/etherpad-lite.git   
sudo chown -R etherpad:etherpad /opt/etherpad-lite

그 후, ‘opt/etherpad-lite’ 디렉토리로 이동하여 다음과 함께 Etherpad의 Node.js 의존성을 설치합니다.

cd /opt/etherpad-lite  
sudo su -s /bin/bash -c "./bin/run.sh" etherpad

아래는 pnpm 패키지 관리자를 사용하여 Etherpad 의존성을 다운로드하는 과정입니다.

dependencies installation

의존성이 설치된 후, Etherpad는 자동으로 실행되어야 합니다. 아래에서 Etherpad 2.0.3이 실행 중인 것을 볼 수 있습니다.

현재 Etherpad 프로세스를 종료하려면 Ctrl+c를 누릅니다. 이제 MariaDB 데이터베이스로 Etherpad를 구성할 것입니다.

running etherpad

이제 다음 nano 편집기로 ‘settings.json‘ 파일을 엽니다.

nano settings.json

Etherpad 설치의 제목을 변경합니다.

 "title": "Etherpad Ubuntu 24",

기본 IP 주소를 12.0.0.1 또는 localhost로 변경합니다. 이렇게 하면 Etherpad 프로세스가 localhost에서만 시작됩니다.

"ip": "127.0.0.1",  
"port": 9001,

기본 ‘dirty‘ 데이터베이스 구성을 다음과 같이 주석 처리합니다:

 /*  
 *"dbType": "dirty",  
 *"dbSettings": {  
 * "filename": "var/dirty.db"  
 *},  
 */

다음 구성을 삽입하여 MariaDB 서버와 함께 데이터베이스를 설정합니다. 데이터베이스 정보의 세부 사항을 귀하의 정보로 변경해야 합니다.

 "dbType" : "mysql",  
 "dbSettings" : {  
 "user": "etherpad",  
 "host": "127.0.0.1",  
 "port": 3306,  
 "password": "StrongPasswordEtherpadDB",  
 "database": "etherpad_db",  
 "charset": "utf8mb4"  
 },

완료되면 파일을 저장하고 편집기를 종료합니다.

systemd 서비스로 Etherpad 실행

이제 Etherpad를 설치하고 구성했으므로 Etherpad를 위한 새로운 systemd 서비스 파일을 생성합니다. 이를 통해 Etherpad를 백그라운드에서 실행하고 ‘systemctl’ 명령어를 통해 Etherpad를 관리할 수 있습니다.

nano 편집기로 Etherpad를 위한 새로운 systemd 서비스 파일 ‘/etc/systemd/system/etherpad.service‘를 생성합니다.

sudo nano /etc/systemd/system/etherpad.service

파일에 다음 구성을 추가합니다. 이를 통해 ‘pnpm’ 명령어를 통해 Etherpad를 백그라운드에서 systemd 서비스로 실행합니다.

[Unit]  
Description=Etherpad-lite, the collaborative editor.  
After=syslog.target network.target mariadb.service  
  
[Service]  
Type=simple  
User=etherpad  
Group=etherpad  
WorkingDirectory=/opt/etherpad-lite  
ExecStart=/usr/local/bin/pnpm run prod  
# use mysql plus a complete settings.json to avoid Service hold-off time over, scheduling restart.  
Restart=always  
  
[Install]  
WantedBy=multi-user.target

파일을 저장하고 종료합니다.

이제 아래 명령어를 실행하여 systemd 관리자를 다시 로드하고 Etherpad 서비스 파일을 적용합니다.

sudo systemctl daemon-reload

systemd가 다시 로드된 후, 다음 systemctl 명령어로 ‘etherpad’ 서비스를 시작하고 활성화합니다.

sudo systemctl start etherpad  
sudo systemctl enable etherpad

다음으로, 아래 명령어를 실행하여 Etherpad 서비스 상태를 확인하고 서비스가 실행 중인지 확인합니다.

sudo systemctl status etherpad

아래에서 Etherpad 서비스가 서비스로 실행 중인 것을 볼 수 있습니다.

마지막으로, 아래 ‘ss’ 명령어로 기본 Etherpad 포트 9001을 확인합니다. Etherpad 프로세스가 포트 9001을 사용하고 있는 것을 확인할 수 있습니다.

ss -tulpn | grep 9001

Nginx를 리버스 프록시로 설정

이 가이드에서는 Nginx를 리버스 프록시로 사용하여 Etherpad를 실행합니다. 이제 Etherpad를 위한 Nginx 서버 블록 구성을 생성하고 Etherpad를 위한 도메인 이름을 준비했는지 확인합니다.

다음 nano 편집기 명령어를 사용하여 새로운 Nginx 서버 블록 ‘/etc/nginx/sites-available/etherpad.conf‘를 생성합니다.

sudo nano /etc/nginx/sites-available/etherpad.conf

다음 구성을 추가하고 server_name 옵션을 귀하의 도메인 이름으로 변경합니다. 이 구성으로 Nginx를 리버스 프록시로 사용하여 포트 9001에서 실행되는 Etherpad에 접근할 수 있습니다.

server {  
 listen 80;  
 server_name etherpad.howtoforge.local;  
  
 access_log /var/log/nginx/eplite.access.log;  
 error_log /var/log/nginx/eplite.error.log;  
  
location / {  
 proxy_pass http://127.0.0.1:9001;  
 proxy_buffering off; # be careful, this line doesn't override any proxy_buffering on set in a conf.d/file.conf  
 proxy_set_header Host $host;  
 proxy_pass_header Server;  
# Note you might want to pass these headers etc too.  
 proxy_set_header X-Real-IP $remote_addr; # https://nginx.org/en/docs/http/ngx_http_proxy_module.html  
 proxy_set_header X-Forwarded-For $remote_addr; # EP logs to show the actual remote IP  
 proxy_set_header X-Forwarded-Proto $scheme; # for EP to set secure cookie flag when https is used  
 proxy_http_version 1.1; # recommended with keepalive connections  
# WebSocket proxying - from https://nginx.org/en/docs/http/websocket.html  
 proxy_set_header Upgrade $http_upgrade;  
 proxy_set_header Connection "upgrade";  
 }  
  
}

완료되면 파일을 저장하고 닫습니다.

이제 아래 명령어를 실행하여 서버 블록 ‘etherpad.conf‘ 파일을 활성화하고 Nginx 구문을 확인합니다.

sudo ln -s /etc/nginx/sites-available/etherpad.conf /etc/nginx/sites-enabled/  
sudo nginx -t

올바른 Nginx 구문으로 ‘nginx is ok…test is successful‘라는 출력을 얻어야 합니다.

마지막으로, 아래 명령어를 실행하여 Nginx 서비스를 재시작하고 새로운 서버 블록을 적용합니다. 명령어를 실행한 후, Etherpad에 Nginx 웹 서버를 통해 접근할 수 있습니다.

sudo systemctl restart nginx

HTTPS로 Etherpad 보호하기

Nginx 리버스 프록시를 구성한 후, Etherpad를 HTTPS로 보호합니다. 공개 도메인을 사용하는 경우, Certbot과 Letsencrypt를 사용하여 HTTPS를 설정하는 다음 단계를 따를 수 있습니다. 로컬 도메인 사용자는 자체 서명된 인증서를 사용할 수 있습니다.

다음 명령어를 사용하여 Certbot과 Certbot Nginx 플러그인을 설치합니다. 프롬프트가 표시되면 설치를 확인하기 위해 Y를 입력합니다.

sudo apt install certbot python3-certbot-nginx

이제 다음 certbot 명령어를 실행하여 Letsencrypt에서 SSL/TLS 인증서를 생성합니다. 도메인 이름과 이메일 주소를 귀하의 정보로 변경해야 합니다.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d etherpad.howtoforge.local

프로세스가 완료되면 인증서는 ‘/etc/letsencrypt/live/domain.com‘ 디렉토리에 저장됩니다. 또한, Etherpad 설치는 Certbot Nginx 플러그인을 통해 자동으로 HTTPS로 실행되어야 합니다.

Etherpad 접근하기

Etherpad 도메인 이름 https://etherpad.howtoforge.local을 방문하여 Etherpad 설치에 접근합니다. 성공하면 다음 페이지가 표시됩니다:

첫 번째 패드의 새 이름을 입력하고 OK를 클릭하여 확인합니다.

create pad

이제 Etherpad의 문서 편집기를 볼 수 있습니다. 이제 친구나 동료와 동시에 문서를 편집할 수 있습니다.

etherpad editor

결론

축하합니다! 우분투 24.04 서버에 Etherpad 협업 편집기를 설치했습니다. MariaDB 데이터베이스 서버와 Nginx 웹 서버와 함께 Etherpad가 실행되고 있습니다. 또한, Certbot과 Letsencrypt를 통해 Etherpad를 HTTPS로 보호했습니다.

Share: X/Twitter LinkedIn
#서버 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.