# qiniu

> Node wrapper for Qiniu Resource (Cloud) Storage API

Latest version **7.15.2** (published 2026-04-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install qiniu
pnpm add qiniu
yarn add qiniu
bun add qiniu
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 7.15.2 |
| Published | 2026-04-22 |
| First published | 2012-07-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >= 6 |
| Dependencies | 13 |
| Unpacked size | 328.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 590 |
| Author | sdk@qiniu.com |
| Maintainers | qiniusdk, qiniu-pkg |
| Keywords | cloud, storage, s3, qiniu, web-service |

## Links

- npm: https://www.npmjs.com/package/qiniu
- Repository: https://github.com/qiniu/nodejs-sdk
- Homepage: https://github.com/qiniu/nodejs-sdk#readme
- Issues: https://github.com/qiniu/nodejs-sdk/issues
- npm.io page: https://npm.io/package/qiniu

## Dependencies (13)

- [mime](https://npm.io/package/mime.md) ^2.4.4
- [crc32](https://npm.io/package/crc32.md) ^0.2.2
- [before](https://npm.io/package/before.md) ^0.0.1
- [mkdirp](https://npm.io/package/mkdirp.md) ^0.5.5
- [urllib](https://npm.io/package/urllib.md) ^2.41.0
- [destroy](https://npm.io/package/destroy.md) ^1.0.4
- [mockdate](https://npm.io/package/mockdate.md) ^3.0.5
- [encodeurl](https://npm.io/package/encodeurl.md) ^1.0.1
- [formstream](https://npm.io/package/formstream.md) ^1.1.0
- [typescript](https://npm.io/package/typescript.md) ^4.9.4
- [tunnel-agent](https://npm.io/package/tunnel-agent.md) ^0.6.0
- [block-stream2](https://npm.io/package/block-stream2.md) ^2.0.0
- [agentkeepalive](https://npm.io/package/agentkeepalive.md) ^4.0.2

## Alternatives

- [localforage](https://npm.io/package/localforage.md) — 6.2M weekly downloads
- [localforage-observable](https://npm.io/package/localforage-observable.md) — 30.8K weekly downloads
- [@y/y](https://npm.io/package/@y/y.md) — 30.1K weekly downloads
- [@metaobjectsdev/render](https://npm.io/package/@metaobjectsdev/render.md) — 3.5K weekly downloads
- [@ledgerhq/coin-algorand](https://npm.io/package/@ledgerhq/coin-algorand.md) — 1.1K weekly downloads

## Recent versions

- 7.15.2 (latest) — 2026-04-22
- 7.15.1 — 2026-01-27
- 7.15.0 — 2026-01-26
- 7.14.0 — 2024-11-11
- 7.13.0 — 2024-09-25
- 7.12.0 — 2024-05-06
- 7.11.1 — 2024-03-12
- 7.11.0 — 2023-12-26
- 7.10.1 — 2023-11-27
- 7.10.0 — 2023-10-18
- 7.9.0 — 2023-08-02
- 7.8.0 — 2022-10-28
- 7.7.0 — 2022-06-08
- 7.6.1 — 2022-05-27
- 7.6.0 — 2022-05-01
- … 50 more at https://npm.io/package/qiniu/versions

## README

# Qiniu Cloud SDK for Node.js

[![@qiniu on weibo](http://img.shields.io/badge/weibo-%40qiniutek-blue.svg)](http://weibo.com/qiniutek)
[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE.md)
[![NodeJS CI](https://github.com/qiniu/nodejs-sdk/actions/workflows/ci-test.yml/badge.svg?branch=master)](https://github.com/qiniu/nodejs-sdk/actions/workflows/ci-test.yml)
[![GitHub release](https://img.shields.io/github/v/tag/qiniu/nodejs-sdk.svg?label=release)](https://github.com/qiniu/nodejs-sdk/releases)
[![Code Climate](https://codeclimate.com/github/qiniu/nodejs-sdk.svg)](https://codeclimate.com/github/qiniu/nodejs-sdk)
[![Coverage Status](https://codecov.io/gh/qiniu/nodejs-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/qiniu/nodejs-sdk)
[![Latest Stable Version](https://img.shields.io/npm/v/qiniu.svg)](https://www.npmjs.com/package/qiniu)

## 下载

### 从 npm 安装

这是我们建议的方式

```bash
$ npm install qiniu
```

### 从 release 版本下载

下载地址：[https://github.com/qiniu/nodejs-sdk/releases](https://github.com/qiniu/nodejs-sdk/releases)

这里可以下载到旧版本的SDK，release 版本有版本号，有 [CHANGELOG](https://github.com/qiniu/nodejs-sdk/blob/master/CHANGELOG.md)，使用规格也会比较稳定。

### 从 git 库下载

你可以直接用 git clone 下载源代码来使用。但是请注意非 master 分支的代码可能会变更，应谨慎使用。

## 使用

参考文档：[七牛云存储 Node.js SDK 使用指南](http://developer.qiniu.com/kodo/sdk/nodejs)

## 测试
```
$ cd ./test/
$ source test-env.sh
$ mocha --grep 'bucketinfo'
```

## 贡献代码

1. Fork
2. 创建您的特性分支 (`git checkout -b my-new-feature`)
3. 提交您的改动 (`git commit -am 'Added some feature'`)
4. 将您的修改记录提交到远程 `git` 仓库 (`git push origin my-new-feature`)
5. 然后到 github 网站的该 `git` 远程仓库的 `my-new-feature` 分支下发起 Pull Request

## 许可证

Copyright (c) 2015 qiniu.com

基于 MIT 协议发布:

* [www.opensource.org/licenses/MIT](http://www.opensource.org/licenses/MIT)

---
_Source: https://npm.io/package/qiniu · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._