Andreas Reinhold / reiniandClaude Opus 5
40e35bab0e
A 6 GB upload kept a customer waiting long after its progress bar
reached 100%. The server wrote every upload three times: PHP's
temporary file, Livewire's copy of it ("Processing files...") and the
encrypted file ("Create Share Link"), each a full rewrite of a slow
disk. The unencrypted copy also stayed behind in livewire-tmp.
Now the uploader's browser encrypts each file in 16 MB chunks with
WebCrypto and PUTs them one at a time; the server checks each chunk in
memory and writes it once, already encrypted. Creating the share only
wraps its key and saves the options. A 200 MB upload through the
Docker image took 2.8 s, and its download matched byte for byte.
- SEALCHK2: a 19-byte header (chunk size, 7-byte nonce prefix), then
ciphertext and tag per chunk. Each nonce holds the chunk index and a
last-chunk flag (the STREAM construction), so cut or reordered files
fail to decrypt. SEALCHK1 and the single-block format still read.
- Envelope encryption: one random key per share. With a password it is
wrapped with Argon2id (sodium, libsodium's interactive limits) in
shares.wrapped_key, which names its parameters. Password shares from
before keep their PBKDF2-derived key.
- The upload page registers each selection with FileUploader into a
pending share of its own, lists the files with their progress, retries
a failed chunk after 1-16 s, then offers Retry; Remove and Cancel
abort. UploadChunkController only accepts chunks from the session that
started the share: a repeat is acknowledged, a skip gets 409 with the
count stored. Chunks go out as Blobs, which Chromium sends about eight
times faster than ArrayBuffers.
- Uploads need a secure context: over plain HTTP the page says HTTPS is
needed and takes no files. The Docker image gains AUTO_HTTPS, which
serves Let's Encrypt on 443 for SERVER_NAME and redirects 80; without
it the container stays on HTTP 80 behind a proxy. docker/Caddyfile was
never loaded and is gone; docker/healthcheck.sh covers both modes.
- "Download all" streams the ZIP with maennchen/zipstream-php (STORE,
ZIP64) instead of decrypting whole files into memory and writing the
archive unencrypted to /tmp.
- Pending shares count towards the quota, stay out of the admin
dashboard and 404 everywhere else. shares:cleanup deletes uploads idle
for 4 hours and Livewire temporary files older than that.
- PHP's upload limits no longer cap the admin's max file size and
default to 64M; LIVEWIRE_MAX_UPLOAD_TIME is gone and
UPLOAD_CHUNK_SIZE_MB is new.
- Tests cover the format, key wrapping, registration limits, the chunk
endpoint's answers, completing a share, the streamed ZIP, cleanup,
and in Chromium a real chunked upload and the HTTPS warning; the
selected-files overflow test runs again. README, website, CHANGELOG
and .ai/rules follow.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
100 lines
4.1 KiB
YAML
100 lines
4.1 KiB
YAML
# ============================================
|
|
# SealShare - Docker Compose Configuration
|
|
# ============================================
|
|
#
|
|
# Quick start:
|
|
# 1. Copy this file: cp docker-compose.example.yml docker-compose.yml
|
|
# 2. Edit the settings below (APP_URL is required; uploads need HTTPS, see below)
|
|
# 3. Start: docker compose up -d
|
|
# 4. Open your browser to your configured domain
|
|
#
|
|
# Note: APP_KEY is auto-generated on first start if not set.
|
|
# Copy it from the logs into your docker-compose.yml to persist across restarts.
|
|
#
|
|
# ============================================
|
|
|
|
services:
|
|
# ------------------------------------------
|
|
# SealShare Application (FrankenPHP/Octane)
|
|
# ------------------------------------------
|
|
app:
|
|
image: gitea.nonameweb.ch/nonameweb/sealshare:latest
|
|
restart: unless-stopped
|
|
ports:
|
|
- "80:80" # HTTP
|
|
- "443:443" # HTTPS (a Let's Encrypt certificate with AUTO_HTTPS)
|
|
- "443:443/udp" # HTTP/3 (QUIC)
|
|
volumes:
|
|
- sealshare_storage:/app/storage/app # Uploaded & encrypted files
|
|
- sealshare_database:/app/database # SQLite database
|
|
- caddy_data:/data # TLS certificates
|
|
- caddy_config:/config # Caddy configuration
|
|
environment:
|
|
# --- REQUIRED ---
|
|
APP_URL: # Your full URL, e.g. https://share.example.com
|
|
# APP_KEY: # Auto-generated if not set. Copy from logs to persist across restarts.
|
|
|
|
# --- HTTPS ---
|
|
# Files are encrypted in the uploader's browser, which browsers only allow over HTTPS (or on
|
|
# localhost). Either let this container fetch a Let's Encrypt certificate (ports 80 and 443
|
|
# reachable from the internet), or put a reverse proxy that terminates TLS in front of port 80.
|
|
# AUTO_HTTPS: "true"
|
|
# SERVER_NAME: share.example.com # The domain to fetch the certificate for (only with AUTO_HTTPS)
|
|
|
|
# --- Optional: Application ---
|
|
# APP_ENV: production
|
|
# APP_DEBUG: "false"
|
|
# LOG_CHANNEL: stderr
|
|
# LOG_LEVEL: warning
|
|
|
|
# --- Optional: Database ---
|
|
# DB_CONNECTION: sqlite # Options: sqlite, mysql, pgsql
|
|
# DB_HOST: # Required for mysql/pgsql
|
|
# DB_PORT: # Required for mysql/pgsql
|
|
# DB_DATABASE: # Required for mysql/pgsql
|
|
# DB_USERNAME: # Required for mysql/pgsql
|
|
# DB_PASSWORD: # Required for mysql/pgsql
|
|
|
|
# --- Optional: Octane ---
|
|
# OCTANE_HTTPS: "false" # Set to "true" when using HTTPS
|
|
# OCTANE_MAX_EXECUTION_TIME: 300 # Max request execution time (seconds)
|
|
|
|
# --- Optional: Uploads ---
|
|
# UPLOAD_CHUNK_SIZE_MB: "16" # Each encrypted chunk the browser sends; a reverse proxy must accept a little more
|
|
|
|
# --- Optional: PHP limits ---
|
|
# PHP_UPLOAD_MAX_FILESIZE: "64M" # Only for the admin's logo upload: shares upload in chunks
|
|
# PHP_POST_MAX_SIZE: "64M"
|
|
# PHP_MAX_EXECUTION_TIME: "300"
|
|
# PHP_MAX_INPUT_TIME: "300"
|
|
# PHP_MEMORY_LIMIT: "512M"
|
|
healthcheck:
|
|
test: ["CMD", "/app/docker/healthcheck.sh"]
|
|
interval: 30s
|
|
timeout: 5s
|
|
start_period: 10s
|
|
retries: 3
|
|
|
|
# ------------------------------------------
|
|
# Scheduler - Runs cleanup for expired shares
|
|
# ------------------------------------------
|
|
scheduler:
|
|
image: gitea.nonameweb.ch/nonameweb/sealshare:latest
|
|
restart: unless-stopped
|
|
entrypoint: ["php", "artisan", "schedule:work"]
|
|
volumes:
|
|
- sealshare_storage:/app/storage/app
|
|
- sealshare_database:/app/database
|
|
environment:
|
|
# APP_KEY: # Same key as the app service above (auto-generated if not set)
|
|
APP_URL: # Same URL as the app service above
|
|
depends_on:
|
|
app:
|
|
condition: service_healthy
|
|
|
|
volumes:
|
|
sealshare_storage: # Persistent: uploaded & encrypted files
|
|
sealshare_database: # Persistent: SQLite database
|
|
caddy_data: # Persistent: TLS certificates
|
|
caddy_config: # Persistent: Caddy configuration
|