Як встановити 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.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.