ONLYOFFICE Docs Enterprise를 공식 작성 파일을 사용하여 배포하세요.
엔터프라이즈 Docker Compose 스택을 시작하고, 라이선스와 데이터를 저장하고, JWT를 안전하게 구성하고, 편집기가 통합될 준비가 되었는지 확인합니다.
ONLYOFFICE Docs Enterprise를 공식 작성 파일을 사용하여 배포하세요.
단일 호스트 배포의 경우, docker-compose.enterprise.ymlDocker-DocumentServer 저장소에서 ONLYOFFICE의 공식 컨테이너를 다운로드하고 Docker Compose v2를 사용하여 시작하세요. 스택을 온라인 상태로 전환하기 전에 예제 자격 증명을 교체하고, 통합에 사용할 안정적인 JWT 비밀 키를 설정하고, 엔터프라이즈 라이선스와 영구 데이터를 저장할 디렉터리를 마운트해야 합니다. 컨테이너가 실행 중인 것은 첫 번째 확인 사항일 뿐입니다. 프로덕션 플랫폼에 연결하기 전에 Compose 상태를 확인하고 Docs 시작 페이지를 여세요.
Enterprise Compose 파일은 무엇으로 시작하나요?
공식 Compose 파일은 Document Server Enterprise 서비스와 PostgreSQL, RabbitMQ, Redis 종속성을 정의합니다. 또한 편집기의 HTTP 및 HTTPS 포트를 공개하고 내부 Docs 정보 엔드포인트에 대한 상태 점검 기능을 포함합니다. 이러한 종속성 덕분에 이 Compose 파일은 소규모 단일 호스트 설치에 적합합니다. 단, 이 파일 자체만으로는 플랫폼 커넥터, 공용 DNS 또는 프로덕션 TLS 인증서를 구성하지 않습니다.
2026년 10월 9일 기준으로 공식 파일은 PostgreSQL 15, RabbitMQ 3, Redis 7을 사용합니다. 저장소 파일은 변경될 수 있으므로 배포 및 업그레이드 전에 최신 Enterprise Compose 파일을 검토하십시오.
1. 호스트를 확인하고 Docker Compose를 설치하세요.
ONLYOFFICE의 엔터프라이즈 Docker 요구 사항은 커널 3.10 이상이 설치된 amd64 Linux 호스트, Docker 유지 관리자가 지원하는 환경, 최소 4GB RAM, 40GB의 여유 디스크 공간, 그리고 최소 4GB의 스왑 공간을 필요로 합니다. 또한, 참조 크기는 동시에 열려 있는 문서 수와 문서 유형에 따라 달라지므로, 이 수치는 용량 보장이 아닌 시작점으로 활용하시기 바랍니다. 작업 부하가 더 높은 운영 환경의 포털에는 더 많은 리소스가 필요할 수 있습니다.
사용하는 Linux 배포판에 맞는 Docker 공식 지침에 따라 Docker Engine과 Compose 플러그인을 설치하세요. 저장소를 복제하기 전에 두 명령이 모두 제대로 작동하는지 확인하십시오.
docker --version
docker compose version호스트에 기존 웹 서버가 있는 경우, 포트 80과 443이 사용 가능한지 확인하거나 리버스 프록시 및 다른 호스트 측 포트 매핑을 계획하십시오. Compose 파일은 데이터베이스, 큐 및 캐시 서비스도 시작하는데, 이러한 서비스는 공용 포트로 게시하는 대신 개인 Compose 네트워크에 유지되어야 합니다.
2. 공식 Compose 파일을 다운로드하세요.
ONLYOFFICE의 저장소를 복제하고 해당 디렉터리로 이동합니다.
git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer해당 파일이 있는지 확인하십시오 docker-compose.enterprise.yml. 저장소의 README 파일에는 엔터프라이즈 에디션에 대한 다음 명령이 나와 있습니다.
docker compose -f docker-compose.enterprise.yml up -d
3. 자격 증명, JWT 및 영구 라이선스 위치를 설정합니다.
샘플 Compose 구성을 인터넷에 연결된 호스트에서 변경 없이 실행하지 마십시오. 게시된 파일에는 예제 데이터베이스 자격 증명이 포함되어 있으며 명시적인 JWT 값은 주석 처리되어 있습니다. 데이터베이스 서비스와 문서 서버 DB_PWD설정 모두에서 PostgreSQL 암호를 동일하고 강력한 값으로 교체하십시오. 데이터베이스, RabbitMQ 및 Redis 포트는 비공개로 유지하십시오.
통합을 위해 문서 서버 서비스에 안정적인 JWT 암호를 하나 설정하고 플랫폼의 ONLYOFFICE 커넥터에도 동일한 암호를 구성하십시오. 간단한 방법은 .envGit에 커밋하지 않는 로컬 파일에 값을 저장한 다음 Compose 변수 대체 기능을 사용하는 것입니다. 기존 환경 형식을 필요에 따라 수정하여 다음 항목을 문서 서버 환경 섹션에 추가하십시오.
- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}`<name>` 필드에 길고 고유한 값을 입력하십시오 . 플레이스홀더 값을 .env그대로 JWT_SECRET=...복사하여 실제 구성에 붙여넣지 마십시오. ONLYOFFICE 문서에서는 Docs 7.2 이상 버전에서 JWT가 기본적으로 활성화되어 있으며 자동으로 생성된 비밀 키를 사용한다고 설명합니다. 컨테이너가 다시 생성될 때 불일치가 발생하지 않도록 고정된 값을 직접 지정하십시오. JWT 구성 가이드를 참조하십시오 .
구매한 라이선스로 Enterprise를 등록하려면 Document Server 서비스에 license.lic호스트 디렉터리를 바인드 마운트해야 합니다 . 예를 들어, 익명 데이터 마운트를 로 바꾸고 해당 호스트 디렉터리를 생성한 다음, 시작 전에 그 안에 라이선스 파일을 배치하십시오. 파일 권한을 유지하고 백업 계획에 해당 디렉터리를 포함시키십시오. Enterprise 등록 지침에 따르면 라이선스 파일은 Docker에서 마운트된 폴더에 있어야 합니다./var/www/onlyoffice/Data./documentserver-data:/var/www/onlyoffice/Datalicense.lic
4. 엔터프라이즈 스택 시작
리포지토리 디렉터리에서 Compose 구성을 조용히 검증하여 확장된 비밀 키가 출력되지 않도록 한 다음 서비스를 시작합니다. 조용한 검증은 Compose 모델을 확인하는 것이며 컨테이너가 시작될 것이라는 것을 보장하지는 않습니다. Docker는 Compose 구성 참조 에서 이 옵션을 설명합니다 .
docker compose -f docker-compose.enterprise.yml config --quiet
docker compose -f docker-compose.enterprise.yml up -d처음 시작할 때는 이미지 빌드 또는 다운로드 및 종속성 초기화로 인해 시간이 더 오래 걸릴 수 있습니다. 구성 유효성 검사에서 설정되지 않은 변수가 보고되면 .env파일과 Compose 파일의 변수 이름을 확인하십시오. 의도된 값의 일부가 아닌 경우 비밀 값에 따옴표를 추가하지 마십시오.
5. 플랫폼을 연결하기 전에 준비 상태를 확인하십시오.
서비스 및 건강 상태를 확인하세요:
docker compose -f docker-compose.enterprise.yml ps문서 서버 상태 검사가 완료될 때까지 기다리세요. 공식 Compose 파일은 http://localhost:8000/info/info.json컨테이너 내부에서 60초의 시작 시간 간격으로 검사를 수행합니다. 서비스 상태가 계속 비정상인 경우 로그와 종속성 상태를 확인하세요.
docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver그런 다음 http://localhost호스트 또는 서버에 연결할 수 있는 브라우저에서 매핑된 URL을 엽니다. ONLYOFFICE의 작성 지침은 시작 페이지를 초기 설치 확인 용도로 사용합니다. 원격 프로덕션 환경에서 사용하려면 편집기 트래픽을 일반 HTTP로 유지하는 대신 도메인에서 HTTPS를 통해 서비스를 노출하십시오. 네트워크 액세스 및 TLS 구성 시에는 엔터프라이즈 Docker 포트 가이드 및 Docker 설치 가이드를 참조하십시오 .
마지막으로 플랫폼의 문서 서버 URL과 일치하는 JWT 암호를 구성한 다음 해당 통합을 통해 테스트 문서를 열고 편집하고 저장하십시오. 환영 페이지만으로는 커넥터, 역방향 프록시, JWT 또는 콜백 URL이 올바르게 구성되었는지 확인할 수 없습니다. 서비스는 정상적이지만 플랫폼에서 편집기를 열 수 없는 경우 플랫폼에서 Docs URL에 연결할 수 있는지, 그리고 양쪽에서 동일한 JWT 암호와 헤더를 사용하는지 확인하십시오. 다중 호스트 또는 고가용성 배포의 경우, 이 Compose 스택을 시작점으로 활용하고 하나의 Compose 호스트가 클러스터링을 제공한다고 가정하기보다는 ONLYOFFICE의 배포 지침을 검토하십시오.
재사용 가능한 ONLYOFFICE 매크로로 스프레드시트 텍스트를 정리하세요
ONLYOFFICE JavaScript 매크로를 사용하여 정의된 스프레드시트 범위에서 인쇄되지 않는 문자를 제거하고 불필요한 공백을 없애고, 안전한 검토 워크플로를 적용할 수 있습니다.
ONLYOFFICE Workspace의 기본 저장 위치 변경
포털 데이터를 기본 디스크에서 지원되는 클라우드 스토리지 공급자로 이동하거나, Docker 데이터의 호스트 볼륨 매핑을 변경하여 안전하게 재배치할 수 있습니다.
Linux에서 ONLYOFFICE Document Server를 완전히 제거하십시오.
문서 서버가 Linux 패키지를 사용하는지 Docker를 사용하는지 확인하고, 해당 구성 요소만 제거한 다음, 공유 서비스를 실수로 삭제하지 않고 나머지 데이터를 확인합니다.
OnlyOffice 공동 편집 지연 현상 해결: 병목 현상 찾기
공동 편집 속도 저하의 원인을 Docker 리소스 사용량, 프록시 연결 또는 문서 로드에서 추적한 다음 측정값에 맞는 해결 방법을 선택하십시오.
Docker에서 ONLYOFFICE Docs에 대한 HTTPS 구성
TLS 종료 위치를 선택하고, 신뢰할 수 있는 인증서와 개인 키를 안전하게 마운트하고, Docker로 컨테이너화된 ONLYOFFICE Docs 서버에 대한 HTTPS 액세스를 확인하십시오.
PHP 앱을 ONLYOFFICE Docs에 연결하고 편집 내용을 저장하세요.
ONLYOFFICE 편집기를 PHP 앱에 내장하고, JWT로 구성 파일에 서명하고, 보안 콜백을 통해 편집된 파일을 저장하세요.
ONLYOFFICE 맞춤법 검사 기능을 원하는 언어로 유지하세요.
문서 전체 또는 선택한 텍스트에 대한 교정 언어를 설정하고, 맞춤법 검사가 활성화되어 있는지 확인하고, 서버 사전이 누락된 경우를 식별합니다.
문서를 다시 열 때 변경 내용 추적 기능을 켜기
ONLYOFFICE 문서에서 모든 사용자에 대해 지속적인 변경 내용 추적 기능을 활성화하고, 편집 내용이 기록되는지 확인하고, 이 설정의 한계를 이해하십시오.
ONLYOFFICE의 Nginx 502 오류를 해결하기 위해 상위 원인을 추적하세요
Nginx, Docker 네트워킹 또는 내부 ONLYOFFICE 서비스에서 502 오류가 발생하는지 확인한 다음, 수정된 상위 서버 및 상태 점검 결과를 검증하십시오.