Complete S3 setup · Bitiful (Recommended)

Bitiful setup (Recommended)

Bitiful is ShrimpSend’s top recommended custom S3 provider: S3-compatible API, pay-as-you-go billing, and pricing that is often lower than major domestic clouds. See the official price comparison.

When to use

  • You want cost-effective object storage with a stable S3-compatible service in China.
  • You manage your own bucket and access keys on Bitiful.

Create a bucket

  1. Sign in to the Bitiful console.
  2. Create a new bucket. For security, use a private bucket.
Create bucket step 1
Create bucket step 1
Create bucket step 2
Create bucket step 2

Endpoint and region

On the bucket details page, find the service endpoint and availability zone:

Service endpoint and region
Service endpoint and region
  • Endpoint must be https://s3.bitiful.net — the https:// prefix is required; do not omit it or use http://.
  • Region is the availability zone code shown in the console.

Create Access Key / Secret Key

  1. Add a sub-account (the sub-account name must not match the bucket name, or uploads may fail):
Add sub-account
Add sub-account
  1. Grant read and write permissions to the sub-account:
Grant read/write permissions
Grant read/write permissions
  1. Create a key for the sub-account and save the Access Key ID and Secret Access Key:
Add key step 1
Add key step 1
Add key step 2
Add key step 2

Configure CORS

Browser uploads require bucket CORS. Add a rule with Allowed Origins including at least:

https://xiachuan.net

Add https://www.xiachuan.net if you use the www subdomain. Allowed Methods: GET, PUT, POST, DELETE, HEAD. AllowedHeaders: * recommended. ExposeHeaders: at least ETag.

ShrimpSend settings

Open S3 configuration from either entry point:

  1. Settings → S3 — saved globally for all devices signed into the same account.
  2. S3 cloud relay session — open the S3 cloud relay chat and use S3 settings inside the session.

Fill in the fields from the Bitiful console:

FieldNotes
EndpointMust be https://s3.bitiful.net (include https://; do not omit)
RegionAvailability zone from bucket details
BucketBucket name
Path-style accessOff (Bitiful uses virtual-hosted-style URLs)
Access Key IDSub-account key access key
Secret Access KeySub-account key secret
ShrimpSend S3 settings (Bitiful example)
ShrimpSend S3 settings (Bitiful example)

Test connection

After saving, click Test connection. If it fails, check:

  1. Endpoint includes https://.
  2. Region and Bucket match the console.
  3. Sub-account has read/write on the bucket.
  4. CORS includes your web Origin.
  5. Sub-account name does not conflict with the bucket name.