배포 가이드

규모에 따라 Server SDK 애플리케이션의 배포 형태를 선택합니다. 단일 머신, 가져오기와 내보내기 분리, 여러 협업 노드.

Server SDK 응용 프로그램은 세 가지 배치 모양을 가지고 있으며 응용 프로그램의 규모는 어느 것을 사용하는지 결정합니다. Collaboration SDK, 수입 및 수출 및 이름 *와 함께 시작하면 모듈이 조립되는 방법을 볼 수 있습니다. 배포는 여러 노드가 동일한 어셈블리를 실행하는 방법을 결정합니다.

형태협업가져오기와 내보내기권장 규모
단일 머신노드 1개같은 노드로컬 애플리케이션, 개발과 테스트, 소수의 내부 사용자
가져오기와 내보내기 분리노드 1개별도 노드다중 사용자 온라인 서비스, 노드 1개 용량 이내
여러 노드여러 노드별도 노드노드 1개 용량을 넘거나 노드 장애 조치가 필요한 경우

단일 머신

모든 구성 요소는 단일 Node.js 프로세스에서 실행되며 브라우저는 직접 처리 할 수 있습니다.

100%
  • Database Adapter는 IDatabaseAdapter 계약을 구현합니다. 데이터베이스 어댑터를 참고하세요.
  • 수입 및 수출은 교환 서비스 및 파일 서비스에 의해 제공됩니다. 협업 확장 모듈를 참조하십시오.
  • 변환은 CPU-바운드이므로 큰 파일이 협업을 느립니다.

전환이 지연될 때 별도의 노드로 가져와 내보내기, 또는 서비스가 많은 사용자를 위해 응답해야 할 때.

가져오기와 내보내기 분리

단일 노드에 남아있는 동안 전용 노드에서 가져 오기 및 내보내기 실행. 게이트웨이는 두 가지 종류의 요청을 별도로 경로, 양쪽 모두 동일한 데이터베이스를 사용합니다.

100%

가져 오기 및 내보내기 노드는 데이터베이스 어댑터, UniverCollabService, 파일 서비스 및 교환 서비스를 조립하고 데이터베이스와 직접 작동합니다. 주입 지점은 단일 기계와 동일합니다. 같은 파일 저장에서 노드 포인트 파일 서비스 모두 UniverCollabService에 동일한 권한 Middleware를 설치합니다.

Process Memory는 하나의 협업 노드가 제공될 수 있는 문서의 수를 제한합니다. 용량이 초과될 때 여러 노드로 이동하거나 장애가 필요할 때 실패합니다.

여러 협업 노드

여러 협업 노드는 동일한 데이터베이스에 대해 동일한 코드를 실행합니다. pub/sub 어댑터 릴레이 룸, 우선, 노드 사이 방송 및 티켓 저장 공유 세션 티켓. @univerjs-pro/collaboration-cluster-redis는 Redis 구현을 제공합니다. 모든 노드는 실행 노드의 수를 다루는 동일한 라이센스를 사용합니다. 협력 노드를 참조하십시오. 참고 구현을 위해 멀티 노드을 참조하십시오.

100%

각 협업 노드는 Redis pub/sub 어댑터와 Endpoint에 티켓 저장소를 전달합니다. 조립의 나머지는 변경되지 않습니다.

TypeScript
import { createClient } from "redis";import { RedisPubSubAdapter, RedisSessionTicketStore } from "@univerjs-pro/collaboration-cluster-redis";import { UniverCollabEndpoint } from "@univerjs-pro/collaboration-endpoint";const client = createClient({ url: process.env.REDIS_URL });const subClient = client.duplicate();await Promise.all([client.connect(), subClient.connect()]);const pubSub = new RedisPubSubAdapter({ pubClient: client, subClient });const ticketStore = new RedisSessionTicketStore({ client });const endpoint = new UniverCollabEndpoint(service, { pubSub, ticketStore });

더 나아가기

하나의 매우 큰 문서는 같은 노드에 작은 문서에 대한 요청을 느리게합니다. 문서 크기로 노드 풀을 분할하고 전용 풀에 큰 문서를 게이트웨이 경로로 배치하십시오. 라우팅 키는 여전히 단위 ID이며, 모든 풀은 데이터베이스와 pub/sub을 공유합니다.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.