> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Blob Storage

> 具备全球 CDN、零流量费用以及 99.999999999% 可用性的可扩展无服务器存储。Square Cloud Blob Storage 是需要可靠存储的应用的理想之选。

<Frame>
  <img src="https://squarecloud.app/banners/zh/blob.png" alt="Square Cloud Blob Storage 服务概览" style={{ borderRadius: "0.2rem" }} />
</Frame>

## 为什么选择 Square Cloud Blob Storage？

作为**拉丁美洲最大的机器人托管平台**，深受**巴西 100 大 Discord 服务器中 80 家**的信赖，我们打造 Blob Storage 是为了解决我们自己社区不断遇到的一个问题：**Discord 的 CDN 从来就不是为存储后端设计的**，链接会失效、过期或被限流。Blob Storage 用一个专为持久性设计的、以 S3 为后端的对象存储取代了它。

该架构在设计上刻意做到简单而稳健：**S3（IDrive e2）是对象的真实数据源**，元数据存放在 MongoDB 中，前端由 **Cloudflare CDN** 负责边缘分发。这为你带来了 S3 设计的**约 11 个 9 的持久性**，同时享有全球缓存的读取延迟。每个套餐都提供**慷慨的内置配额**，并对超额部分采用**透明的按量付费**模式。

<Note>Blob Storage 目前处于 beta 阶段。如果你有任何反馈，请[联系我们](https://squarecloud.app/zh/support)。</Note>

## 核心特性

<CardGroup cols={2}>
  <Card title="无流量费用" icon="money-bill">
    \*\*零入站/出站费用。\*\*想上传和分发多少就上传和分发多少，你只需为存储付费，永远不必为带宽付费。
  </Card>

  <Card title="S3 支撑的持久性" icon="server">
    对象存储在 **S3 真实数据源（IDrive e2）** 上，其设计目标为 **99.999999999% 的持久性**，任何单块磁盘故障都不会丢失你的数据。
  </Card>

  <Card title="全球 Cloudflare CDN" icon="globe">
    通过 **Cloudflare 的边缘网络及边缘缓存**分发，热点资源可就近送达全球各地的用户。
  </Card>

  <Card title="随你扩展" icon="chart-line">
    可容纳**高达 1PB 的存储**和**每天 10 亿次请求**，同一套存储可从业余项目一路扩展到生产级流量。
  </Card>
</CardGroup>

## 配额与定价

Blob Storage 提供清晰、透明的定价，让你可以选择符合自身需求的套餐。

### 内置配额

每个付费套餐都包含**免费存储配额**，无需额外付费：

| 套餐         | 包含的免费存储    |
| ---------- | ---------- |
| Hobby-1    | **5 GB**   |
| Hobby-2    | **15 GB**  |
| Standard-4 | **30 GB**  |
| Standard-6 | **50 GB**  |
| Standard-8 | **100 GB** |
| Pro-12     | **200 GB** |
| Pro-16     | **250 GB** |
| Pro-24     | **250 GB** |
| Enterprise | **250 GB** |

### 按量付费超额

如果你的用量超出了内置配额，将自动切换到**按量付费**，**只为你所使用的额外空间**付费。

<Card title="超额存储费用" icon="coins">
  超出免费配额后，**每额外 1 GB 收费 R\$ 0.25**。
</Card>

<Info>Blob Storage 服务及按量付费功能**仅对付费套餐**的订阅者开放。</Info>

## 支持的文件扩展名

我们的平台强制执行**严格的 MIME 类型白名单**，以确保服务的**安全性与完整性**。此扩展名限制是一项**关键的安全措施**，可防止恶意文件上传，并保持对**企业安全策略**的合规。

| 类别       | 支持的扩展名                                                                                              |
| -------- | --------------------------------------------------------------------------------------------------- |
| **视频**   | `.mp4`, `.mpeg`, `.webm`, `.flv`, `.m4v`                                                            |
| **图像**   | `.jpg`, `.png`, `.apng`, `.tiff`, `.gif`, `.webp`, `.bmp`, `.svg`, `.ico`, `.cur`, `.heic`, `.heif` |
| **音频**   | `.wav`, `.ogg`, `.opus`, `.m4a`, `.mp3`, `.aac`                                                     |
| **文本**   | `.html`, `.css`, `.csv`, `.txt`, `.sql`                                                             |
| **应用程序** | `.xml`, `.sql`, `.sqlite3`, `.p12`, `.pdf`, `.json`, `.js`                                          |

<Warning>
  **MIME 类型校验**：所有文件都会经过**二进制签名验证**，以防止**扩展名伪造**和**恶意上传**。
</Warning>

<Note>如需申请对其他文件类型的支持，或讨论特定的使用场景，请[联系我们的技术团队](https://squarecloud.app/zh/support)。</Note>

## 性能与基准测试

我们的基础设施经过了**大量基准测试**，以确保 Square Cloud 提供**稳健、可靠的无服务器存储解决方案**。以下是一些关键发现：

* **延迟**：平均文件接收延迟约为 **\~11ms**。
* **吞吐量**：在典型网络连接下，平均传输速率约为 **\~12.5–18.75 MB/s（100–150 Mbps）**，在 >1–2 Gbps 的网络上可达**约 500 Mbps**。
* **可用性**：平均可用性为 **99.999999999%（11 个 9）**（基于 S3 的设计）。

在我们于纽约进行的内部测试中，延迟保持在**极低水平**，**远低于平均值**。

<Frame>
  <img src="https://cdn.squarecloud.app/docs/services/blob-global-latency-test.webp" alt="Blob Storage 全球延迟基准测试" style={{ borderRadius: "0.5rem" }} />
</Frame>

<Info>**注意**：基准测试结果基于受控测试，并可能因**地理位置**、**文件大小**、**网络质量**和**峰值使用**而显著变化。为获得最佳性能，请在你的生产环境中运行测试。</Info>
<Warning>**区域限制**：由于**距离数据中心的物理距离**和**本地网络基础设施**的原因，位于**非洲**及部分**亚洲地区**的用户可能会遇到更高的延迟。</Warning>

## 如何托管你的文件

<Steps>
  <Step title="通过 Endpoint 上传">
    将你的文件上传到 [POST endpoint](/zh/blob-reference/endpoint/post)。
  </Step>

  <Step title="通过 URL 访问">
    使用上传响应中提供的 URL 访问你的文件。
  </Step>
</Steps>

整个流程**极为简化**：使用你的账户 API key 进行身份验证，并通过**单个 HTTPS 请求**上传。**无需任何额外配置**或复杂的基础设施。Square Cloud 会为你**处理一切**。