회원가입   로그인
IMG-LOGO
공지사항 :

OnlyOffice Workspace 설치 및 설정

lmkfox - 2025-05-24 07:31:35 163 Views 0 Comment

OnlyOffice Workspace 설치 및 설정 방법 (전문가용)

1. 개요

OnlyOffice Workspace는 문서 협업, 프로젝트 관리, CRM, 메일, 캘린더, 커뮤니케이션 기능을 통합한 협업 플랫폼입니다. 자체 호스팅이 가능하며, Docker 기반 설치가 공식적으로 권장됩니다. 여기서는 Docker Compose 방식을 기준으로 설명합니다.

2. 시스템 요구사항

운영체제

  • Ubuntu 20.04 / 22.04 LTS (64bit)

  • Debian 10 이상

하드웨어 (100명 기준)

  • CPU: 4+ 코어

  • RAM: 8GB 이상

  • 디스크: 40GB 이상 (문서 저장소 포함)

  • 포트: 80, 443, 5222, 9888 등

3. 사전 준비

3.1 패키지 업데이트

sudo apt update && sudo apt upgrade -y

3.2 Docker & Docker Compose 설치

sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

3.3 Docker 권한 부여

sudo usermod -aG docker $USER
newgrp docker

4. OnlyOffice Workspace 설치

4.1 GitHub 저장소 클론

git clone https://github.com/ONLYOFFICE/Docker-CommunityServer.git onlyoffice
cd onlyoffice

4.2 docker-compose.yml 파일 구성

docker-compose.yml 파일은 포함되어 있으며, 필요시 수정 가능. 기본적으로 다음 컨테이너들이 설치됩니다:

  • Community Server (포털)

  • Document Server (문서 편집기)

  • Mail Server (옵션)

  • Control Panel

  • MySQL / Redis / RabbitMQ 등

4.3 설치 실행

sudo docker compose up -d

설치 완료 후, 서비스가 아래 포트에서 동작합니다:

  • 포털: http://<서버-IP>/

  • 문서 편집기: http://<서버-IP>/ds-vpath/

5. 초기 설정

웹 브라우저에서 접속:

http://<서버-IP>/

5.1 관리자 계정 생성

  • 이메일, 비밀번호 설정

  • 포털 이름 지정

5.2 도메인 설정 (기본 HTTP → HTTPS 권장)

SSL 인증서 적용은 Nginx Reverse Proxy 또는 Let’s Encrypt 자동화 스크립트 사용 가능

예시: Nginx + Let’s Encrypt (Certbot)

6. 포털 구성요소

  • 문서: Office 문서 작성 및 협업 (Word, Excel, PowerPoint 호환)

  • 이메일: SMTP/IMAP 기반 메일 서버 연동

  • CRM: 고객 및 판매 관리

  • 프로젝트: 간트 차트 기반 일정/업무 관리

  • 커뮤니케이션: 채팅, 포럼, 뉴스, 커뮤니티

  • 캘린더: 개인/공유 일정 관리

7. SSL 적용 (Let’s Encrypt 기준)

sudo apt install certbot
sudo certbot certonly --standalone -d your-domain.com

SSL 키 적용 예 (Nginx 사용 시):

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;

    location / {
        proxy_pass http://localhost:80;
        include proxy_params;
    }
}

8. 사용자 및 역할 설정

사용자 추가

  1. 관리 콘솔 접속

  2. 사용자 > 사용자 추가

  3. 부서 지정 및 역할 설정

권한 설정

  • 문서 권한: 읽기/쓰기/공유

  • 프로젝트 권한: 관리자/편집자/참여자

  • CRM 권한: 읽기/추가/편집/삭제 등 상세 지정 가능

9. 외부 연동 (선택)

LDAP/Active Directory 연동

  • Admin > 설정 > LDAP

  • 서버 주소, DN, Base DN, 인증 방식 설정

  • 주기적 동기화 가능

메일 서버 연동

  • 자체 메일 서버 구성 또는 외부 SMTP (예: Gmail, Naver, Zoho 등) 연동

외부 스토리지 연동

  • WebDAV, Google Drive, Dropbox, OneDrive, Nextcloud 등과 연동 가능

10. 장점과 단점

장점

  • 자체 호스팅 가능 → 데이터 소유권 확보

  • MS Office와 높은 호환성 (OOXML 기반)

  • 협업 툴 통합 (문서, 채팅, 일정, 프로젝트 등)

  • Docker 기반 손쉬운 배포

  • Web 기반으로 클라이언트 설치 불필요

단점

  • 초기 설치 시 리소스 소모 및 설정 복잡

  • 고급 기능은 Enterprise Edition에서 제공 (예: SSO, 다중 인증 등)

  • 대규모 사용자는 성능 튜닝 필요 (메모리 캐시, 부하분산 등)

  • 사용자 한글 입력 환경 일부 브라우저에서 이슈 가능

11. 유지관리

서비스 상태 확인

docker compose ps

서비스 재시작

docker compose restart

백업 (MySQL 기준)

docker exec onlyoffice-mysql mysqldump -u root -p onlyoffice > backup.sql

댓글