성능 튜닝

렌더링 및 메모리 최적화

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

해상도 — 가장 큰 레버

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

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 (기본값 3000 px)는 출력 크기를 제한합니다.

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

BaseConfig.CachePages (default 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는 중요한 부분만 렌더링하도록 제한합니다.
  • Redirect 모드에는 초기 비용이 있습니다: 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를 사용하십시오.

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