설치 가이드 · 6 min read · Dec 15, 2025

우분투 24.04 서버에 Pydio Cells 설치하는 방법

Pydio Cells는 자체 호스팅 문서 공유 및 협업 플랫폼입니다. 이 플랫폼은 문서 공유 환경에 대한 완전한 제어를 제공합니다. Pydio Cells는 빠른 성능을 제공하며, 대용량 파일 전송을 처리하고, 고급 워크플로 자동화를 제공합니다.

이 가이드에서는 MariaDB 데이터베이스와 Apache를 리버스 프록시로 사용하여 우분투 24.04 서버에 Pydio Cells를 설치하는 방법을 안내합니다.

필수 조건

시작하기 전에 다음 사항을 확인하세요:

  • 우분투 24.04 서버.
  • 관리자 권한이 있는 비루트 사용자.
  • 서버 IP 주소를 가리키는 도메인 이름.

의존성 설치

Pydio Cells를 설치하기 전에 우분투 시스템에 의존성을 설치해야 합니다. 여기에는 MariaDB 데이터베이스 서버와 Apache 웹 서버가 포함됩니다.

먼저, 다음 apt 명령어를 실행하여 우분투 패키지 인덱스를 업데이트하고 Pydio Cells의 의존성을 설치합니다. 이 명령어를 사용하면 Apache 웹 서버, MariaDB 데이터베이스 서버 및 SSL/TLS 인증서를 생성하기 위한 Certbot이 설치됩니다.

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-secure-installation 유틸리티로 MariaDB를 보안합니다. 그런 다음 Pydio Cells를 위한 새로운 데이터베이스와 사용자를 생성합니다.

MariaDB 서버 설치를 보안하기 위해 아래의 mariadb-secure-installation 명령어를 실행합니다.

sudo mariadb-secure-installation

다음과 같은 MariaDB 서버 구성에 대한 질문이 표시됩니다:

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

이제 아래의 mariadb 클라이언트 명령어를 실행하여 MariaDB 서버에 로그인합니다. 프롬프트가 표시되면 루트 비밀번호를 입력합니다.

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 데이터베이스, 사용자 및 비밀번호를 입력합니다.
  • MongoDB 지원에 대해 N을 입력합니다. 이 경우 단일 Pydio Cells를 빌드하고 설치합니다.
  • 기본 저장소 구성을 사용하려면 ENTER를 누릅니다.
  • Pydio Cells 설치를 위한 새로운 관리자 사용자, 이메일 주소 및 비밀번호를 입력합니다.

setup pydio

설치가 완료되면 Installation finished라는 메시지가 표시됩니다.

pydio cells installed

Pydio Cells를 systemd 서비스로 실행

이 섹션에서는 Pydio Cells를 위한 systemd 서비스 파일을 생성하고 설정합니다. 이를 통해 systemctl 명령어로 Pydio Cells를 쉽게 관리할 수 있습니다.

nano 편집기로 새로운 서비스 파일 /etc/systemd/system/cells.service를 생성합니다.

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 서비스로 실행된 후, Pydio Cells를 위한 리버스 프록시로 새로운 Apache 가상 호스트 파일을 생성합니다. 또한 a2enmod 명령어로 Apache 모듈을 활성화해야 합니다.

먼저, 아래의 a2enmod 명령어를 실행하여 Apache 모듈을 활성화합니다. 이 경우 SSL 및 리버스 프록시 모듈을 활성화합니다.

sudo a2enmod rewrite ssl proxy proxy_http proxy_wstunnel http2 proxy_http2

enable modules

이제 아래의 nano 명령어로 새로운 가상 호스트 파일 /etc/apache2/sites-available/cells.conf를 생성합니다.

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

아래 구성을 삽입하여 Pydio Cells를 위한 리버스 프록시로 Apache를 설정합니다. ServerName 옵션을 대상 도메인 이름으로 변경해야 합니다.


    ServerName cells.howtoforge.local

    AllowEncodedSlashes On
    RewriteEngine On

    # 이 점에 유의하세요
    # 자체 서명된 인증서를 통한 리버스 프록시 허용
    SSLProxyEngine On
    SSLProxyVerify none 
    SSLProxyCheckPeerCN off
    SSLProxyCheckPeerName off
    SSLProxyCheckPeerExpire off

    ## 지시문의 순서가 중요합니다.
    # Cells가 https로 실행되지 않는 경우, wss 대신 ws를 사용하는 것을 고려하세요
    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 구성이면 Syntax is OK라는 출력을 볼 수 있습니다.

sudo a2ensite cells.conf
sudo apachectl configtest

마지막으로, 아래의 systemctl 명령어를 실행하여 Apache 웹 서버를 재시작하고 변경 사항을 적용합니다.

sudo systemctl restart apache2

setup apache

HTTPS로 Pydio Cells 보안 설정

Pydio Cells는 HTTPS를 통해 접근할 수 있습니다. 따라서 Apache 가상 호스트 파일에서 HTTPS를 활성화해야 합니다. 이 섹션에서는 certbot을 사용하여 Pydio Cells 설치를 보안하기 위한 SSL/TLS 인증서를 생성합니다.

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

결론

축하합니다! 우분투 24.04 서버에 Pydio Cells 설치를 완료했습니다. MariaDB 데이터베이스 서버와 Apache를 리버스 프록시로 사용하여 Pydio Cells를 실행 중입니다. 마지막으로, Certbot과 Letsencrypt를 통해 Pydio Cells를 HTTPS로 보안했습니다.

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

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

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