Установка Etherpad · 6 min read · Oct 13, 2025

Как установить Etherpad на Ubuntu 20.04

Etherpad — это веб-редактор в реальном времени, который позволяет авторам одновременно редактировать текстовый документ и отслеживать все изменения в реальном времени. Он является открытым исходным кодом, настраиваемым и позволяет отображать текст каждого автора своим цветом. Он также предоставляет HTTP API, который вы можете интегрировать с вашими приложениями для управления пользователями и группами. Он предлагает несколько плагинов, которые помогают интегрировать уведомления по электронной почте, загрузку файлов, видеозвонки в Etherpad. В этом руководстве мы покажем вам, как установить веб-редактор Etherpad на сервер Ubuntu 20.04.

Предварительные требования

  • Сервер с установленной Ubuntu 20.04.
  • Действительное доменное имя, указывающее на IP-адрес вашего сервера.
  • Настроенный пароль root для сервера.

Начало работы

Перед началом вам нужно обновить пакеты вашей системы до последней версии. Вы можете обновить их, выполнив следующую команду:

apt-get update -y

После обновления всех пакетов вам нужно будет установить некоторые зависимости в вашей системе. Вы можете установить все из них с помощью следующей команды:

apt-get install gnupg2 git unzip libssl-dev pkg-config gcc g++ make build-essential -y

После установки всех пакетов вы можете перейти к следующему шагу.

Установка и настройка базы данных MariaDB

Etherpad использует MariaDB в качестве бэкенда базы данных. Поэтому вам нужно будет установить сервер MariaDB в вашей системе. Вы можете установить его с помощью следующей команды:

apt-get install mariadb-server -y

После установки MariaDB войдите в оболочку MariaDB с помощью следующей команды:

mysql

После входа создайте базу данных и пользователя для Etherpad с помощью следующей команды:

MariaDB [(none)]> create database etherpad;  
MariaDB [(none)]> grant all privileges on etherpad.* to etherpad@localhost identified by 'password';

Затем сбросьте привилегии и выйдите из MariaDB с помощью следующей команды:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

На этом этапе ваша база данных настроена для Etherpad. Теперь вы можете перейти к следующему шагу.

Установка Node.js

Etherpad основан на Node.js. Поэтому вам нужно будет установить Node.js в вашей системе. По умолчанию последняя версия Node.js недоступна в стандартном репозитории Ubuntu 20.04. Поэтому вам нужно будет добавить репозиторий Node.js в вашу систему. Вы можете добавить его с помощью следующей команды:

curl -sL https://deb.nodesource.com/setup_14.x -o nodesource_setup.sh  
bash nodesource_setup.sh

После добавления репозитория установите Node.js с помощью следующей команды:

apt-get install nodejs -y

После установки Node.js проверьте установленную версию Node.js с помощью следующей команды:

node -v

Вы должны получить следующий вывод:

v14.15.0

Когда вы закончите, вы можете перейти к следующему шагу.

Установка и настройка Etherpad

Перед установкой Etherpad рекомендуется запускать Etherpad как отдельного пользователя. Вы можете создать нового пользователя для Etherpad с помощью следующей команды:

adduser --home /opt/etherpad --shell /bin/bash etherpad

Вам будет предложено установить пароль, как показано ниже:

Adding user `etherpad' ...
Adding new group `etherpad' (1000) ...
Adding new user `etherpad' (1000) with group `etherpad' ...
Creating home directory `/opt/etherpad' ...
Copying files from `/etc/skel' ...
New password: 
Retype new password: 
passwd: password updated successfully
Changing the user information for etherpad
Enter the new value, or press ENTER for the default
    Full Name []: Hitesh       
    Room Number []: 1
    Work Phone []: 
    Home Phone []: 
    Other []: 
Is the information correct? [Y/n] Y

Затем предоставьте необходимые разрешения для домашнего каталога Etherpad с помощью следующей команды:

install -d -m 755 -o etherpad -g etherpad /opt/etherpad

Затем переключитесь на пользователя Etherpad и загрузите последнюю версию Etherpad из репозитория Git с помощью следующей команды:

su - etherpad  
git clone --branch master https://github.com/ether/etherpad-lite.git

Затем измените каталог на загруженный каталог и запустите Etherpad с помощью следующей команды:

cd etherpad-lite  
bin/run.sh

Это установит все зависимости и запустит сервер Etherpad. После успешного запуска сервера вы должны получить следующий вывод:

[2020-11-11 06:46:44.783] [INFO] console - Ваша версия Etherpad: 1.8.6 (2c8769a)
[2020-11-11 06:46:44.958] [INFO] console - Вы можете получить доступ к вашему экземпляру Etherpad по адресу http://0.0.0.0:9001/
[2020-11-11 06:46:44.958] [WARN] console - Имя пользователя и пароль администратора не установлены в settings.json.  Чтобы получить доступ к администратору, пожалуйста, раскомментируйте и отредактируйте 'users' в settings.json
[2020-11-11 06:46:44.958] [WARN] console - Etherpad работает в режиме разработки.  Этот режим медленнее для пользователей и менее безопасен, чем производственный режим.  Вы должны установить переменную окружения NODE_ENV в значение production, используя: export NODE_ENV=production

Затем нажмите CTRL + C, чтобы остановить сервер. Далее вам нужно будет отредактировать файл settings.json и определить настройки вашей базы данных и администратора:

nano settings.json

Удалите следующие строки:

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

Измените настройки MySQL, как показано ниже:

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

Измените строку trustProxy на true:

  "trustProxy": true,

Определите пароль для администратора:

  "users": {
    "admin": {
      "password": "adminpassword",
      "is_admin": true
    },

Сохраните и закройте файл, затем установите необходимые зависимости с помощью следующей команды:

./bin/installDeps.sh

После установки всех зависимостей выйдите из пользователя Etherpad с помощью следующей команды:

exit

На этом этапе Etherpad установлен и настроен. Теперь вы можете перейти к следующему шагу.

Создание файла службы Systemd для Etherpad

Далее вам нужно будет создать файл службы systemd для управления службой Etherpad. Вы можете создать его с помощью следующей команды:

nano /etc/systemd/system/etherpad.service

Добавьте следующие строки:

[Unit]
Description=Etherpad-lite, совместный редактор.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad/etherpad-lite
Environment=NODE_ENV=production

ExecStart=/usr/bin/node /opt/etherpad/etherpad-lite/src/node/server.js

Restart=always

[Install]
WantedBy=multi-user.target

Сохраните и закройте файл, затем перезагрузите демон systemd, выполнив следующую команду:

systemctl daemon-reload

Затем запустите службу Etherpad и включите ее запуск при перезагрузке системы с помощью следующей команды:

systemctl start etherpad  
systemctl enable etherpad

Вы также можете проверить статус службы Etherpad с помощью следующей команды:

systemctl status etherpad

Вы должны увидеть следующий вывод:

? etherpad.service - Etherpad-lite, совместный редактор.
     Loaded: loaded (/etc/systemd/system/etherpad.service; disabled; vendor preset: enabled)
     Active: active (running) since Wed 2020-11-11 06:50:49 UTC; 4s ago
   Main PID: 12269 (node)
      Tasks: 13 (limit: 4691)
     Memory: 119.1M
     CGroup: /system.slice/etherpad.service
             ??12269 /usr/bin/node /opt/etherpad/etherpad-lite/src/node/server.js

Настройка Nginx для Etherpad

На этом этапе Etherpad запущен и слушает на порту 9001. Далее вам нужно будет установить и настроить Nginx в качестве обратного прокси для доступа к Etherpad. Сначала установите Nginx с помощью следующей команды:

apt-get install nginx -y

Затем создайте новый файл конфигурации виртуального хоста Nginx с помощью следующей команды:

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

Добавьте следующие строки:

upstream etherpad {
   server localhost:9001;
   keepalive 32;
}

server {
   listen 80;
   server_name etherpad.mydomain.com;

   location / {
       client_max_body_size 50M;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_http_version 1.1;
       proxy_pass http://etherpad;
   }
}

Сохраните и закройте файл, затем активируйте файл конфигурации виртуального хоста Nginx с помощью следующей команды:

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

Затем проверьте Nginx на наличие синтаксических ошибок с помощью следующей команды:

ginx -t

Вы должны получить следующий вывод:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Затем перезапустите службу Nginx, чтобы применить изменения:

systemctl restart nginx

Вы также можете проверить статус Nginx с помощью следующей команды:

systemctl status nginx

Вы должны получить следующий вывод:

? nginx.service - Высокопроизводительный веб-сервер и сервер обратного прокси
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2020-11-11 06:53:44 UTC; 6s ago
       Docs: man:nginx(8)
    Process: 12984 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 12985 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 13001 (nginx)
      Tasks: 3 (limit: 4691)
     Memory: 3.5M
     CGroup: /system.slice/nginx.service
             ??13001 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??13002 nginx: worker process
             ??13003 nginx: worker process

Nov 11 06:53:44 ubuntu2004 systemd[1]: Starting Высокопроизводительный веб-сервер и сервер обратного прокси...
Nov 11 06:53:44 ubuntu2004 systemd[1]: Started Высокопроизводительный веб-сервер и сервер обратного прокси.

Доступ к Etherpad

Теперь откройте ваш веб-браузер и введите URL http://etherpad.mydomain.com. Вы будете перенаправлены на следующую страницу:

Etherpad

Укажите имя вашей страницы и нажмите кнопку OK. Вы должны увидеть вашу панель управления Etherpad на следующей странице:

Etherpad Online Editor

Заключение

Поздравляем! Вы успешно установили и настроили Etherpad с Nginx в качестве обратного прокси на сервере Ubuntu 20.04. Вы можете легко использовать Etherpad в производственной среде. Не стесняйтесь задавать вопросы, если у вас есть какие-либо вопросы.

Share: X/Twitter LinkedIn
#Установка Etherpad

Get new posts in your inbox

No spam. Unsubscribe anytime.