An end-to-end-encrypted file-sharing platform built on an S3-compatible object storage. It uses Cloudflare Workers to sign temporary upload and download URLs, and encrypts and decrypts the files in the browser using WebCrypto. The frontend is written in Svelte. Metadata and upload sessions are stored in Cloudflare KV.
The app is deployed as a Cloudflare Worker with static assets.
Copy wrangler.toml.tmpl to wrangler.toml and fill in the following values:
patternunder[[routes]]: The custom domain to serve the app from.S3_ENDPOINT: The endpoint of your S3-compatible object storage.S3_BUCKET: The name of the bucket you want to use.- The IDs of two KV namespaces:
METADATA: Stores the (partially encrypted) server-side file metadata.UPLOAD_SESSIONS: Stores the state of pending and in-progress uploads.
ACCESS_TEAM_DOMAIN,ACCESS_AUD_TAGandACCESS_ADMIN_EMAIL: The Cloudflare Access configuration for the admin interface, see Admin interface.
Additionally, configure the following secrets using wrangler secret put <name>:
S3_ACCESS_KEY: The access key for your S3-compatible object storage.S3_SECRET_KEY: The secret key for your S3-compatible object storage.FILE_ID_KEY: A base64-encoded random key used to derive file IDs from upload tokens, e.g. generated withopenssl rand -base64 32.
Then build and deploy with npm run deploy.
The admin interface at /admin allows creating new upload URLs from the browser.
It is protected by Cloudflare Access,
and the worker additionally verifies the Access token on all /api/admin/ routes.
To set it up:
- In the Cloudflare Zero Trust dashboard,
create a self-hosted Access application with two destinations on your domain: the paths
/adminand/api/admin. - Attach a policy with the action Allow that includes only the email address of the admin.
- Fill in the vars in
wrangler.toml:ACCESS_TEAM_DOMAIN: Your team domain, e.g.https://<team>.cloudflareaccess.com(no trailing slash).ACCESS_AUD_TAG: The Application Audience (AUD) tag of the Cloudflare Access application.ACCESS_ADMIN_EMAIL: The email address of the admin, as shown by/cdn-cgi/access/get-identity.
Files can be uploaded through upload URLs, which can be created in the admin interface and shared with anyone who should be able to upload a file.
The command-line tool s3share-cli offers additional ways to manage the files from a terminal:
- Upload files directly, without the need for an upload URL
- Download files without the web interface
- List and delete uploaded files
- Create upload URLs