OnlyOffice를 Docker Compose로 손쉽게 구축하는 완벽 가이드 🚀

도커 컴포즈(Docker Compose)로 OnlyOffice를 구축하면 문서 협업 시스템을 단 5분 만에 구성할 수 있습니다! 📄✍️ 이 가이드에서는 컨테이너 기반 OnlyOffice 구축의 모든 것을 상세히 설명합니다.

🔍 OnlyOffice란?

오픈소스 기반의 통합 오피스 솔루션으로:

• 실시간 문서 협업 (워드/스프레드시트/프레젠테이션)
• MS Office 호환 (docx, xlsx, pptx)
• 클라우드 스토리지 연동 (Nextcloud, OwnCloud 등)
• 모바일 지원

⚙️ 필수 사전 준비물

1. Docker 및 Docker Compose 설치 완료

   # 설치 확인
   docker --version && docker-compose --version

2. 4GB 이상의 메모리 (공식 권장 사양)
3. 80/443 포트 개방 (혹은 커스텀 포트 사용)

🐳 Docker Compose 파일 분석 (with 주석)

version: '3'  # Docker Compose 버전

services:
  onlyoffice:
    image: onlyoffice/documentserver:7.4  # 공식 이미지
    container_name: onlyoffice_ds
    restart: unless-stopped  # 자동 재시작 설정
    ports:
      - "8000:80"  # 호스트:컨테이너 포트 매핑
      - "8443:443"  # HTTPS 사용 시
    volumes:
      - ./onlyoffice_data:/var/www/onlyoffice/Data  # 설정 파일 저장
      - ./onlyoffice_logs:/var/log/onlyoffice  # 로그 저장
    environment:
      - JWT_ENABLED=true  # 보안 토큰 활성화
      - JWT_SECRET=my_super_secret_key  # 토큰 생성용 시크릿 키
      - DB_TYPE=postgres  # 데이터베이스 종류
    depends_on:
      - postgres

  postgres:  # OnlyOffice 전용 DB
    image: postgres:13
    container_name: onlyoffice_db
    restart: unless-stopped
    volumes:
      - ./pg_data:/var/lib/postgresql/data  # DB 데이터 영구 저장
    environment:
      POSTGRES_DB: onlyoffice
      POSTGRES_USER: onlyoffice
      POSTGRES_PASSWORD: onlyoffice_pass

🛠️ 단계별 구축 가이드

1. 작업 디렉토리 생성

   mkdir onlyoffice && cd onlyoffice

2. docker-compose.yml 파일 생성
   상단의 예제 내용을 복사하여 저장

3. 서비스 실행 🚀

   docker-compose up -d

   (이미지: 컨테이너 실행 화면)

4. 초기화 확인

   docker-compose logs -f  # 로그 모니터링

🔑 핵심 환경 변수 설정

🌐 OnlyOffice 접속 및 테스트

1. 웹 브라우저에서 http://서버IP:8000 접속
2. Welcome 페이지 확인
3. 테스트 문서 편집:

   http://서버IP:8000/example

⚠️ 트러블슈팅 핵심 Tip

1. 문서 저장 안 됨
   → 볼륨 마운트 권한 확인: chmod -R 755 ./onlyoffice_data
2. “Document Server is not responding”
   → DB 컨테이너 정상 실행 확인: docker-compose ps
3. HTTPS 오류
   → Nginx 리버스 프록시 추천 설정:

   location / {
     proxy_pass http://localhost:8000;
     proxy_set_header Host $host;
   }

💡 고급 설정 팁

1. Let’s Encrypt 연동
   - "443:443" 포트 매핑 후 certbot 사용
2. 클라우드 스토리지 연동
   Nextcloud 연동 시 APP_URL 환경 변수 설정
3. 백업 전략
   ./onlyoffice_data, ./pg_data 디렉토리 주기적 백업

✅ 결론: 왜 Docker로 OnlyOffice인가?

1. 5분 초고속 배포 ⏱️
2. 업데이트 간편성 → docker-compose pull && docker-compose up -d
3. 호환성 문제 제로 �
4. 리소스 효율성 (기존 VM 대비 70% ↓ 리소스 사용)

> “도커 컴포즈로 구축하는 OnlyOffice는 중소기업부터 대학교 캠퍼스 솔루션까지 모든 규모에 적합한 현대적 문서 협업 플랫폼입니다!”

이제 여러분의 OnlyOffice 서버를 시작해보세요! 🎉 컨테이너 기반 오피스 환경이 어떻게 업무 방식을 혁신하는지 직접 체험하실 수 있습니다. D