커넥터 서버 사양

대상: 커넥터 서버를 준비하시는 인프라 담당자 함께 보실 문서: Connector 설치 가이드 · 환경별 Connector 설치 · 문서 보안(DRM) 연동 가이드

커넥터는 서버 한 대에서 Docker 컨테이너 하나로 돕니다. 필요한 사양은 어떤 기능을 쓰는지와 문서 보안으로 하루에 문서를 몇 건 여는지에 따라 달라집니다.

1. 한눈에 보기

• 문서 보안을 함께 쓰시면 기본 용도와 같은 서버에서 돌아갑니다. 위 표의 문서 보안 행이 기본 용도를 포함한 사양입니다.
• 운영체제는 Ubuntu 22.04 LTS · RHEL 8 · Rocky 9 처럼 Docker 가 지원되는 64비트 Linux 를 권합니다.
• 클라우드라면 AWS t3.medium(2 vCPU · 4 GB) · Azure Standard_B2s(2 vCPU · 4 GB) 정도가 문서 보안 하루 1,000건 이하에 맞습니다.

2. 문서 보안을 쓰실 때

CPU

• 문서 하나를 여는 동안 커넥터는 CPU 1코어 정도를 씁니다(암호화 통신과 공유 폴더 읽고 쓰기).
• 한 회사에서 동시에 여는 문서는 최대 4건입니다. 그래서 문서 보안 때문에 커넥터가 쓰는 CPU 는 많아야 4코어입니다.
• 5번째 요청부터는 잠시 뒤 다시 시도하도록 안내되고, 웍스AI 가 5초 간격으로 최대 3번 다시 보냅니다. 그래도 자리가 나지 않으면 그 문서는 열리지 않으니, 잠시 뒤 다시 올려 주세요.
• 문서 보안은 공유 폴더 파일 받기·이미지 올리기와 커넥터의 전송 자리(동시 4건)를 함께 씁니다. 자리가 다 차 있으면 최대 15초 기다렸다가 처리됩니다.

메모리

• 문서를 메모리에 통째로 올리지 않고 흘려보내므로, 문서 크기와 상관없이 메모리 사용량이 거의 일정합니다. 100 MB 문서를 네 건 동시에 열어도 커넥터 메모리는 수십 MB 정도만 늘어납니다.
• 4 GB 를 권하는 이유는 문서 보안과 DB · 사내 API 도구 호출이 한 서버에서 함께 돌기 때문입니다.

디스크

• 문서는 커넥터 서버의 디스크가 아니라 공유 폴더에 잠깐 놓였다가 처리 직후 지워집니다. 문서 보안 때문에 커넥터 서버의 디스크를 늘리실 필요는 없습니다.

네트워크

사내망 — 커넥터 서버, 파일 서버(공유 폴더), DRM 게이트웨이를 **같은 사내망(1 Gbps 권장)**에 두세요. 문서 하나가 공유 폴더를 네 번 오갑니다(커넥터가 쓰고 → 게이트웨이가 읽고 → 게이트웨이가 풀어서 쓰고 → 커넥터가 읽습니다). 이 구간이 느리면 문서 여는 시간이 그대로 늘어납니다.

외부(인터넷) — 커넥터에서 MCP Hub 로 나가는 443 포트만 있으면 됩니다(설치 가이드와 같습니다). 문서 하나가 커넥터와 MCP Hub 사이를 두 번 오갑니다(보호된 문서를 받고, 풀린 문서를 보냅니다).

처리 시간

• 문서를 여는 시간은 DRM 게이트웨이가 문서를 푸는 시간과 커넥터와 MCP Hub 사이 인터넷 구간이 대부분입니다. 커넥터 자체의 처리는 50 MB 문서 기준 1초 안팎입니다.
• 인터넷 구간은 문서가 두 번 오가므로 회선 속도에 따라 달라집니다. 50 MB 문서라면 100 Mbps 회선에서 10초 안팎, 1 Gbps 회선에서 1~2초 정도 걸립니다.
• 문서가 느리게 열린다면 커넥터 사양보다 게이트웨이 서버의 상태와 사내망 속도를 먼저 확인해 주세요.

문서 크기

• 한 번에 열 수 있는 문서는 100 MB 까지입니다. 이 크기는 보호된(암호화된) 파일 기준이라, 풀었을 때 100 MB 에 가까운 문서는 보호 정보가 붙어 한도를 넘을 수 있습니다.

3. 사양을 올려야 할 때

Studio 문서 보안 → 사용 기록에서 아래가 자주 보이면 사양이나 환경을 점검해 주세요.

커넥터 서버 CPU 가 문서를 여는 동안 계속 100% 에 붙어 있다면 vCPU 를 4 로 올려 주세요.