Встановлення
Додайте Doconut до вашого проєкту .NET 6
Базовий переглядач Doconut для .NET 6 постачається як один пакет NuGet, який підключається до будь‑якого застосунку ASP.NET Core. Додаткові плагіни використовують окремі пакети. Ця сторінка встановлює базовий пакет і реєструє проміжне ПЗ — мінімум, необхідний перед вашим першим рендерингом.
Вимоги
Пакет працює на наступних платформах:
| Платформа | Підтримується |
|---|---|
| Windows x64 / x86 | Так |
Linux x64, на базі glibc (Debian, Ubuntu, офіційний образ mcr.microsoft.com/dotnet/aspnet:6.0-bookworm-slim) | Так |
| Alpine та інші дистрибутиви на базі musl | Ні |
| macOS | Ні |
У Linux встановіть бібліотеку налаштування шрифтів перед відкриттям першого документа:
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.
Встановити пакет
dotnet add package Doconut.NET6Команда без зазначення версії встановлює останній стабільний випуск. Щоб зафіксувати випуск, описаний у цій документації, передайте версію як окрему опцію:
dotnet add package Doconut.NET6 --version 26.10.0Doconut.NET6 — це ідентифікатор пакету. Суфікс версії належить до завантаженого файлу Doconut.NET6.<version>.nupkg і не є частиною ідентифікатора.
Визначте інтеграцію перед оновленням
Ідентифікатор пакету Doconut.NET6 використовувався як у класичній, так і в поточній інтеграції .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.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // стан сеансу потребує кешу (MVC/Razor Pages вже додає його)
builder.Services.AddSession(); // Безпека документів Doconut працює на стані сеансу ASP.NET
app.UseSession(); // викличте UseSession() перед UseDoconut()
app.UseDoconutResources(); // має бути зареєстровано перед UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());Усі параметри
DoconutOptions приймає наступні налаштовувані властивості. Кожна з них є необов’язковою — нижче наведені значення за замовчуванням застосовуються, якщо властивість залишена без значення.
| Властивість | За замовчуванням | Опис |
|---|---|---|
ShowDoconutInfo | false | Коли true, запит без token повертає банер версії замість 404. Корисно як швидка перевірка; вимкнути у продакшн. |
UnsafeMode | false | Коли true, пропускає перевірку безпеки ASP.NET‑сесії при запитах сторінок. Вимкнути у продакшн. |
MiddlewarePath | "/doconut" | Значення координації для кінцевої точки page-image. Воно валідовано, але не створює гілку самостійно; тримайте його узгодженим з фактичною мапою UseDoconut() та клієнтським BasePath. |
ResourcesPath | "/doconut-res" | Звідки подаються вбудовані ресурси JS/CSS/зображення. |
LicensePath | "" (empty string) | Шлях до файлу ліцензії. Порожнє означає переходити до наступного джерела, потім автоматичний пошук. |
LicenseContent | "" (empty string) | Необроблений вміст ліцензії — з змінної середовища, менеджера секретів або бази даних. |
LicenseStream | null | Ліцензія як потік, зчитується один раз під час запуску. |
ResetLicense | false | Зарезервований прапорець сумісності. Поточні сервіси .NET 6 читають ліцензію під час AddDoconut(); перезапустіть застосунок після заміни ліцензії. |
MaxConcurrentEditorSessions | 200 | Максимальна кількість активних сесій редактора (документів, відкритих за допомогою DocOptions.EditMode). Після досягнення цього ліміту найменш нещодавно використана проста сесія редактора закривається. Звичайні сесії переглядача не враховуються. 0 або від’ємне значення означає відсутність обмеження. |
EditorSnapshotEveryOps | 50 | При увімкненій стійкості редактора (AddDoconutEditorPersistence) створюйте знімок живого документа кожні N зафіксованих змін. 0 або від’ємне значення ніколи не створює знімки під час сесії. Не впливає, коли стійкість вимкнена. |
Пріоритет ліцензії, коли встановлено більше одного джерела: LicenseStream переважає LicenseContent, який переважає LicensePath, який переважає авто‑пошук — див. Налаштування ліцензії.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // координуйте з мапуванням додатку та BasePath клієнта
options.ResourcesPath = "/doconut-res"; // звідки подається JS/CSS/зображення переглядача
options.UnsafeMode = false; // зберігайте безпеку сесії
options.ShowDoconutInfo = false;
});Наступні кроки
- Швидкий старт — відкрийте ваш перший документ і відобразіть його у браузері.
- Налаштування ліцензії — де Doconut шукає ваш файл ліцензії.
Чи була ця сторінка корисною?