Qiniu Go SDK

七牛云官方 Go SDK，提供对象存储、CDN、直播、实时音视频、短信、视频监控、IoT 设备联网、IAM、多媒体处理、审计日志、沙箱等服务的 Go 客户端。

安装

go get github.com/qiniu/go-sdk/v7

在 go.mod 中：

require github.com/qiniu/go-sdk/v7 v7.29.0

要求 Go 1.22 或更高版本。

快速开始

package main

import (
    "context"
    "fmt"
    "time"

    "github.com/qiniu/go-sdk/v7/storagev2/credentials"
    "github.com/qiniu/go-sdk/v7/storagev2/http_client"
    "github.com/qiniu/go-sdk/v7/storagev2/uploader"
    "github.com/qiniu/go-sdk/v7/storagev2/uptoken"
)

func main() {
    // 创建凭证（AK/SK 从 https://portal.qiniu.com/user/key 获取）
    cred := credentials.NewCredentials("AccessKey", "SecretKey")

    // 创建上传策略和凭证
    putPolicy, _ := uptoken.NewPutPolicy("my-bucket", time.Now().Add(time.Hour))

    // 创建上传管理器
    uploadManager := uploader.NewUploadManager(&uploader.UploadManagerOptions{
        Options: http_client.Options{Credentials: cred},
    })

    // 上传文件
    objectName := "my-file.txt"
    err := uploadManager.UploadFile(context.Background(), "/path/to/file", &uploader.ObjectOptions{
        BucketName: "my-bucket",
        ObjectName: &objectName,
        UpToken:    uptoken.NewSigner(putPolicy, cred),
    }, nil)
    if err != nil {
        fmt.Println("上传失败:", err)
        return
    }
    fmt.Println("上传成功")
}

功能模块

对象存储

其他云服务

基础设施

示例

examples/ 目录包含各功能模块的示例代码：

• 对象存储：表单上传、断点续传、文件管理（stat/copy/move/delete/fetch）、列举文件、异步抓取、下载
• CDN：刷新、预取、流量/带宽查询、日志下载、时间戳防盗链
• 多媒体处理：持久化数据处理（pfop）
• 实时音视频：RTC 房间管理
• 沙箱：创建、生命周期管理、文件操作、命令执行、模板管理

文档

• 七牛 SDK 文档站
• GoDoc API 文档
• 项目 Wiki
• AGENTS.md — SDK 开发维护指南（适用于 AI 编码工具）
• llms.txt — AI 编码工具文档索引（支持 Context7 MCP）

许可证

MIT