# qiniu-bucket-and-files

**Repository Path**: marvinma/qiniu-bucket-and-files

## Basic Information

- **Project Name**: qiniu-bucket-and-files
- **Description**: 通过七牛的key和secret列出七牛的所有空间，以及空间下的文件，支持删除操作。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qiniu Bucket and Files Manager (七牛云空间及文件管理器)

## 简介

本项目是一个用于管理七牛云 Kodo 存储空间的 Web 工具。其核心目标是帮助用户快速定位并清理存储空间中的大文件，从而有效管理存储成本。

用户通过配置 AccessKey 和 SecretKey 后，可以轻松完成以下操作：
1.  列出账户下的所有存储空间 (Bucket)。
2.  选择特定空间，查看其中的所有文件。
3.  **文件列表会默认按文件大小从大到小排序**，让大文件一目了然。
4.  提供删除文件的功能，方便用户直接清理不再需要的大文件。

## 主要功能

-   **身份验证**: 通过 AccessKey / SecretKey 连接到您的七牛云账户。
-   **空间陈列**: 清晰地展示您账户下所有的存储空间。
-   **文件浏览与排序**: 按文件大小（降序）列出指定空间中的所有文件。
-   **大文件定位**: 核心功能，旨在第一时间帮您找到占用空间最多的文件。
-   **文件删除**: 提供便捷的删除操作来释放存储空间。

## 技术栈

-   **后端**: Node.js + Express.js
-   **七牛云 SDK**: 官方 `qiniu` NPM 包
-   **前端**: 原生 HTML, CSS, JavaScript (Vanilla JS)

## 如何使用

1.  **克隆项目**:
    ```bash
    git clone https://github.com/your-username/qiniu-bucket-and-files.git
    cd qiniu-bucket-and-files
    ```

2.  **安装依赖**:
    ```bash
    npm install
    ```

3.  **配置密钥**:
    - 复制 `.env.example` 文件为 `.env`。
    - 在 `.env` 文件中填入您的七牛云 AccessKey 和 SecretKey。

4.  **运行**:
    ```bash
    node app.js
    ```
5. **使用场景**
   七牛云存储空间占用过多，但是不知道哪些文件占用多，七牛也不提供工具。

6.  **使用**:
    - 在浏览器中打开 `http://localhost:3000`。
    - 应用会自动加载并显示所有的 Bucket 列表。
    - 点击任意 Bucket 名称，右侧将加载该 Bucket 内的文件列表（已按大小排序）。
    - 针对需要删除的文件，点击“删除”按钮并确认即可。
7. 预览截图
   ![首页](imgs/index.png)
   ![图片预览](imgs/img.png)