包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.FileStorage.Qiniu |
| Provider ID | qiniu |
| 鉴权 | AccessKey + SecretKey |
配置字段（QiniuOptions）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
AccessKey | string | 是 | — | 七牛云 AccessKey |
SecretKey | string | 是 | — | 七牛云 SecretKey |
DefaultBucketName | string | 是 | — | 默认存储桶名称（空间名） |
Domain | string | 是 | — | 存储桶绑定的下载域名 |
UploadEndpoint | string | 否 | https://upload.qiniup.com | 上传区域端点 |
RsHost | string | 否 | https://rs.qiniu.com | RS 管理接口主机 |
RsfHost | string | 否 | https://rsf.qiniup.com | RSF 列举接口主机 |
HttpClientName | string | 否 | — | HttpClient 名称 |
UploadUrlExpiration | int | 否 | 3600 | 上传地址过期时间（秒） |
DownloadUrlExpiration | int | 否 | 43200 | 下载地址过期时间（秒） |
配置示例
{ "FileStorage": { "Qiniu": { "AccessKey": "your-access-key", "SecretKey": "your-secret-key", "DefaultBucketName": "my-bucket", "Domain": "https://cdn.example.com", "UploadEndpoint": "https://upload.qiniup.com" } }}DI 注册
builder.Services.AddBitzsoftQiniuFileStorage(builder.Configuration.GetSection("FileStorage:Qiniu"));使用示例
public class QiniuService(IFileStore store){ public async Task DeleteAsync(string fileName) { await store.DeleteFileAsync(fileName); }}已知限制
Domain是下载域名，必须与七牛控制台绑定的 CDN/源站域名一致。- 上传端点按区域不同：华东
upload.qiniup.com、华北up-z1.qiniup.com、华南up-z2.qiniup.com。