开始使用
INFO
如果你之前使用过 v1 版本（在 2025 上半年及之前的版本），可以参考 从 v1 升级 来迁移到 v2 版本。v2 版本在功能上没有太大变化，应该可以直接上手。
作为一个管理 S3 上图片的工具，S3 Image Port 需要您提供 S3 储存桶的信息来访问、上传图片。
配置 S3（或其他兼容 S3 协议的服务）
如果您还没有一个 S3 储存桶，请根据下面的指南创建一个。简单来讲，这需要 3 步：
- 在对应平台上创建 S3 兼容的储存桶。
- 获取访问储存桶所需的端点、密钥等信息。
- 设置储存桶的访问权限和 CORS。
以上 3 点都是使用 S3 Image Port 必不可少的步骤。
🔴 需要配置 CORS！
由于我们是一个网页项目，配置 CORS 是必须的。目前用户反馈“连不上”的大多数原因都是没有配置 CORS。
关于如何配置 CORS，请继续阅读。
平台逐步指南
目前，我们为以下平台编写了逐步指南，如果这正是你在使用的，可以直接点击链接去那里查看，在做完教程中的内容后，您应该就可以使用 S3 Image Port 了！
- Cloudflare R2 逐步指南 中提供了如何在使用 Cloudflare R2 的情况下配置 本面板的 S3 设置的逐步指南。
通用要求
S3 Image Port 需要以下信息/权限以正常工作：
Endpoint,Region,Access Key ID,Secret Access Key等连接用的信息，- 一个直接用来访问图片的链接前缀，我们称之为
Public URL， - 正确的 CORS 配置。
第一点不多赘述，可以自行查询如何获取。
Public URL
在目前版本 (1.6.0) 中，储存桶中的图片必须可以通过一个链接直接访问。
例如，一张图片在储存桶中的路径是 i/2024/05/29/name.jpg，而你可以通过 https://i.yfi.moe/i/2024/05/29/name.jpg 这个链接直接（不需要验证地）访问到它，那么 https://i.yfi.moe/ 就是你需要填写的 Public URL.
如果你直接使用了某些 S3 兼容服务的“公开储存桶”功能，也是同理。例如，对于 Cloudflare R2，它应该形如 https://pub-<一堆字符>.r2.dev。对于腾讯云 COS，应该形如 https://<BucketName-APPID>.cos.<Region>.myqcloud.com
CORS 配置
什么是 CORS？
跨源资源共享（CORS，或通俗地译为跨域资源共享）是一种基于 HTTP 头的机制，该机制通过允许服务器标示除了它自己以外的其他源（域、协议或端口），使得浏览器允许这些源访问加载自己的资源。
简单来讲，就是如果 A.com 的网站想要访问 B.com 网站上的资源，需要 B.com 配置 CORS 来同意。在现在的情况下，imageport.app 相当于 A.com，而你的 S3 储存桶的链接类似于 B.com，因此我们需要在 S3 储存桶那边配置 CORS 策略来同意来自 imageport.app 的访问请求。
为了正常使用，你需要
- 将
https://imageport.app放入允许的 Origin 中， - 允许
GET,HEAD,POST,PUT和DELETE方法， - 并且允许
*header。
如果感到迷惑，可以查看上方的 平台逐步教程 中是否有你使用的平台的详细教程，或者自行查询平台文档。