설치 가이드 · 6 min read · Sep 21, 2025

AlmaLinux 9에 Pydio Cells 설치하는 방법

Pydio Cells는 귀하의 조직을 위한 오픈 소스 문서 공유 및 협업 플랫폼입니다. 이를 통해 귀하의 조직 내에서 문서 및 파일을 공유할 수 있으며, 문서 공유 환경에 대한 완전한 제어를 제공합니다.

Pydio Cells는 성능이 빠르고, 대용량 파일 전송을 처리할 수 있으며, 고급 워크플로 자동화를 제공합니다.

이 가이드에서는 Alma Linux 9 서버에 Pydio Cells를 설치하는 방법을 보여줍니다. MariaDB 데이터베이스 서버와 Httpd 웹 서버와 함께 Pydio Cells를 설치하게 됩니다.

전제 조건

이 가이드를 시작하기 전에 다음 사항을 확인하십시오:

  • Alma Linux 9 서버
  • 관리자 권한이 있는 비루트 사용자
  • 서버 IP 주소를 가리키는 도메인 이름
  • 상태가 활성화되고 허용된 SELinux

의존성 설치

Pydio Cells를 설치하기 전에 Alma Linux 서버에 의존성을 설치해야 합니다. 여기에는 EPEL 리포지토리, MariaDB 데이터베이스 서버, Httpd 웹 서버 및 wget, nano와 같은 일부 시스템 도구가 포함됩니다.

먼저, 아래의 ‘dnf‘ 명령을 실행하여 EPEL 리포지토리를 추가하고 MariaDB 서버와 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‘ 포트를 엽니다. 그런 다음 방화벽 규칙을 다시 로드하여 변경 사항을 적용합니다.

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

MariaDB 서버 구성

의존성을 설치한 후에는 MariaDB 서버 설치를 보호하고 Pydio Cells 서버 설치를 위한 새 데이터베이스와 사용자를 생성해야 합니다. ‘mariadb-secure-installation‘ 명령으로 MariaDB를 보호하고, ‘mariadb‘ 클라이언트를 통해 새 데이터베이스와 사용자를 생성합니다.

MariaDB 서버 설치를 보호하려면 아래의 ‘mariadb-secure-installation‘ 명령을 실행하십시오.

sudo mariadb-secure-installation

과정 중에 다음 구성에 대해 질문을 받게 됩니다:

  • 로컬 인증을 unix_socket으로 전환하시겠습니까? n을 입력하십시오.
  • 새 MariaDB 루트 비밀번호를 설정하십시오. y를 입력하여 확인한 후 MariaDB 서버 배포를 위한 새 비밀번호를 입력하십시오.
  • 익명 사용자를 제거하시겠습니까? y를 입력하여 확인하십시오.
  • 배포에서 기본 데이터베이스 테스트를 제거하시겠습니까? y를 입력하여 확인하십시오.
  • 원격 연결에서 MariaDB 루트 로그인을 금지하시겠습니까? y를 입력하여 확인하십시오.
  • 테이블 권한을 다시 로드하고 변경 사항을 적용하십시오. y를 입력하고 ENTER를 누르십시오.

이제 MariaDB 서버가 보호되었으므로 Pydio Cells 설치를 위한 새 데이터베이스와 사용자를 생성합니다.

아래의 ‘mariadb‘ 명령으로 MariaDB 서버에 로그인하십시오. 프롬프트가 표시되면 MariaDB 루트 비밀번호를 입력하십시오.

sudo mariadb -u root -p

다음 쿼리를 실행하여 새 데이터베이스 ‘cells‘와 비밀번호 ‘p4ssw0rd’를 가진 새 사용자 ‘pydio‘를 생성합니다. 필요에 따라 데이터베이스 세부정보를 조정할 수 있습니다.

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';

아래에서 ‘pydio‘ 사용자가 ‘cells‘ 데이터베이스에 접근할 수 있는 것을 확인할 수 있습니다.

check database

‘MariaDB’ 서버에서 나가려면 ‘quit’를 입력하십시오.

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

이제 ‘nano‘ 편집기로 새 env 파일 ‘/etc/profile.d/cells-env.sh‘를 생성합니다.

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 바이너리 파일을 ‘/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‘ 명령을 사용하여 MariaDB 데이터베이스와 함께 Pydio Cells 설치를 설정하고, 관리자 사용자 및 비밀번호를 설정하며, 사용자 데이터를 저장할 저장소 위치를 설정합니다.

시작하려면 아래의 명령을 실행하여 터미널에서 Pydio Cells 설치를 구성합니다.

cells configure --cli

이제 다음 구성에 대한 프롬프트가 표시됩니다:

  • 데이터베이스 연결: TCP를 통해 선택한 후 MariaDB 데이터베이스 호스트, 포트, 사용자 및 비밀번호의 세부정보를 입력합니다.
  • MongoDB 구성: 아니오를 위해 n을 입력합니다.
  • 관리 사용자 구성: Pydio Cells의 관리자 사용자 및 비밀번호를 입력합니다.
  • 기본 저장소 위치: 기본값을 사용하려면 ENTER를 눌러 계속합니다.

과정이 완료되면 다음 출력을 볼 수 있습니다:

installing pydio cells

Pydio Cells를 위한 systemd 서비스 파일 설정

이전 단계에서 ‘cells start‘ 명령으로 Pydio Cells를 시작할 수 있습니다. 이를 더 쉽게 만들기 위해 systemd ‘systemctl‘을 사용하여 Pydio Cells 서비스를 관리할 것입니다. 따라서 이제 새 systemd 서비스 파일을 생성합니다.

‘nano‘ 편집기로 새 ‘/etc/systemd/system/cells.service’ 파일을 생성합니다.

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’에서 실행되고 있습니다. 클라이언트에서 접근할 수 있도록 Pydio Cells 서버에 대한 리버스 프록시로 Httpd 가상 호스트 파일을 생성할 것입니다. 또한 클라이언트와 Pydio Cells 서버 간의 데이터 전송을 보호하기 위해 Letsencrypt에서 SSL/TLS 인증서를 생성할 것입니다.

먼저, 아래의 ‘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‘ 명령을 실행하여 Pydio Cells에 대한 SSL/TLS 인증서를 생성합니다. 이메일 주소와 도메인 이름을 귀하의 정보로 변경해야 합니다.

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

다음으로, ‘nano‘ 편집기로 새 Httpd 가상 호스트 구성 ‘/etc/httpd/conf.d/pydio.conf‘를 생성합니다.

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 구성이면 ‘Syntax is OK‘라는 출력을 볼 수 있습니다.

sudo apachectl configtest

마지막으로 아래의 ‘systemctl‘ 명령을 실행하여 ‘httpd‘ 웹 서버를 재시작하고 변경 사항을 적용합니다. 이를 통해 Pydio Cells 설치가 완료되고 접근 가능해야 합니다.

sudo systemctl restart httpd

setup httpd

Pydio Cells 접근하기

웹 브라우저를 열고 Pydio Cells 설치의 도메인 이름인 https://cells.howtoforge.local을 방문하십시오. 설치가 성공적이라면 Pydio Cells 로그인 페이지가 표시됩니다.

관리자 사용자 및 비밀번호를 입력하여 로그인하십시오.

login pydio cells

정확한 자격 증명이 있는 경우 다음과 같은 Pydio Cells 사용자 대시보드가 표시됩니다.

pydio dashboard

여기에서 이제 로컬 컴퓨터에서 Pydio Cells 서버로 파일을 업로드해 볼 수 있습니다. 다음 스크린샷에서는 Pydio Cells에 파일을 업로드했으며 성공적이었습니다.

pydio upload files

결론

축하합니다! Alma Linux 9 서버에 Pydio Cells 설치를 완료했습니다. MariaDB 데이터베이스 서버와 Httpd 웹 서버와 함께 Pydio Cells가 실행되고 있습니다. 또한 Certbot과 Letsencrypt를 통해 HTTPS로 Pydio Cells 설치를 보호했습니다.

Share: X/Twitter LinkedIn
#설치 가이드

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.