Установка Pydio · 7 min read · Dec 15, 2025

Как установить Pydio Cells на сервер Ubuntu 24.04

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

В этом руководстве мы проведем вас через установку Pydio Cells на сервер Ubuntu 24.04 с базой данных MariaDB и Apache в качестве обратного прокси.

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

Перед тем как начать, убедитесь, что у вас есть следующее:

  • Сервер Ubuntu 24.04.
  • Пользователь без прав root с правами администратора.
  • Доменное имя, указывающее на IP-адрес сервера.

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

Перед установкой Pydio Cells необходимо установить зависимости на вашей системе Ubuntu. Это включает в себя сервер базы данных MariaDB и веб-сервер Apache.

Сначала выполните следующую команду apt, чтобы обновить индекс пакетов Ubuntu и установить зависимости для Pydio Cells. С помощью этой команды вы установите веб-сервер Apache, сервер базы данных MariaDB и Certbot для генерации SSL/TLS сертификатов.

sudo apt update 
sudo apt install apache2 mariadb-server certbot python3-certbot-apache wget

Введите Y, чтобы подтвердить установку.

install deps

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

sudo systemctl is-enabled apache2 
sudo systemctl status apache2

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

check apache

Теперь проверьте статус сервера MariaDB с помощью команды ниже.

sudo systemctl is-enabled mariadb 
sudo systemctl status mariadb

Вышеуказанный сервер MariaDB работает и включен.

check mariadb

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

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

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

sudo mariadb-secure-installation

Вас спросят о конфигурации сервера MariaDB:

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

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

sudo mariadb -u root -p

Затем выполните следующие запросы для создания новой базы данных cellsdb, пользователя cells и пароля p4ssword. Убедитесь, что вы изменили данные ниже на свои.

CREATE DATABASE cellsdb;
CREATE USER cells@localhost IDENTIFIED BY 'cellsp4ssword';
GRANT ALL PRIVILEGES ON cellsdb.* TO cells@localhost;
FLUSH PRIVILEGES;

create database

Теперь выполните запрос ниже, чтобы убедиться, что пользователь cells@localhost может получить доступ к базе данных cellsdb.

SHOW GRANTS FOR cells@localhost;

Вы должны увидеть аналогичный вывод ниже:

check user

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

Установка Pydio Cells

В этом разделе вы создадите нового пользователя pydio, настроите переменные окружения, а затем загрузите и установите 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: /opt/pydio/bin /var/cells

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

sudo tee -a /etc/profile.d/cells-env.sh << EOF
export CELLS_WORKING_DIR=/var/cells
export CELLS_BIND=127.0.0.1:8080
export CELLS_EXTERNAL=https://cells.howtoforge.local
EOF
sudo chmod 0755 /etc/profile.d/cells-env.sh

Затем войдите как пользователь pydio и проверьте переменные окружения $CELLS_WORKING_DIR, $CELLS_BIND и $CELLS_EXTERNAL. Убедитесь, что каждая указывает на правильное значение, как в файле /etc/profile.d/cells-env.sh.

su - pydio

echo $CELLS_WORKING_DIR

echo $CELLS_BIND

echo $CELLS_EXTERNAL

check env

Теперь выполните команду ниже, чтобы загрузить бинарный файл Pydio в /opt/pydio/bin/cells.

export distribId=cells
wget -O /opt/pydio/bin/cells https://download.pydio.com/latest/

Сделайте файл /opt/pydio/bin/cells исполняемым и выйдите из текущего пользователя pydio.

chmod a+x /opt/pydio/bin/cells
exit

После этого выполните команду setcap ниже, чтобы разрешить Pydio использовать привилегированные порты (0-1024) и создать символическую ссылку на /usr/local/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 и выполните команду cells ниже, чтобы проверить версию Pydio Cells.

su - pydio
cells version

Как вы можете видеть ниже, Pydio Cells 4.4.3 установлена.

check pydio version

Настройка Pydio Cells

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

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

cells configure --cli
  • Выберите TCP для подключения к базе данных и введите вашу базу данных MariaDB, пользователя и пароль.
  • Введите N для поддержки MongoDB. В этом случае вы создадите и установите одиночный Pydio Cells.
  • Нажмите ENTER, чтобы использовать конфигурацию хранилища по умолчанию.
  • Введите нового администратора, адрес электронной почты и пароль для вашей установки Pydio Cells.

setup pydio

После завершения установки вы увидите сообщение Установка завершена.

pydio cells installed

Запуск Pydio Cells как службы systemd

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

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

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

Добавьте следующую конфигурацию в файл и убедитесь, что вы изменили переменную окружения 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

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

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

sudo systemctl daemon-reload

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

sudo systemctl enable --now cells
sudo systemctl status cells

cells as systemd service

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

После того как Pydio Cells работает как служба systemd, вы создадите новый файл виртуального хоста Apache в качестве обратного прокси для Pydio Cells. Вам также нужно будет включить модули Apache с помощью команды a2enmod.

Сначала выполните команду a2enmod ниже, чтобы включить модули Apache. В этом случае вы включите модули для SSL и обратного прокси.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

enable modules

Теперь создайте новый файл виртуального хоста /etc/apache2/sites-available/cells.conf с помощью следующей команды nano.

sudo nano /etc/apache2/sites-available/cells.conf

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


    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 ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

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

Затем выполните команду a2ensite ниже, чтобы активировать виртуальный хост cells.conf и проверить вашу конфигурацию Apache. Если у вас правильная конфигурация Apache, вы увидите вывод Синтаксис в порядке.

sudo a2ensite cells.conf 
sudo apachectl configtest

Наконец, выполните команду systemctl ниже, чтобы перезапустить веб-сервер Apache и применить ваши изменения.

sudo systemctl restart apache2

setup apache

Защита Pydio Cells с помощью HTTPS

Pydio Cells доступен через HTTPS. Поэтому вам необходимо включить HTTPS в вашем файле виртуального хоста Apache. В этом разделе вы сгенерируете SSL/TLS сертификаты с помощью certbot, чтобы защитить установку Pydio Cells.

Чтобы защитить Pydio Cells с помощью HTTPS, выполните команду certbot ниже. убедитесь, что вы изменили доменное имя и адрес электронной почты ниже на свои данные.

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

После завершения процесса ваши SSL/TLS сертификаты будут доступны в каталоге /etc/letsencrypt/live/domain.com.

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

Введите своего администратора и пароль, затем нажмите ENTER.

login

Вы увидите панель управления Pydio Cells, как показано ниже:

dashboard

Заключение

Поздравляем! Вы завершили установку Pydio Cells на сервер Ubuntu 24.04. У вас есть Pydio Cells, работающий с сервером базы данных MariaDB и Apache в качестве обратного прокси. Наконец, вы также защитили Pydio Cells с помощью HTTPS через Certbot и Letsencrypt.

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

Get new posts in your inbox

No spam. Unsubscribe anytime.