Подготовка
Создайте отдельный бакет и ограниченные ключи, затем откройте Framecho › Настройки › Облако › S3.
- Создайте отдельный бакет Framecho и запишите имя и регион.
- Создайте ключ только для этого бакета с правами загрузки, чтения, multipart и удаления.
- Выберите закрытый или публичный режим. Для закрытого бакета публичный домен не нужен.
- Запустите проверку: Framecho загрузит, прочитает и удалит тестовый объект.
Закрытый бакет + временные ссылки
Бакет остаётся закрытым. Ссылки действуют 1 час, 24 часа или 7 дней.
Публичное чтение + постоянные ссылки
Ссылки не истекают. Разрешайте только чтение, никогда публичную запись.
Скрывайте Access Key ID и Secret на снимках. Создайте отдельный ключ только для одного бакета.
Поля Framecho
Для встроенного провайдера укажите регион; Endpoint нужен вручную только для Custom.
Выберите провайдера
Alibaba Cloud OSS
Use a RAM user AccessKey. Keep the bucket private; public HTML pages need a custom domain to open in a browser.
- Create an OSS bucket and copy its Region ID.
- Create a dedicated RAM user and AccessKey scoped to object read, write, and delete in the bucket.
- Choose Alibaba Cloud OSS in Framecho and enter the region, bucket, AccessKey ID, and AccessKey Secret.
- Use Private and verify. Configure public read only when permanent public URLs are required.
cn-hongkongyour-bucketRAM AccessKey IDRAM AccessKey SecretOSS forces HTML to download on its default domain. Use a custom domain in Public mode for browser share pages; never enable public write.
Tencent Cloud COS
COS maps CAM SecretId and SecretKey to S3 credentials. Bucket names normally include the APPID.
- Create a COS bucket and copy its Region ID and full name including APPID.
- Create a scoped CAM user/key with object read, write, and delete permissions.
- Choose Tencent Cloud COS; put SecretId in Access Key ID and SecretKey in Secret Access Key.
- Use private expiring links, or grant anonymous read and enter a public domain.
ap-shanghaiexample-1250000000SecretIdSecretKeyCOS default domains may force HTML downloads. For browser share pages, use an approved custom or CDN domain in Public mode.
Cloudflare R2
R2 needs your Account ID and R2-specific API token credentials—not a general Cloudflare API token.
- Create an R2 bucket.
- Under Manage API Tokens, create an Object Read & Write token scoped to the bucket.
- Save the one-time Secret Access Key, Access Key ID, and your Cloudflare Account ID.
- Choose Cloudflare R2 in Framecho, fill all fields, and verify.
Cloudflare Account IDautoR2 Access Key IDR2 Secret Access KeyFor public mode, attach a custom domain. r2.dev is rate-limited and intended for development. Private mode does not need Public Development URL.
Backblaze B2
Create a standard Application Key. The Master Application Key does not work with the S3-compatible API.
- Copy the bucket Endpoint and its region, such as us-east-005.
- Under Application Keys, create a standard key with read/write access to the bucket.
- Put the 25-character keyID in Access Key ID and the one-time applicationKey in Secret Access Key.
- Choose Backblaze B2, enter region and bucket, and verify.
us-east-005your-bucket25-character keyIDapplicationKeyDo not enter the 12-character account/master ID, bucket ID, or key name. The region must exactly match the bucket Endpoint.
Amazon S3
Use long-term access keys for a dedicated IAM principal scoped to the Framecho bucket and prefix.
- Create an S3 bucket and note its Region.
- Create an IAM identity/key with Put/Get/Delete, ListBucket, and multipart permissions on the bucket.
- Choose Amazon S3 and enter Region, Bucket, Access Key ID, and Secret Access Key.
- Keep Block Public Access enabled and use private expiring links.
ap-east-1your-bucketIAM Access Key IDIAM Secret Access KeyNever use AWS root credentials. Public mode requires deliberate Block Public Access and read-only bucket-policy changes and is riskier.
Qiniu, MinIO, and other S3 services
Any HTTPS SigV4 service supporting PUT, multipart upload, GET, and batch delete can be tested.
- Copy the public S3 API endpoint and signing region from the provider.
- Choose Custom and enter the full HTTPS endpoint, region, bucket, and credentials.
- Select virtual-hosted or path-style addressing as required; MinIO often uses path-style.
- Run verification and use the service only after upload, read, and delete all pass.
https://s3.example.comus-east-1As requiredS3 Access Key / Secret KeyFor Qiniu Kodo, use the S3 public endpoint shown in the bucket overview; the Region is the region segment in that endpoint.
Типичные ошибки
SignatureDoesNotMatchThe secret, region, endpoint, or system clock differs. Recopy credentials and use the region of the same bucket.
NoSuchBucketBucket name and region do not match. For Tencent COS, include the APPID suffix.
InvalidAccessKeyIdThe wrong credential type or field was used. B2 requires the 25-character keyID of a standard Application Key.
NSURLErrorDomain -1003The endpoint hostname does not resolve. Check for a console URL, private endpoint, bucket domain, typo, or bad region.
Link downloads instead of openingOSS/COS default-domain policy or the file type can force downloads. Use a custom domain in Public mode for browser HTML pages.
Upload passes but read failsThe key can write, but the bucket/domain cannot read, or the public domain points at another bucket.
Запустите проверку ещё раз
После трёх успешных шагов файлы идут прямо в ваш бакет, а ключи остаются в Связке ключей macOS.