适用于 .NET 8 的基础 Doconut 查看器以一个 NuGet 包的形式提供，可插入任何 ASP.NET Core 应用程序。可选插件使用单独的包。本页安装基础包并注册中间件——在首次渲染之前所需的最小配置。

安装包

bash

dotnet add package Doconut.NET8

未指定版本的命令会安装最新的稳定版。若要精确复现当前的 26.7.0 版本，请将版本号作为单独的选项传入：

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 是包的标识符。.26.7.0 后缀属于下载的 Doconut.NET8.26.7.0.nupkg 文件名，并不属于标识符的一部分。

注册 Doconut

AddDoconut() 是唯一的注册入口——它只有一个重载，并将 Viewer 服务、许可证服务以及渲染基础设施注入到 DI 容器中。

两次中间件调用完成设置，且调用顺序很重要：UseDoconutResources() 必须在 UseDoconut() 之前运行。UseDoconut() 是终止中间件，因此如果先调用它，所有对 /doconut-res 资源的请求都无法到达资源处理程序并返回 404。会话绑定也必不可少——Doconut 默认的文档安全会对每个页面请求进行 ASP.NET 会话状态的验证。

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // 会话状态需要缓存（MVC/Razor 页面已经添加一个）
builder.Services.AddSession(); // Doconut 文档安全依赖于 ASP.NET 会话状态

app.UseSession();          // 在调用 UseDoconut() 之前先调用 UseSession()
app.UseDoconutResources(); // 必须在 UseDoconut() 之前注册
app.UseDoconut();

所有选项

DoconutOptions 接受以下可设置的属性。每个属性都是可选的——未设置时将使用下表中的默认值。

属性	默认值	描述
`ShowDoconutInfo`	`false`	当为 `true` 时，未携带 `token` 的请求会返回版本横幅而不是 404。可用于快速检查；生产环境请关闭。
`UnsafeMode`	`false`	当为 `true` 时，跳过页面请求的 ASP.NET 会话安全检查。生产环境请关闭。
`MiddlewarePath`	`"/doconut"`	页面-图片端点的协调路径。虽然会进行验证，但它本身不会挂载分支；请保持与实际的 `UseDoconut()` 映射以及客户端 `BasePath` 对齐。
`ResourcesPath`	`"/doconut-res"`	嵌入的 JS/CSS/图片资源的提供路径。
`LicensePath`	`""` (empty string)	许可证文件的路径。为空表示会继续查找下一个来源，然后自动搜索。
`LicenseContent`	`""` (empty string)	原始许可证内容——可来自环境变量、密钥管理器或数据库。
`LicenseStream`	`null`	许可证流，在启动时读取一次。
`ResetLicense`	`false`	保留的兼容性标志。当前的 .NET 8 服务在 `AddDoconut()` 时读取许可证；更换许可证后请重启应用。

当设置了多个来源时的许可证优先级顺序为：LicenseStream 优先于 LicenseContent，后者优先于 LicensePath，再优先于自动搜索——参见 License Setup。

csharp

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 查找许可证文件的位置。