包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.FileStorage.Nas |
| Provider ID | nas |
| 存储 | NAS 挂载点或本地文件系统 |
配置字段(NasOptions)
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
BasePath | string | 是 | — | 根目录路径(如 /mnt/nas 或 C:\Data\NAS) |
DefaultBucketName | string | 否 | — | 默认存储桶名称(映射为根目录下的子目录) |
Domain | string | 否 | — | 下载域名(用于生成下载 URL) |
HttpClientName | string | 否 | — | HttpClient 名称 |
DownloadUrlExpiration | int | 否 | 43200 | 下载地址过期时间(秒) |
UploadUrlExpiration | int | 否 | 3600 | 上传地址过期时间(秒) |
配置示例
{ "FileStorage": { "Nas": { "BasePath": "/mnt/nas", "DefaultBucketName": "uploads", "Domain": "https://files.example.com" } }}DI 注册
builder.Services.AddBitzsoftNasFileStorage(builder.Configuration.GetSection("FileStorage:Nas"));使用示例
public class NasService(IFileStore store){ public async Task ClearBucketAsync() { await store.ClearAsync(); }}已知限制
- “桶”概念映射为
BasePath下的子目录,DefaultBucketName为空时直接使用BasePath。 - 无鉴权机制——依赖操作系统的文件权限控制。
GenerateUploadUrlAsync/GenerateDownloadUrlAsync需配合Domain生成可访问的 URL。