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

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

Системные требования

• Процессор: 1 ГГц или быстрее
• Оперативная память: Минимум 1 ГБ (рекомендуется 2 ГБ)
• Дисковое пространство: Не менее 500 МБ свободного

Требования к программному обеспечению

• Операционная система: Ubuntu 24.04 LTS
• js: Версия 14 или более поздняя
• NPM: Node Package Manager для управления пакетами Node.js
• База данных: MariaDB или MySQL для хранения данных
• Nginx: Необязательно, для настройки обратного прокси
• Git: Для клонирования репозитория Etherpad
• Python3: Требуется для некоторых зависимостей

Шаг 1: Обновление системы

Первый шаг в установке Etherpad — убедиться, что ваша система обновлена. Откройте терминал и выполните следующие команды:

sudo apt update && sudo apt upgrade -y

Эта команда обновляет списки пакетов и обновляет все установленные пакеты до последних версий, гарантируя, что ваша система имеет последние исправления и функции безопасности.

Шаг 2: Установка зависимостей

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

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

Эта команда устанавливает MariaDB (сервер баз данных), Nginx (дополнительный веб-сервер), Node.js, npm, Git и другие важные библиотеки, необходимые для работы Etherpad.

Проверка установки

После установки убедитесь, что Node.js и npm установлены правильно, проверив их версии:

node -v
npm -v

В терминале должны отобразиться номера версий. Если нет, вернитесь к шагам установки.

Шаг 3: Настройка базы данных

База данных необходима для хранения данных Etherpad. Выполните следующие шаги, чтобы создать базу данных и пользователя для Etherpad с помощью MariaDB:

sudo mysql -u root -p

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

CREATE DATABASE etherpad;
CREATE USER 'etherpaduser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON etherpad.* TO 'etherpaduser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Это создаст новую базу данных с именем «etherpad» и пользователя «etherpaduser» с полными привилегиями в этой базе данных. Замените ‘your_password’ на надежный пароль по вашему выбору.

Шаг 4: Установите Etherpad

Следующим шагом будет загрузка и установка самого Etherpad. Начните с клонирования репозитория Etherpad с GitHub:

git clone https://github.com/ether/etherpad-lite.git /opt/etherpad-lite

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

Установка разрешений

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

sudo chown -R $USER:$USER /opt/etherpad-lite

Установка зависимостей Etherpad

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

cd /opt/etherpad-lite && npm install

Эта команда устанавливает все необходимые пакеты Node.js, необходимые для правильной работы Etherpad.

Шаг 5: Настройте Etherpad

Необходимо отредактировать файл конфигурации, чтобы настроить соединения с базой данных и другие параметры. Начните с копирования файла конфигурации шаблона:

cp settings.json.template settings.json

Отредактируйте этот файл с помощью текстового редактора, например nano:

nano settings.json

Вам нужно будет внести несколько ключевых изменений в этот файл:

• «dbType»: «mysql»: Установите это значение, чтобы указать, что вы используете MySQL/MariaDB.
• «dbSettings»: Обновите этот раздел, указав учетные данные вашей базы данных:

{
            "user": "etherpaduser",
            "host": "localhost",
            "password": "your_password",
            "database": "etherpad"
        }

• ip»: «0.0.0.0″: Это позволяет Etherpad принимать соединения с любого IP-адреса.
• «port»: 9001: порт по умолчанию, на котором будет работать Etherpad.

Дополнительные настройки

Вы также можете включить аутентификацию, изменив дополнительные настройки в файле `settings.json`. Это позволит вам эффективно управлять доступом пользователей.

Шаг 6: Запуск Etherpad

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

/opt/etherpad-lite/bin/run.sh

Это запустит Etherpad, но для более удобного управления рекомендуется настроить его как службу systemd.

Настройка в качестве службы Systemd

Создайте новый файл службы для Etherpad, выполнив команду:

sudonano /etc/systemd/system/etherpad.service

Добавьте следующее содержимое в этот служебный файл:

[Unit]
Description=EtherPad
After=network.target

[Service]
Type=simple
User=your_username
ExecStart=/usr/bin/node /opt/etherpad-lite/node_modules/.bin/ep
Restart=on-failure

[Install]
WantedBy=multi-user.target

Замените `ваше_имя_пользователя` на ваше настоящее имя пользователя.

Включение и запуск службы

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

sudo systemctl enable etherpad
sudo systemctl start etherpad

Шаг 7: Доступ к Etherpad

Теперь ваш экземпляр Etherpad должен быть запущен. Вы можете получить доступ к нему через веб-браузер, перейдя по ссылке:

http://your-server-ip:9001

Замените `ваш-server-ip` на реальный IP-адрес вашего сервера.

Устранение проблем с доступом

Если у вас возникли проблемы с доступом к Etherpad, убедитесь, что порт 9001 открыт в вашем брандмауэре:

sudo ufw allow 9001/tcp
sudo ufw reload

Поздравляем! Вы успешно установили Etherpad. Для получения дополнительной помощи или полезной информации мы рекомендуем вам посетить официальный сайт Etherpad.