Как установить Pydio Cells на AlmaLinux 9

Pydio Cells — это платформа для совместного использования документов и сотрудничества с открытым исходным кодом для вашей организации. Она позволяет вам делиться документами и файлами по всей вашей организации и предоставляет полный контроль над вашей средой совместного использования документов.

Pydio Cells быстро работает, может обрабатывать большие объемы передачи файлов и предоставляет расширенную автоматизацию рабочих процессов.

В этом руководстве мы покажем вам, как установить Pydio Cells на сервер Alma Linux 9. Вы будете устанавливать Pydio Cells с сервером базы данных MariaDB и веб-сервером Httpd.

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

Чтобы начать с этого руководства, убедитесь, что у вас есть следующее:

Сервер Alma Linux 9
Пользователь, не являющийся root, с правами администратора
Доменное имя, указывающее на IP-адрес сервера
SELinux со статусом включен и разрешен

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

Перед установкой Pydio Cells вам нужно установить зависимости на вашем сервере Alma Linux. Это включает в себя репозиторий EPEL, сервер базы данных MariaDB, веб-сервер Httpd и некоторые системные инструменты, такие как wget и nano.

Сначала выполните команду ‘ dnf ‘ ниже, чтобы добавить репозиторий EPEL и установить сервер MariDB и веб-сервер Httpd. Введите ‘ Y ‘, чтобы подтвердить установку.

sudo dnf install epel-release mariadb-server httpd wget nano

install deps

После завершения установки выполните команду ‘ systemctl ‘ ниже, чтобы запустить, включить и проверить службу ‘ httpd ‘. Вы увидите, что служба ‘ httpd ‘ работает и включена.

sudo systemctl enable --now httpd  
sudo systemctl status httpd

check httpd

Теперь выполните следующую команду, чтобы запустить и включить службу ‘ mariadb ‘. Затем проверьте, чтобы убедиться, что служба работает.

sudo systemctl enable --now mariadb  
sudo systemctl status mariadb

В следующем выводе вы можете увидеть, что сервер MariaDB работает и включен.

check mariadb

Наконец, выполните команду ‘ firewall-cmd ‘ ниже, чтобы открыть порты ‘ http ‘ и ‘ https ‘ на вашей системе. Затем перезагрузите правила firewalld, чтобы применить ваши изменения.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

Настройка сервера MariaDB

После установки зависимостей вам нужно защитить установку сервера MariaDB и создать новую базу данных и пользователя для установки Pydio Cells. Вы будете защищать MariaDB с помощью команды ‘ mariadb-secure-installation ‘, а затем создадите новую базу данных и пользователя через клиент ‘ mariadb ‘.

Чтобы защитить установку сервера MariaDB, выполните команду ‘ mariadb-secure-installation ‘ ниже.

sudo mariadb-secure-installation

В процессе вас спросят о следующих настройках:

Переключить локальную аутентификацию на unix_socket? Введите n.
Установить новый пароль root для MariaDB. Введите y для подтверждения, затем введите новый пароль для вашей установки сервера MariaDB.
Удалить анонимного пользователя? Введите y для подтверждения.
Удалить тестовую базу данных по умолчанию из развертывания? Введите y для подтверждения.
Запретить вход root в MariaDB из удаленных подключений? Введите y для подтверждения.
Перезагрузить привилегии таблиц и применить изменения. Введите y и нажмите ENTER.

Теперь, когда сервер MariaDB защищен, вы создадите новую базу данных и пользователя для установки Pydio Cells.

Войдите в сервер MariaDB с помощью команды ‘ mariadb ‘ ниже. Введите свой пароль root для MariaDB, когда будет предложено.

sudo mariadb -u root -p

Выполните следующие запросы, чтобы создать новую базу данных ‘ cells ‘ и нового пользователя ‘ pydio ‘ с паролем ‘p4ssw0rd’. Вы можете настроить данные базы данных по мере необходимости.

CREATE DATABASE cells;  
CREATE USER 'pydio'@'localhost' IDENTIFIED BY 'p4ssw0rd';  
GRANT ALL PRIVILEGES ON cells.* to 'pydio'@'localhost';  
FLUSH PRIVILEGES;

create database

Теперь проверьте привилегии для пользователя ‘ pydio ‘, чтобы убедиться, что у него есть разрешения и привилегии на базу данных ‘ cells ‘.

SHOW GRANTS FOR 'pydio'@'localhost';

Вы можете увидеть ниже, что база данных ‘ cells ‘ доступна через пользователя ‘ pydio ‘.

check database

Введите ‘quit’, чтобы выйти из сервера MariaDB.

Скачивание Pydio Cells

С настроенной базой данных MariaDB вы готовы скачать Pydio Cells. В этом разделе вы создадите пользователя ‘pydio’, загрузите Pydio Cells, настроите каталог установки и переменные окружения, а также разрешите Pydio Cells работать на привилегированных портах.

Создайте нового пользователя и группу ‘ pydio ‘ с помощью следующей команды.

sudo useradd -m -s /bin/bash pydio

Создайте новые каталоги ‘ /opt/pydio/bin ‘ и ‘ /var/cells ‘ с помощью команды ниже. Затем измените владельца обоих каталогов на пользователя ‘ pydio ‘.

sudo mkdir -p /opt/pydio/bin /var/cells  
sudo chown -R pydio:pydio /opt/pydio/bin /var/cells

Теперь создайте новый файл env ‘ /etc/profile.d/cells-env.sh ‘ с помощью редактора ‘ nano ‘.

sudo nano /etc/profile.d/cells-env.sh

Введите следующий скрипт, чтобы настроить переменные окружения для Pydio Cells. Убедитесь, что вы изменили адрес ‘ CELLS_EXTRERNAL ‘, чтобы он соответствовал доменному имени вашей установки Pydio.

export CELLS_WORKING_DIR=/var/cells  
export CELLS_BIND=127.0.0.1:8080  
export CELLS_EXTERNAL=https://cells.howtoforge.local

Когда закончите, сохраните и выйдите из файла.

Теперь выполните команду ниже, чтобы сделать файл env ‘ /etc/profile.d/cells-env.sh ‘ исполняемым.

sudo chmod +x /etc/profile.d/cells-env.sh

Затем выполните команду ниже, чтобы скачать бинарный файл Pydio Cells для Linux в ‘ /opt/pydio/bin/cells ‘.

export distribId=cells  
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/${distribId}/release/{latest}/linux-amd64/${distribId}

После загрузки выполните следующую команду, чтобы сделать бинарный файл ‘ cells ‘ исполняемым и разрешить ему связываться с привилегированными портами.

sudo chmod a+x /opt/pydio/bin/cells  
sudo setcap 'cap_net_bind_service=+ep' /opt/pydio/bin/cells  
sudo ln -s /opt/pydio/bin/cells /usr/local/bin/cells

Теперь войдите как пользователь ‘ pydio ‘ с помощью следующей команды:

su - pydio

Проверьте переменные окружения для Pydio Cells с помощью следующей команды — убедитесь, что вывод соответствует файлу env ‘ /etc/profile.d/cells-env.sh ‘.

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

check env

Наконец, проверьте версию ‘cells’ с помощью команды ниже.

cells version

В следующем выводе вы можете увидеть версию Pydio Cells.

check cells version

Установка Pydio Cells через командную строку

Теперь вы начнете установку Pydio Cells из командной строки. С помощью команды ‘ cells ‘ вы настроите установку Pydio Cells с сервером базы данных MariaDB, настроите администратора и пароль, а также установите место хранения для хранения пользовательских данных.

Чтобы начать, выполните команду ниже, чтобы настроить установку Pydio Cells из терминала.

cells configure --cli

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

Подключение к базе данных: выберите через TCP, затем введите данные вашего хоста базы данных MariaDB, порт, пользователя и пароль.
Настройка MongoDB: введите n для нет.
Настройка административного пользователя: введите вашего администратора и пароль для Pydio Cells.
Место хранения по умолчанию: нажмите ENTER, чтобы использовать по умолчанию и продолжить.

После завершения процесса вы увидите следующий вывод:

installing pydio cells

Настройка файла службы systemd для Pydio Cells

С предыдущего шага вы можете запустить Pydio Cells с помощью команды ‘cells start’. Чтобы упростить это, вы будете использовать systemd ‘systemctl’ для управления службой Pydio Cells. Теперь вы создадите новый файл службы systemd.

Создайте новый файл ‘/etc/systemd/system/cells.service’ с помощью редактора ‘nano’.

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

Вставьте конфигурацию ниже, чтобы запустить Pydio Cells как службу systemd. Убедитесь, что вы изменили ‘CELLS_EXTERNAL’ на ваше доменное имя.

[Unit]  
Description=Pydio Cells  
Documentation=https://pydio.com  
Wants=network-online.target  
After=network-online.target  
AssertFileIsExecutable=/opt/pydio/bin/cells  
  
[Service]  
User=pydio  
Group=pydio  
PermissionsStartOnly=true  
AmbientCapabilities=CAP_NET_BIND_SERVICE  
ExecStart=/opt/pydio/bin/cells start  
Restart=on-failure  
StandardOutput=journal  
StandardError=inherit  
LimitNOFILE=65536  
TimeoutStopSec=5  
KillSignal=INT  
SendSIGKILL=yes  
SuccessExitStatus=0  
WorkingDirectory=/home/pydio  
  
# Добавьте переменные окружения  
Environment=CELLS_WORKING_DIR=/var/cells  
Environment=CELLS_BIND=127.0.0.1:8080  
Environment=CELLS_EXTERNAL=https://cells.howtoforge.local  
  
[Install]  
WantedBy=multi-user.target

Сохраните файл и выйдите из редактора.

Теперь выполните команду ниже, чтобы перезагрузить менеджер systemd.

sudo systemctl daemon-reload

Наконец, выполните команду ‘ systemctl ‘ ниже, чтобы запустить, включить и проверить службу ‘ cells ‘.

sudo systemctl enable --now cells  
sudo systemctl status cells

В этом выводе вы можете увидеть, что служба ‘ cells ‘ работает в фоновом режиме как служба systemd.

systemd service

Настройка Httpd как обратного прокси

На данный момент Pydio Cells работает на вашем сервере Alma Linux на порту ‘8080’. Чтобы сделать его доступным для клиента, вы создадите файл виртуального хоста Httpd как обратный прокси для сервера Pydio Cells. Вы также сгенерируете SSL/TLS сертификаты от Letsencrypt для обеспечения безопасной передачи данных между клиентом и сервером Pydio Cells.

Сначала выполните команду ‘ dnf ‘ ниже, чтобы установить ‘certbot’ на вашу систему.

sudo dnf install certbot -y

Теперь создайте новый каталог корня веба и измените владельца на пользователя ‘ apache ‘.

sudo mkdir -p /var/www/html/cells/public_html  
sudo chown -R apache:apache /var/www/html/cells/public_html

Выполните команду ‘ certbot ‘ ниже, чтобы сгенерировать SSL/TLS сертификаты для Pydio Cells. Убедитесь, что вы изменили адрес электронной почты и доменное имя на свои данные.

sudo certbot certonly --agree-tos --email [email protected] --no-eff-email --webroot -w /var/www/html/cells/public_html -d cells.howtoforge.local

Затем создайте новую конфигурацию виртуального хоста Httpd ‘ /etc/httpd/conf.d/pydio.conf ‘ с помощью редактора ‘ nano ‘.

sudo nano /etc/httpd/conf.d/pydio.conf

Вставьте конфигурацию ниже и убедитесь, что вы изменили опцию ‘ ServerName ‘ на ваше доменное имя.

  
ServerName cells.howtoforge.local  
  
RewriteEngine On  
RewriteCond %{HTTPS} off  
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI}  
  
RewriteCond %{SERVER_NAME} =cells.howtoforge.local  
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]  
  
  
  
ServerName cells.howtoforge.local  
AllowEncodedSlashes On  
RewriteEngine On  
  
# будьте осторожны с этим  
# Разрешить обратный прокси через самоподписанные сертификаты  
SSLProxyEngine On  
SSLProxyVerify none  
SSLProxyCheckPeerCN off  
SSLProxyCheckPeerName off  
SSLProxyCheckPeerExpire off  
  
## Порядок директив имеет значение.  
# Если Cells не работает с https, рассмотрите возможность использования ws вместо wss  
ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon  
  
## Это условие переписывания требуется, если используется Cells-Sync  
# RewriteCond %{HTTP:Content-Type} =application/grpc [NC]  
# RewriteRule /(.*) h2://localhost:8080/$1 [P,L]  
  
ProxyPass "/" "https://127.0.0.1:8080/"  
ProxyPassReverse "/" "https://127.0.0.1:8080/"  
  
ErrorLog /var/log/httpd/error.log  
CustomLog /var/log/httpd/access.log combined  
  
SSLCertificateFile /etc/letsencrypt/live/cells.howtoforge.local/fullchain.pem  
SSLCertificateKeyFile /etc/letsencrypt/live/cells.howtoforge.local/privkey.pem  
#Include /etc/letsencrypt/options-ssl-apache.conf

Сохраните файл и выйдите из редактора, когда закончите.

Теперь выполните команду ‘ apachectl ‘ ниже, чтобы проверить синтаксис вашего Apache. Если у вас правильная конфигурация Apache, вы увидите вывод ‘ Синтаксис в порядке ‘.

sudo apachectl configtest

Наконец, выполните команду ‘systemctl’ ниже, чтобы перезапустить веб-сервер ‘ httpd ‘ и применить ваши изменения. С этим ваша установка Pydio Cells должна быть завершена и доступна.

sudo systemctl restart httpd

setup httpd

Доступ к Pydio Cells

Откройте веб-браузер и посетите доменное имя вашей установки Pydio Cells, например https://cells.howtoforge.local. Если установка прошла успешно, вы увидите страницу входа в Pydio Cells.

Введите своего администратора и пароль, чтобы войти.

Если у вас правильные учетные данные, вы увидите панель управления пользователем Pydio Cells, как показано ниже.

pydio dashboard

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

pydio upload files

Заключение

Поздравляем! Вы завершили установку Pydio Cells на сервере Alma Linux 9. У вас работает Pydio Cells с сервером базы данных MariaDB и веб-сервером Httpd. Кроме того, вы также защитили установку Pydio Cells с помощью HTTPS через Certbot и Letsencrypt.