설치

Doconut을 .NET 6 프로젝트에 추가

.NET 6용 기본 Doconut 뷰어는 모든 ASP.NET Core 애플리케이션에 연결되는 하나의 NuGet 패키지로 제공됩니다. 선택적 플러그인은 별도의 패키지를 사용합니다. 이 페이지에서는 기본 패키지를 설치하고 미들웨어를 등록합니다 — 첫 렌더링 전에 필요한 최소 구성입니다.

요구 사항

패키지는 다음 플랫폼에서 실행됩니다:

플랫폼지원 여부
Windows x64 / x86예
Linux x64, glibc 기반 (Debian, Ubuntu, 공식 mcr.microsoft.com/dotnet/aspnet:6.0-bookworm-slim 이미지)예
Alpine 및 기타 musl 기반 배포판아니오
macOS아니오

Linux에서는 첫 문서를 열기 전에 글꼴 구성 라이브러리를 설치하세요:

bash
apt-get update && apt-get install -y libfontconfig1

RHEL, Fedora 및 유사 배포판에서는 패키지가 fontconfig (dnf install -y fontconfig) 형태입니다. 이것이 Doconut이 필요로 하는 유일한 시스템 패키지이며, 네이티브 라이브러리는 NuGet 패키지 내부에 포함되고 libgdiplus는 필요하지 않습니다.
Docker에서는 aspnet:6.0-bookworm-slim (Debian 12)를 사용하는 것이 좋습니다: 기본 aspnet:6.0 태그는 Debian 11이며, 해당 패키지 미러가 libfontconfig1 설치에 실패할 수 있습니다. 페이지는 서버에 설치된 글꼴로 그려지므로, 글꼴 및 Linux 오류 메시지는 문제 해결 문서를 참고하세요.

패키지 설치

bash
dotnet add package Doconut.NET6

버전이 지정되지 않은 명령은 최신 안정 버전을 설치합니다. 이 문서에서 설명하는 릴리스를 고정하려면 버전을 별도 옵션으로 전달하세요:

bash
dotnet add package Doconut.NET6 --version 26.10.0

Doconut.NET6은 패키지 ID입니다. 버전 접미사는 다운로드된 Doconut.NET6.<version>.nupkg 파일 이름에 포함되며 ID의 일부가 아닙니다.

업그레이드 전 통합 식별

Doconut.NET6 패키지 ID는 클래식과 현재 .NET 6 통합 모두에서 사용되었습니다. 패키지 이름만으로 문서를 선택하지 마세요:

  • DocImage.axd, new Viewer(_cache, _accessor, ...), 동기식 OpenDocument(...), 그리고 수동으로 복사한 뷰어 스크립트는 클래식 통합을 식별합니다;
  • AddDoconut(), UseDoconutResources(), 주입된 Viewer, 그리고 OpenDocumentAsync(...)은 여기서 문서화된 현재 통합을 식별합니다.

번역된 클래식 설정 매뉴얼은 여전히 사용할 수 있습니다. 세대 변경은 마이그레이션 가이드를 사용하세요; 일반 패키지 업데이트는 시작, 뷰어 수명 또는 브라우저 리소스를 자동으로 변환하지 않습니다.

Doconut 등록

AddDoconut()은 유일한 등록 진입점이며, 단일 오버로드가 존재하고 Viewer 서비스, 라이선스 서비스 및 렌더링 인프라를 DI 컨테이너에 연결합니다.

두 개의 미들웨어 호출이 설정을 완성하며, 순서가 중요합니다: UseDoconutResources()은 UseDoconut()보다 먼저 실행되어야 합니다. UseDoconut()는 최종 미들웨어이므로 먼저 호출하면 /doconut-res 자산에 대한 모든 요청이 리소스 핸들러에 도달하지 못하고 404가 발생합니다. UseDoconut()는 도달하는 모든 요청에 응답하므로 app.Map와 함께 자체 브랜치에 마운트하세요. 세션 연결도 필요합니다 — Doconut의 기본 문서 보안은 모든 페이지 요청을 ASP.NET 세션 상태와 검증합니다.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // 세션 상태에는 캐시가 필요합니다 (MVC/Razor Pages는 이미 하나를 추가합니다)
builder.Services.AddSession(); // Doconut 문서 보안은 ASP.NET 세션 상태에 의존합니다

app.UseSession();          // UseDoconut() 전에 UseSession()을 호출하세요
app.UseDoconutResources(); // UseDoconut() 전에 등록되어야 합니다
app.Map("/doconut", branch => branch.UseDoconut());

모든 옵션

DoconutOptions은 다음과 같은 설정 가능한 속성을 허용합니다. 모든 속성은 선택 사항이며, 아래 기본값은 속성을 지정하지 않을 경우 적용됩니다.

속성기본값설명
ShowDoconutInfofalsetrue인 경우, token가 없는 요청은 404 대신 버전 배너를 반환합니다. 스모크 체크에 유용하며, 프로덕션에서는 사용하지 마세요.
UnsafeModefalsetrue인 경우, 페이지 요청 시 ASP.NET 세션 보안 검사를 건너뜁니다. 프로덕션에서는 사용하지 마세요.
MiddlewarePath"/doconut"페이지-이미지 엔드포인트의 조정 값입니다. 검증은 되지만 자체적으로 브랜치를 마운트하지 않으므로 실제 UseDoconut() 매핑 및 클라이언트 BasePath와 일치하도록 유지하세요.
ResourcesPath"/doconut-res"내장된 JS/CSS/이미지 리소스가 제공되는 위치.
LicensePath"" (empty string)라이선스 파일 경로. 비어 있으면 다음 소스로 넘어가며, 이후 자동 검색됩니다.
LicenseContent"" (empty string)원시 라이선스 내용 — 환경 변수, 비밀 관리자 또는 데이터베이스에서 가져옵니다.
LicenseStreamnull스트림 형태의 라이선스, 시작 시 한 번 읽습니다.
ResetLicensefalse예약된 호환성 플래그. 현재 .NET 6 서비스는 AddDoconut() 동안 라이선스를 읽습니다; 라이선스를 교체한 후 앱을 재시작하세요.
MaxConcurrentEditorSessions200실시간 편집기 세션(DocOptions.EditMode로 연 문서)의 최대 수입니다. 이를 초과하면 가장 오래된 유휴 편집기 세션이 종료됩니다. 일반 뷰어 세션은 계산되지 않습니다. 0 또는 음수 값은 제한이 없음을 의미합니다.
EditorSnapshotEveryOps50편집기 지속성이 활성화된 경우(AddDoconutEditorPersistence), N개의 기록된 변경마다 실시간 문서를 스냅샷합니다. 0 또는 음수 값은 세션 중 스냅샷을 하지 않습니다. 지속성이 비활성화되면 효과가 없습니다.

여러 소스가 설정된 경우 라이선스 우선순위: LicenseStream > LicenseContent > LicensePath > 자동 검색 — 자세한 내용은 라이선스 설정을 참고하세요.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // 앱 매핑 및 클라이언트 BasePath와 조정하세요
    options.ResourcesPath   = "/doconut-res"; // viewer의 JS/CSS/이미지가 제공되는 위치
    options.UnsafeMode      = false;          // 세션 보안을 유지하세요
    options.ShowDoconutInfo = false;
});

다음 단계

  • 빠른 시작 — 첫 문서를 열고 브라우저에서 렌더링합니다.
  • 라이선스 설정 — Doconut이 라이선스 파일을 찾는 위치입니다.

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