Bitzsoft.Integrations.CloudDrive.Baidu 1.0.1

Bitzsoft.Integrations.CloudDrive.Baidu

百度网盘服务实现，基于百度网盘开放平台 API。

功能特性

• 基于百度网盘开放平台 API，支持文件上传、下载、列表查询和文件夹管理
• OAuth 2.0 认证：访问令牌由外部授权码流获取，配置 RefreshToken 后支持自动刷新
• 大文件分块上传：precreate / chunks / create 三步流程
• 文件管理：复制、移动、删除
• 文件搜索：递归搜索

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.CloudDrive.Baidu

PackageReference

<PackageReference Include="Bitzsoft.Integrations.CloudDrive.Baidu" Version="1.0.0" />

配置

appsettings.json

{
  "CloudDrive": {
    "Baidu": {
      "AccessToken": "通过 OAuth 授权码流获取的访问令牌",
      "RefreshToken": "刷新令牌（可选，用于自动刷新）",
      "AppKey": "应用 App Key（刷新令牌时需要）",
      "SecretKey": "应用 Secret Key（刷新令牌时需要）",
      "AppName": "百度网盘应用名称",
      "BaseUrl": "https://pan.baidu.com/rest/2.0/",
      "UploadBaseUrl": "https://d.pcs.baidu.com/rest/2.0/pcs/superfile2",
      "TokenEndpoint": "https://openapi.baidu.com/oauth/2.0/token",
      "LargeFileThreshold": 4194304,
      "ChunkSize": 4194304,
      "HttpClientName": "BaiduCloudDrive"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.CloudDrive.Baidu;

builder.Services.AddBitzsoftBaiduCloudDrive(
    builder.Configuration.GetSection("CloudDrive:Baidu"));

委托配置

builder.Services.AddBitzsoftBaiduCloudDrive(options =>
{
    options.AccessToken = "你的访问令牌";
    options.RefreshToken = "你的刷新令牌";
    options.AppKey = "你的应用 Key";
    options.SecretKey = "你的应用密钥";
    options.AppName = "你的应用名称";
});

使用示例

using Bitzsoft.Integrations.CloudDrive.Interfaces;
using Bitzsoft.Integrations.CloudDrive.Models;

public class MyService
{
    private readonly ICloudDriveProvider _drive;

    public MyService(ICloudDriveProvider drive) => _drive = drive;

    public async Task UploadAndListAsync()
    {
        // 上传文件（大文件自动三步分块上传）
        await using var stream = File.OpenRead("video.mp4");
        var upload = await _drive.UploadAsync(new UploadFileRequest
        {
            FolderId = "/",
            FileName = "video.mp4",
            Content = stream,
            ContentLength = stream.Length,
            ContentType = "video/mp4"
        });

        // 列出文件夹内容
        var files = await _drive.ListFilesAsync("/");
        foreach (var file in files.Items)
        {
            Console.WriteLine($"{file.Name} ({file.Size} bytes)");
        }

        // 下载文件（两步：获取 dlink + 下载内容）
        var download = await _drive.DownloadAsync(upload.FileInfo.Id);

        // 搜索文件（递归）
        var results = await _drive.SearchAsync(new SearchFilesRequest
        {
            Keyword = "video"
        });
    }
}

核心类型一览

实现状态

请求审计

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftBaiduCloudDrive(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("mySecret"); // 额外脱敏字段
});
services.AddBitzsoftBaiduCloudDrive(options => { /* ... */ });

注意事项

• 百度网盘要求文件路径必须以 /apps/{appName}/ 为前缀，AppName 配置项用于指定应用名称
• 文件 ID 使用 fs_id（文件系统 ID）的字符串表示
• 访问令牌通过外部 OAuth 授权码流程获取，可配置 RefreshToken 实现自动刷新
• 大文件（超过 4 MB 默认阈值）自动使用三步分块上传流程
• 下载文件需要两步操作：先获取下载链接（dlink），再通过 dlink 下载内容

依赖

相关包

• Bitzsoft.Integrations.CloudDrive -- 抽象层
• Bitzsoft.Integrations.CloudDrive.All -- 聚合包（一键注册全部供应商）
• Bitzsoft.Integrations.CloudDrive.Nutstore -- 坚果云
• Bitzsoft.Integrations.CloudDrive.Microsoft365 -- Microsoft 365 / OneDrive
• Bitzsoft.Integrations.CloudDrive.Gokuai -- 够快云库
• Bitzsoft.Integrations.CloudDrive.AnyShare -- 爱数 AnyShare
• Bitzsoft.Integrations.CloudDrive.Aliyun -- 阿里云网盘 PDS
• Bitzsoft.Integrations.Compatibility -- 基础工具库