Ubuntu 24.04에 ONLYOFFICE Docs 설치하는 방법

ONLYOFFICE Docs 또는 Document Server는 로컬 서버에 설치할 수 있는 온라인 오피스 제품군입니다. ONLYOFFICE Collaboration 플랫폼과 Nextcloud, OwnCloud, WordPress, Drupal, Odoo, SuiteCRM 등과 같은 인기 시스템을 지원합니다. ONLYOFFICE Document Server는 문서 편집기, 스프레드시트 편집기, 프레젠테이션 편집기 및 협업 편집기로 사용할 수 있습니다. 모든 인기 있는 형식(DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX 및 HTML)을 지원합니다.

이 가이드는 PostgreSQL을 데이터베이스로, Nginx를 리버스 프록시로 사용하여 Ubuntu 24.04 서버에 ONLYOFFICE Document Server를 배포하는 방법을 보여줍니다. 또한 Certbot과 Letsencrypt를 통해 ONLYOFFICE Docs를 HTTPS로 보호합니다.

필수 조건

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

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

PostgreSQL 및 RabbitMQ 설치

ONLYOFFICE Document Server는 Ubuntu 서버에 PostgreSQL 및 RabbitMQ가 설치되어 있어야 합니다. 이제 공식 Ubuntu 리포지토리를 통해 PostgreSQL 및 RabbitMQ 서버를 설치할 것입니다.

먼저, 패키지 인덱스를 업데이트하려면 다음 명령을 실행하세요.

sudo apt update

이제 아래 명령을 사용하여 공식 Ubuntu 리포지토리를 통해 PostgreSQL 및 RabbitMQ 서버를 설치합니다. 설치를 확인하려면 ‘Y’를 입력하세요.

sudo apt install postgresql rabbitmq-server

설치가 완료되면 아래 ‘systemctl’ 명령을 사용하여 PostgreSQL 서버를 확인하세요.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

아래에서 PostgreSQL의 상태가 active 및 exited임을 확인할 수 있습니다.

마지막으로 다음 명령으로 RabbitMQ 서버를 확인하세요.

sudo systemctl is-enabled rabbitmq-server  
sudo systemctl status rabbitmq-server

다음과 같이 RabbitMQ 서버도 running 상태입니다.

PostgreSQL 데이터베이스 및 사용자 생성

PostgreSQL과 Rabbit가 실행 중이면 ONLYOFFICE Docs에서 사용할 새로운 PostgreSQL 데이터베이스와 사용자를 생성합니다. 이 예제에서는 명령줄을 사용하여 PostgreSQL 데이터베이스와 사용자를 생성합니다.

아래 명령을 실행하여 비밀번호 ‘ onlyoffice ‘로 새로운 PostgreSQL 사용자 ‘ onlyoffice ‘를 생성합니다.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"

이제 아래와 같이 기본 소유자 ‘ onlyoffice ‘로 새로운 데이터베이스 ‘ onlyoffice ‘를 생성합니다.

sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

마지막으로 아래 명령을 사용하여 PostgreSQL 서버의 사용자 및 데이터베이스 목록을 확인합니다.

sudo -i -u postgres psql -c "\du"  
sudo -i -u postgres psql -c "\l"

아래에서 사용자 ‘ onlyoffice ‘와 데이터베이스 ‘ onlyoffice ‘가 사용 가능함을 확인할 수 있습니다.

ONLYOFFICE Document Server 설치

이제 PostgreSQL 데이터베이스와 RabbitMQ 서버가 준비되었으므로 ONLYOFFICE Document Server 설치를 시작할 수 있습니다. 여기서는 ONLYOFFICE GPG 키와 리포지토리를 추가한 후 APT 패키지 관리자를 통해 Document Server를 설치합니다.

아래와 같이 ONLYOFFICE의 GPG 키를 Ubuntu 시스템에 다운로드합니다.

curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/onlyoffice.gpg

이제 아래 명령을 실행하여 Debian/Ubuntu 시스템에 ONLYOFFICE 리포지토리를 추가합니다.

echo "deb [signed-by=/etc/apt/trusted.gpg.d/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

다음으로 Ubuntu 패키지 인덱스를 업데이트하고 새로 고친 후 아래 명령으로 ‘ onlyoffice-documentserver ‘ 패키지를 설치합니다. 기본적으로 ONLYOFFICE는 리버스 프록시로 사용할 Nginx 웹 서버도 설치합니다.

sudo apt update && sudo apt install onlyoffice-documentserver

설치를 진행하려면 ‘ Y ‘를 입력하세요.

PostgreSQL 데이터베이스 비밀번호 ‘ onlyoffice ‘를 입력하세요.

TTF mscorefont 라이센스를 수락하려면 OK를 선택하세요.

EULA 라이센스 조건을 수락하려면 Yes를 선택하세요.

설치가 완료되면 ONLYOFFICE Document Server가 기본 HTTP 포트 80에서 Nginx 웹 서버와 함께 실행됩니다.

아래 명령으로 Nginx 웹 서버 상태를 확인하세요.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Nginx 웹 서버가 실행 중임을 확인할 수 있습니다.

UFW(간단한 방화벽) 설정

이 섹션에서는 UFW(간단한 방화벽)를 활성화하고 SSH, HTTP 및 HTTPS 프로토콜에 대한 포트를 엽니다.

UFW를 활성화하기 전에 아래 명령을 실행하여 ‘ OpenSSH ‘ 및 ‘ Nginx Full ‘ 프로필을 추가합니다. 이렇게 하면 SSH, HTTP 및 HTTPS에 대해 포트 22가 열립니다.

sudo ufw allow OpenSSH  
sudo ufw allow 'Nginx Full'

이제 아래 명령을 실행하여 UFW를 활성화합니다. 진행하려면 ‘ y ‘를 입력하면 Firewall is active and enabled on system startup라는 출력이 표시됩니다.

sudo ufw enable

마지막으로 아래 명령으로 UFW 상태를 확인합니다.

sudo ufw status

아래에서 UFW의 상태가 active이며 ‘ OpenSSH ‘ 및 ‘ Nginx Full ‘ 프로필이 활성화되어 있음을 확인할 수 있습니다.

HTTPS로 ONLYOFFICE Document Server 보호

UFW가 구성되었으므로 Certbot과 Letsencrypt를 통해 ONLYOFFICE Document Server를 HTTPS로 보호합니다. 도메인 이름이 준비되어 있고 Ubuntu 서버 IP 주소를 가리키고 있는지 확인하세요. ONLYOFFICE Document Server를 로컬에 설치하는 경우 자체 서명된 인증서를 사용할 수 있습니다.

먼저 아래 ‘ systemctl ‘ 명령을 실행하여 Nginx 웹 서버를 중지합니다.

sudo systemctl stop nginx

이제 아래 ‘ apt ‘ 명령으로 Certbot을 설치합니다. Certbot은 Letsencrypt에서 무료 SSL/TLS 인증서를 생성하는 데 사용됩니다.

sudo apt install certbot -y

설치가 완료되면 아래 ‘ certbot ‘ 명령을 실행하여 ONLYOFFICE Document Server 설치를 위한 새로운 SSL 인증서를 생성합니다. 도메인 이름과 이메일 주소를 자신의 정보로 변경해야 합니다.

sudo certbot certonly --standalone -m [email protected] --agree-tos --no-eff-email -d office.howtoforge.local

프로세스가 완료되면 인증서는 ‘ /etc/letsencrypt/live/domain.com ‘ 디렉토리에 저장됩니다. 공개 키에 대한 ‘ fullchain.pem ‘, 개인 키에 대한 ‘ privkey.pem ‘이 있습니다.

다음으로 ONLYOFFICE의 기본 Nginx 템플릿을 ‘ /etc/onlyoffice/documentserver/nginx/ds.conf ‘ 파일로 복사합니다.

sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf

아래 ‘ nano ‘ 편집기 명령으로 ‘ /etc/onlyoffice/documentserver/nginx/ds.conf ‘를 편집합니다.

sudo nano /etc/onlyoffice/documentserver/nginx/ds.conf

‘ ssl_certificate ‘를 ‘ fullchain.pem ‘ 인증서의 경로로 변경하고, ‘ ssl_certificate_key ‘를 ‘ privkey.pem ‘ 인증서의 경로로 변경합니다.

ssl_certificate /etc/letsencrypt/live/office.howtoforge.local/fullchain.pem;  
ssl_certificate_key /etc/letsencrypt/live/office.howtoforge.local/privkey.pem;

작업이 완료되면 파일을 저장하고 편집기를 종료합니다.

이제 아래 명령을 실행하여 Nginx 구문을 확인하고 오류가 없는지 확인합니다. 그런 다음 ‘ systemctl ‘ 명령으로 Nginx 웹 서버를 다시 시작합니다.

sudo nginx -t  
sudo systemctl start nginx

올바른 Nginx 구문이 있으면 ‘ test is successful - syntax is OK ‘와 같은 출력이 표시됩니다.

마지막으로 아래 스크립트를 실행하여 ONLYOFFICE Document Server에 HTTPS를 적용합니다. 이렇게 하면 ONLYOFFICE가 안전한 HTTPS 연결에서 실행됩니다.

sudo bash /usr/bin/documentserver-update-securelink.sh

ONLYOFFICE Document Server 설치 확인

도메인 이름인 https://office.howtoforge.local/를 방문하여 ONLYOFFICE Document Server 설치에 접근합니다. 성공적으로 설치되면 ONLYOFFICE Docs Community Edition이 설치되었다는 확인 메시지가 표시됩니다.

여기에서 ONLYOFFICE Document Server를 Nextcloud 및 ownCloud와 같은 파일 서버, WordPress 및 Drupal과 같은 CMS, Odoo 및 SuiteCRM과 같은 CRM에 통합할 수 있습니다.

결론

축하합니다! Ubuntu 24.04 서버에 ONLYOFFICE Document Server 설치를 완료했습니다. PostgreSQL 데이터베이스와 Nginx 웹 서버와 함께 ONLYOFFICE Document Server가 실행되고 있습니다. 마지막으로 Certbot과 Letsencrypt를 통해 ONLYOFFICE를 HTTPS로 보호했습니다.