성능 튜닝

렌더링 및 메모리 최적화

Doconut의 리소스 프로필은 세 가지 요소가 지배합니다: 렌더링 DPI, 캐시된 항목, 그리고 세션 지속 시간. 이 가이드는 영향력 순서대로 레버를 안내합니다.

해상도 — 가장 큰 레버

ImageResolution (25–300 DPI)는 렌더링 시간과 이미지 크기에 모두 영향을 줍니다. 대부분의 포맷은 기본값이 200 DPI이며, 이미지와 PSD는 기본값이 100입니다.

csharp
// 문서 목록 미리보기는 인쇄 품질이 필요하지 않습니다.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

DPI를 절반으로 줄이면 페이지당 픽셀 수가 대략 4분의 1이 됩니다 — 렌더링이 빨라지고 전송이 작아지며 캐시 메모리가 감소합니다. 줌 사용이 많은 경우(CAD, 엔지니어링 도면)에는 250–300 DPI를 유지하세요.

이미지가 많이 포함된 PDF의 경우, PdfConfig는 더 세밀한 조정을 추가합니다: CompressImages + CompressQuality, ResizeImages + ResizeResolution, 그리고 CompressFast. 일반 이미지의 경우, ImageConfig.MaxImagePixelSize(기본값 3000px)는 출력 크기를 제한합니다.

페이지 캐싱 — 메모리 vs. 재렌더링

BaseConfig.CachePages(기본값 true)은 세션 기간 동안 모든 렌더링된 페이지를 메모리에 유지합니다. 이는 인터랙티브 뷰잉에 적합한 기본값이며—사용자는 앞뒤로 스크롤합니다. 다음 경우에 비활성화하세요:

  • 문서가 매우 크고 한 번만 앞에서 뒤까지 보는 경우,
  • 다수의 동시 세션이 캐시된 페이지를 곱셈적으로 늘릴 경우,
  • RAM을 유지하기보다 보기당 CPU 비용을 지불하는 것이 더 나은 경우.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

클라이언트에서는 ViewerConfig.CacheEnabled = true가 브라우저 메모리에 다가오는 페이지 이미지의 작은 이동 창을 미리 로드합니다. 이는 보기당 프리패치 캐시이며, 지속적인 localStorage가 아닙니다.

세션 — 눈에 보이지 않는 메모리

열린 모든 세션은 파싱된 문서 모델과 (CachePages와 함께) 렌더링된 페이지를 보관하며, 슬라이딩 TimeOut(기본값 60분)이 마지막 요청 이후 경과할 때까지 유지됩니다. 두 가지 습관이 이를 제어합니다:

  • 작업이 끝난 것을 닫으세요. viewer.CloseDocument(token)는 엔진을 즉시 해제하여 유휴 창을 기다리지 않게 합니다.
  • 타임아웃을 적절히 설정하세요. 사용자가 2분 정도 살펴보는 미리보기는 1시간 세션이 필요하지 않습니다:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

트레이드오프를 기억하세요: 만료 후 위젯은 Document session not found. Please re-open document.를 표시합니다 — 실제 독서 세션에 맞는 타임아웃을 선택하세요.

포맷별 스위치

  • Excel: MemoryOptimizationPreference은 기본적으로 켜져 있으며 매우 큰 워크북을 렌더링할 때 메모리 사용량을 줄입니다 — 켜두거나 메모리를 약간의 속도 향상과 교환하려면 false로 설정하세요; SheetNames / PrintArea은 중요한 부분만 렌더링하도록 제한합니다.
  • 리다이렉트 모드에는 초기 비용이 있습니다: DefaultRender = false는 열 때 전체 문서를 PDF로 변환합니다. 이는 네이티브 텍스트 기반 검색을 가능하게 하지만, 500페이지 문서에서는 열기 호출이 그 변환을 포함하므로—무조건 활성화하지 마세요.
  • Linux/Docker에서 Word/PPT: 누락된 글꼴은 느린 대체 탐색과 잘못된 메트릭을 초래합니다; FontFolders를 글꼴이 있는 디렉터리로 지정하세요.
  • Linux에서 프레젠테이션: libgdiplus 또는 System.Drawing.EnableUnixSupport 스위치는 필요하지 않습니다 — Linux의 글꼴을 참고하세요.

클라이언트 측 전략

  • LargeDoc = true — 매우 큰 문서에 대한 지연 로드 전략; 사용자가 페이지에 접근할 때 페이지가 로드됩니다.
  • AutoLoad = false (기본값) — 실제로 View(token)를 호출할 때까지 렌더링하지 않습니다.
  • ShowThumbs = false — 단일 페이지 또는 임베디드 미리보기에 대한 썸네일 생성/요청을 건너뜁니다.
  • FixedZoom를 활성화하면 자유 형태 줌 변경을 방지합니다; C# ViewerConfig를 매핑할 때 작은 화면에 맞게 FixedZoomPercentMobile(C# 기본값 75)를 조정하세요.

시작은 한 번, 요청당이 아니라

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)는 Program.cs에 포함되어야 합니다 — 요청당 인코딩을 등록하는 것은 불필요한 작업이며, 이를 완전히 놓치면 레거시 코드 페이지 문서가 깨집니다.

노드 간 작업 분산

위의 모든 내용은 필요에 따라 단일 노드의 렌더링을 조정합니다. 하나의 노드가 부하를 감당하지 못할 때, 다음 레버는 더 큰 다이얼이 아니라 — 문서의 아티팩트를 한 번 공유 스토리지에 게시하고 모든 노드가 이를 제공하도록 하는 것입니다. 이는 비용 모델을 바꿉니다: 렌더링은 세션당이 아니라 문서당 한 번 발생하고, 페이지 요청은 파일 읽기가 됩니다. 분산 배포를 참고하세요.

튜닝 체크리스트

  1. 사용자 경험이 허용하는 가장 낮은 ImageResolution를 설정하세요.
  2. 인터랙티브 뷰잉을 위해 CachePages를 켜두고, 일회성 또는 고동시성 시나리오에서는 끄세요.
  3. 세션을 명시적으로 닫고, 사용이 급증하는 경우 TimeOut를 짧게 설정하세요.
  4. 큰 문서의 경우 클라이언트에서 LargeDoc + 기본 AutoLoad = false를 사용하세요.
  5. 텍스트가 포함된 PDF 투영이 필요할 때만 DefaultRender = false를 사용하세요.

이 페이지가 도움이 되었나요?