Blobstoring Dotnet Filesystem

FileSystem provider

Path vật lý: {RootPath}/{SubPath}/{bucket}/{fileName}.

appsettings

{
  "FileSystem": {
    "RootPath": "/var/app/storage",
    "SubPath": "uploads",
    "BucketName": "",
    "PartitionBy": 0
  }
}

Registration

using Jarvis.BlobStoring;
using Jarvis.BlobStoring.FileSystem;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

builder.Services.Configure(builder.Configuration.GetSection("FileSystem"));
builder.Services.AddKeyedSingleton("FileSystem");

Inject

public sealed class LocalFileService(
    [FromKeyedServices("FileSystem")] IBlobStoringService storage)
{
    public Task UploadAsync(string path, byte[] data, CancellationToken ct = default)
        => storage.UploadAsync(bucket: "documents", fileName: path, data);
}

Lưu ý

• ViewAsync trả chuỗi rỗng — không presigned URL; dùng API riêng nếu cần link tải.
• GetFileNames hiện trả rỗng trên implementation mặc định — liệt kê file cần mở rộng hoặc dùng MinIO.
• Đảm bảo process có quyền ghi RootPath (container: mount volume).

Validate

• Upload + download cùng bucket + fileName
• Path traversal: không cho fileName chứa .. ở tầng application

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hoangnh2412
• Source: hoangnh2412/ai-skills
• License: MIT

Install and usage instructions live in the source repository linked above.