ONLYOFFICE 설치 및 Docker 자동화 가이드
개요
ONLYOFFICE는 CRM, 프로젝트·문서 관리, 협업 도구, 캘린더 및 메일 기능이 통합된 기업용 오피스 제품군입니다. 핵심 구성 요소는 다음 세 가지 서버로 구성됩니다:
- Community Server: People, Projects, CRM, Documents, Community, 메일 클라이언트, 캘린더, 채팅 등 8개 모듈 제공
- Document Server: 텍스트·스프레드시트·프레젠테이션 온라인 편집기 — 실시간 공동 편집, 버전 이력 추적 지원
- Mail Server: 메일 송수신 및 관련 기능
이 가이드는 Docker 기반 자동 설치 스크립트를 사용해 서버를 한 번에 구성하는 방법을 설명합니다.
주요 변경 사항 요약
- Community Server 9.0: DocuSign 전자서명 통합, 공유창 재설계(자동 생성 짧은 링크), 버전 이력에서 이전 버전 복원, 프로젝트의 작업·토론 섹션 개선, 작업 및 하위 작업 복사 기능.
- Document Server 4.3: 각주 추가·편집, 빠른 공동 편집 모드에서 실행 취소(undo) 지원, 맞춤법 검사기 언어 추가, 스프레드시트에 새 수식·테두리 스타일·특수 붙여넣기 추가.
중요: 제품 업데이트는 기능과 API에 영향을 줄 수 있으므로 프로덕션 환경에 적용 전 테스트 환경에서 검증하세요.
시스템 요구사항 및 의존성
하드웨어 권장사양
- CPU: 듀얼 코어 2 GHz 이상
- RAM: 최소 6 GB (운영 상황에 따라 더 필요)
- 디스크: 최소 40 GB의 여유 공간
- 스왑: 최소 6 GB 권장
소프트웨어 요구사항
- 운영체제: amd64 아키텍처의 Linux 배포판, 커널 버전 3.10 이상
- Docker: 1.10 이상
참고: 컨테이너 기반 배포에서는 Docker 및 Docker Compose 버전이 안정적이어야 하며, 방화벽·네트워크 설정(포트 포워딩 등)을 사전에 확인하세요.
설치 전 확인 체크리스트
- 서버에 루트 또는 sudo 권한이 있는 계정이 있는가
- 방화벽에서 80, 443, SMTP(25/587) 등 필요한 포트가 열려 있는가
- 도메인과 DNS가 서버 IP로 올바르게 매핑되어 있는가(메일 서버 설치 시 필수)
- Docker가 설치되어 있고 실행 중인가
ONLYOFFICE 자동 설치 (Docker 스크립트)
터미널 열기: Ctrl+Alt+T(또는 SSH로 서버 접속)
설치 스크립트 다운로드:
wget http://download.onlyoffice.com/install/opensource-install.sh- 온라인 문서 편집기를 포함해 기본 서버만 설치하려면:
bash opensource-install.sh -ims false- 메일 서버도 함께 설치하려면(도메인 이름 지정):
bash opensource-install.sh -md "yourdomain.com"명령어 실행 시 Docker 컨테이너들이 자동으로 생성되고, 필요한 의존성이 설치됩니다. 설치 로그를 확인하며 오류가 발생하면 아래 문제 해결 섹션을 참고하세요.
웹 오피스 접속
설치 완료 후 웹 브라우저에서 서버의 IP 주소 또는 호스트명(예: https://your-server.example.com)을 입력해 접속합니다. 초기화 과정은 시스템 성능에 따라 시간이 걸릴 수 있습니다. 초기 설정 시 이메일과 비밀번호를 지정하면 다음 로그인부터 해당 계정으로 접속할 수 있습니다.
Important: 초기화가 진행 중인 동안 브라우저에서 중복으로 요청을 보내면 설정이 꼬일 수 있으니 한 번만 요청하세요.
대안 설치 방법
- 수동 Docker Compose: 자동 스크립트 대신 공식 Docker 이미지와 docker-compose.yml을 내려받아 직접 환경 변수를 관리하며 구성할 수 있습니다. 더 세밀한 설정과 스케일링 작업에 적합합니다.
- 패키지 기반 설치(소스/배포판 제공 시): 컨테이너 사용이 불가한 환경에서 고려하세요. 종속성 관리가 더 복잡합니다.
언제 수동 설치를 고려할까: 클러스터 환경, 고가용성(HA), 로드밸런싱, 외부 데이터베이스 연동 등 맞춤형 설정이 필요할 때
문제 발생 시 빠른 해결 가이드
- 설치 스크립트 실패
- 로그 파일을 확인: 설치 중 표시되는 오류 메시지와 /var/log 또는 스크립트가 생성한 로그 경로를 점검
- 네트워크 제한: wget이 실패하면 프록시 또는 방화벽 설정을 확인
- 서비스가 기동하지 않을 때
- Docker 컨테이너 상태 확인: docker ps -a
- 컨테이너 로그 확인: docker logs
- 포트 충돌: 이미 사용 중인 포트가 있는지 확인
- 메일 송수신 실패
- DNS의 MX, SPF, DKIM 레코드 확인
- 포트 차단 여부(특히 25번) 검사
- 에디터 동기화/공동편집 문제
- Document Server 컨테이너가 정상인지 확인
- 방화벽에서 WebSocket(또는 관련 포트)이 차단되어 있지 않은지 확인
역할별 체크리스트
관리자
- 서버 백업 정책 수립 및 정기 테스트
- SSL/TLS 인증서 발급 및 갱신 자동화
- 모니터링(리소스, 컨테이너 상태) 설정
운영팀
- 로그 중앙화(예: ELK/Fluentd) 구성
- 장애 시 롤백 절차 문서화
보안팀
- 외부 접근 제어(방화벽, WAF) 적용
- 메일 보안(DKIM, SPF, DMARC) 설정
사용자
- 초기 계정 생성 및 권한 분배
- 문서 저장 정책 교육
보안 강화 권장 항목
- HTTPS 강제 적용: Let’s Encrypt 또는 상용 인증서 사용
- 관리자 콘솔 접근 IP 제한 또는 VPN 통제
- 정기 보안 업데이트 및 컨테이너 이미지 갱신
- 최소 권한 원칙 적용: 서비스 계정에 불필요한 권한 부여 금지
운영 SOP(간단한 플레이북)
- 새로운 버전 배포 전: 스테이징 환경에서 롤아웃 테스트
- 배포 윈도우 설정(업무 영향 최소화)
- 백업 실행(데이터베이스, 파일 스토리지)
- 컨테이너 이미지 풀/교체 및 서비스 재시작
- 건강 체크(서비스 응답 확인) 후 모니터링 경보 관찰
- 문제가 발생하면 이전 백업으로 롤백
수용 기준
- 핵심 서비스(Community, Document, Mail)가 HTTPS로 접근 가능해야 함
- 공동편집이 기본 문서에서 정상 동작해야 함
- 메일 송수신 기본 테스트 통과
유지보수 및 업그레이드 권장 절차
- 정기 백업: 하루 단위 또는 변경이 많은 시스템은 더 빈번하게
- 스냅샷 정책: 주요 마이그레이션 전 VM/디스크 스냅샷 생성
- 업그레이드 전 릴리스 노트 확인 후 단계적 적용
언제 자동 스크립트가 적합하지 않은가(실패 사례)
- 기존 레거시 인프라(특수 네트워크·스토리지)와 충돌하는 경우
- 맞춤형 인증(외부 SSO)·데이터베이스 연동이 필요한 환경
- 대규모 고가용성(클러스터, 분산 스토리지) 설계가 필요한 경우
이럴 때는 Docker Compose 수동 구성 또는 Kubernetes 기반 배포를 고려하세요.
요약
- ONLYOFFICE는 통합 오피스 및 협업 플랫폼으로, Docker 자동 설치 스크립트로 빠른 배포가 가능하다.
- 설치 전 하드웨어·소프트웨어 요구사항을 확인하고, 도메인·포트·DNS 설정을 준비하라.
- 자동 설치가 편리하지만, 맞춤형 확장·보안 요구사항이 있으면 수동 구성 또는 컨테이너 오케스트레이션을 선택하라.
핵심 포인트:
- 설치 명령: wget http://download.onlyoffice.com/install/opensource-install.sh 후 bash opensource-install.sh -ims false
- 메일 서버 포함 시: bash opensource-install.sh -md “yourdomain.com”
추가 자료
- 공식 문서: ONLYOFFICE 공식 문서를 참조해 고급 설정과 구성 옵션을 검토하세요.
- 소스 및 바이너리: onlyoffice.org
- 개발자 지원: dev.onlyoffice.org
