Como Instalar Pydio Cells no AlmaLinux 9

Pydio Cells é uma plataforma de compartilhamento e colaboração de documentos de código aberto para sua organização. Ele permite que você compartilhe documentos e arquivos em toda a sua organização e dá a você controle total sobre seu ambiente de compartilhamento de documentos.

Os Pydio Cells são rápidos em desempenho, podem lidar com tamanhos de transferência de arquivos enormes e fornecem automação avançada de fluxo de trabalho.

Neste guia, vamos mostrar como instalar o Pydio Cells em um servidor Alma Linux 9. Você instalará o Pydio Cells com o servidor de banco de dados MariaDB e o servidor web Httpd.

Pré-requisitos

Para começar com este guia, certifique-se de ter o seguinte:

Um servidor Alma Linux 9
Um usuário não-root com privilégios de administrador
Um nome de domínio apontado para o endereço IP do servidor
Um SELinux com o status habilitado e permissivo

Instalando dependências

Antes de instalar o Pydio Cells, você precisa instalar dependências em seu servidor Alma Linux. Isso inclui o repositório EPEL, o servidor de banco de dados MariaDB, o servidor web Httpd e algumas ferramentas do sistema, como wget e nano.

Primeiro, execute o comando ‘ dnf ‘ abaixo para adicionar o repositório EPEL e instalar o servidor MariDB e o servidor web Httpd. Digite ‘ Y ‘ para confirmar a instalação.

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

install deps

Após a instalação ser concluída, execute o comando ‘ systemctl ‘ abaixo para iniciar, habilitar e verificar o serviço ‘ httpd ‘. Você verá que o serviço ‘ httpd ‘ está em execução e habilitado.

sudo systemctl enable --now httpd  
sudo systemctl status httpd

check httpd

Agora execute o seguinte comando para iniciar e habilitar o serviço ‘ mariadb ‘. E então, verifique para garantir que o serviço está em execução.

sudo systemctl enable --now mariadb  
sudo systemctl status mariadb

Na saída a seguir, você pode ver que o servidor MariaDB está em execução e habilitado.

check mariadb

Por último, execute o comando ‘ firewall-cmd ‘ abaixo para abrir as portas ‘ http ‘ e ‘ https ‘ em seu sistema. Em seguida, recarregue as regras do firewalld para aplicar suas alterações.

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

Configurando o servidor MariaDB

Depois de instalar as dependências, você precisa proteger a instalação do servidor MariaDB e criar um novo banco de dados e usuário para a instalação do servidor Pydio Cells. Você protegerá o MariaDB com o comando ‘ mariadb-secure-installation ‘, e então criará um novo banco de dados e usuário através do cliente ‘ mariadb ‘.

Para proteger a instalação do servidor MariaDB, execute o comando ‘ mariadb-secure-installation ‘ abaixo.

sudo mariadb-secure-installation

Durante o processo, você será questionado sobre as seguintes configurações:

Mudar a autenticação local para unix_socket? Digite n.
Configurar a nova senha root do MariaDB. Digite y para confirmar, depois digite a nova senha para sua implantação do servidor MariaDB.
Remover usuário anônimo? Digite y para confirmar.
Remover o banco de dados padrão de teste da implantação? Digite y para confirmar.
Proibir login root do MariaDB de conexões remotas? Digite y para confirmar.
Recarregar privilégios de tabela e aplicar as alterações. Digite y e pressione ENTER.

Agora que o servidor MariaDB está protegido, você criará um novo banco de dados e usuário para a instalação do Pydio Cells.

Faça login no servidor MariaDB com o comando ‘ mariadb ‘ abaixo. Insira sua senha root do MariaDB quando solicitado.

sudo mariadb -u root -p

Execute as seguintes consultas para criar um novo banco de dados ‘ cells ‘, e um novo usuário ‘ pydio ‘, com a senha ‘p4ssw0rd’. Você pode ajustar os detalhes do banco de dados conforme necessário.

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

create database

Agora verifique os privilégios para o usuário ‘ pydio ‘ para garantir permissão e privilégios ao banco de dados ‘ cells ‘.

SHOW GRANTS FOR 'pydio'@'localhost';

Você pode ver abaixo que o banco de dados ‘ cells ‘ é acessível através do usuário ‘ pydio ‘.

check database

Digite ‘quit’ para sair do servidor MariaDB.

Baixando o Pydio Cells

Com o banco de dados MariaDB configurado, você está pronto para baixar o Pydio Cells. Nesta seção, você configurará o usuário ‘pydio’, baixará o Pydio Cells, configurará o diretório de instalação e as variáveis de ambiente, e permitirá que o Pydio Cells seja executado nas portas privilegiadas.

Crie um novo usuário e grupo ‘ pydio ‘ com o seguinte comando.

sudo useradd -m -s /bin/bash pydio

Crie novos diretórios ‘ /opt/pydio/bin ‘ e ‘ /var/cells ‘ com o comando abaixo. E então, mude a propriedade de ambos os diretórios para o usuário ‘ pydio ‘.

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

Agora crie um novo arquivo de env ‘ /etc/profile.d/cells-env.sh ‘ com o editor ‘ nano ‘.

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

Insira o seguinte script para configurar variáveis de ambiente para o Pydio Cells. Certifique-se de alterar o endereço ‘ CELLS_EXTRERNAL ‘ para corresponder ao nome de domínio da sua instalação do Pydio.

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

Quando terminar, salve e saia do arquivo.

Agora execute o comando abaixo para tornar o arquivo env ‘ /etc/profile.d/cells-env.sh ‘ executável.

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

Em seguida, execute o comando abaixo para baixar o arquivo binário do Pydio Cells para Linux para ‘ /opt/pydio/bin/cells ‘.

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

Uma vez baixado, execute o seguinte comando para tornar o arquivo binário ‘ cells ‘ executável e permitir que ele se vincule às portas privilegiadas.

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

Agora faça login como o usuário ‘ pydio ‘ com o seguinte:

su - pydio

Verifique as variáveis de ambiente para o Pydio Cells com o seguinte - Certifique-se de que a saída corresponda ao arquivo env ‘ /etc/profile.d/cells-env.sh ‘.

echo $CELLS_WORKING_DIR  
echo $CELLS_BIND  
echo $CELLS_EXTERNAL

check env

Por último, verifique a versão do ‘cells’ com o comando abaixo.

cells version

Na saída a seguir, você pode ver a versão do Pydio Cells.

check cells version

Instalando o Pydio Cells através da linha de comando

Agora você começará a instalar o Pydio Cells a partir da linha de comando. Com o comando ‘ cells ‘, você configurará a instalação do Pydio Cells com o banco de dados MariaDB, configurará o usuário e a senha do administrador e configurará o local de armazenamento para armazenar dados do usuário.

Para começar, execute o comando abaixo para configurar a instalação do Pydio Cells a partir do terminal.

cells configure --cli

Agora você será solicitado a fazer as seguintes configurações:

Conexão com o Banco de Dados: selecione via TCP, em seguida, insira os detalhes do seu host de banco de dados MariaDB, porta, usuário e senha.
Configuração do MongoDB: Digite n para não.
Configuração do Usuário Administrativo: insira seu usuário e senha de administrador para o Pydio Cells.
Localização de armazenamento padrão: pressione ENTER para usar o padrão e continuar.

Após o processo ser concluído, você verá a seguinte saída:

installing pydio cells

Configurando o arquivo de serviço systemd para o Pydio Cells

A partir da etapa anterior, você pode iniciar o Pydio Cells com o comando ‘cells start’. Para facilitar, você usará o ‘systemctl’ do systemd para gerenciar o serviço do Pydio Cells. Então agora você criará um novo arquivo de serviço systemd.

Crie um novo arquivo ‘/etc/systemd/system/cells.service’ com o editor ‘nano’.

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

Insira a configuração abaixo para executar o Pydio Cells como um serviço systemd. Certifique-se de alterar o ‘CELLS_EXTERNAL’ com seu nome de domínio.

[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  
  
# Adicione variáveis de ambiente  
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

Salve o arquivo e saia do editor.

Agora execute o comando abaixo para recarregar o gerenciador do systemd.

sudo systemctl daemon-reload

Por último, execute o comando ‘ systemctl ‘ abaixo para iniciar, habilitar e verificar o serviço ‘ cells ‘.

sudo systemctl enable --now cells  
sudo systemctl status cells

Nesta saída, você pode ver que o serviço ‘ cells ‘ está em execução em segundo plano como um serviço systemd.

systemd service

Configurando o Httpd como um proxy reverso

Neste ponto, os Pydio Cells estão em execução em seu servidor Alma Linux na porta ‘8080’. Para torná-lo acessível a partir do cliente, você criará um arquivo de host virtual Httpd como um proxy reverso para o servidor Pydio Cells. Você também gerará certificados SSL/TLS do Letsencrypt para proteger a transferência de dados entre o cliente e o servidor Pydio Cells.

Primeiro, execute o comando ‘ dnf ‘ abaixo para instalar ‘certbot’ em seu sistema.

sudo dnf install certbot -y

Agora crie um novo diretório raiz da web fictício e mude a propriedade para o usuário ‘ apache ‘.

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

Execute o comando ‘ certbot ‘ abaixo para gerar certificados SSL/TLS para o Pydio Cells. Certifique-se de alterar o endereço de e-mail e o nome de domínio com suas informações.

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

Em seguida, crie uma nova configuração de host virtual Httpd ‘ /etc/httpd/conf.d/pydio.conf ‘ com o editor ‘ nano ‘.

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

Insira a configuração abaixo e certifique-se de alterar a opção ‘ ServerName ‘ com seu nome de domínio.

  
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  
  
# esteja ciente disso  
# Permitir proxy reverso via certificados autoassinados  
SSLProxyEngine On  
SSLProxyVerify none  
SSLProxyCheckPeerCN off  
SSLProxyCheckPeerName off  
SSLProxyCheckPeerExpire off  
  
## A ordem das diretivas importa.  
# Se o Cells não estiver em execução com https, considere usar ws em vez de wss  
ProxyPassMatch "/ws/(.*)" wss://localhost:8080/ws/$1 nocanon  
  
## Esta condição de reescrita é necessária se usar 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

Salve o arquivo e saia do editor quando terminar.

Agora execute o comando ‘ apachectl ‘ abaixo para verificar sua sintaxe do Apache. Se você tiver uma configuração adequada do Apache, verá uma saída ‘ Syntax is OK ‘.

sudo apachectl configtest

Por último, execute o comando ‘systemctl’ abaixo para reiniciar o servidor web ‘ httpd ‘ e aplicar suas alterações. Com isso, sua instalação do Pydio Cells deve estar concluída e acessível.

sudo systemctl restart httpd

setup httpd

Acessando o Pydio Cells

Abra seu navegador web e visite o nome de domínio da sua instalação do Pydio Cells, como https://cells.howtoforge.local. Se a instalação for bem-sucedida, você verá a página de login do Pydio Cells.

Insira seu usuário e senha de administrador para fazer login.

Se você tiver as credenciais corretas, verá o painel do usuário do Pydio Cells como o seguinte.

pydio dashboard

A partir daqui, você pode tentar fazer upload de arquivos do seu computador local para o servidor Pydio Cells. Na captura de tela a seguir, eu fiz upload de arquivos para o Pydio Cells e tive sucesso.

pydio upload files

Conclusão

Parabéns! Você concluiu a instalação do Pydio Cells no servidor Alma Linux 9. Você tem o Pydio Cells em execução com o servidor de banco de dados MariaDB e o servidor web Httpd. Além disso, você também protegeu a instalação do Pydio Cells com HTTPS através do Certbot e Letsencrypt.