How cloudflare/utahfs works
UtahFS presents encrypted cloud-backed files as a local drive: a user mounts it, interacts with files through FUSE, and the client persists block data through configurable storage layers. The README also describes archive protection, a LAN coordination/cache server, a web UI, and optional ORAM. The graph shows the sampled client setup and storage construction; source excerpts do not establish every internal call between filesystem layers or the server and remote client, so those links are omitted or marked unverified.
Main entry points: config.go Storage configuration · utahfs-client/main.go FUSE client · utahfs-web/main.go Web UI · blockfs.go Block filesystem
Components 20
User interfaces
- FUSE client
cmd/utahfs-client/main.go - Web UI
cmd/utahfs-web/main.go - HTTP filesystem adapter
cmd/utahfs-web/filesystem.go
Filesystem runtime
- Archive mode
archive.go - Filesystem operations
filesystem.go - File node manager
node_manager.go - Block filesystem
blockfs.go
Storage pipeline
- Storage configuration
cmd/internal/config/config.go - Application storage
persistent/app_storage.go - Encryption
persistent/encryption.go - Integrity protection
persistent/integrity.go - Oblivious access
persistent/oblivious.go - Write-ahead log
persistent/local_wal.go - Storage caches
persistent
Storage backends
- Object storage providers
persistent - Local disk storage
persistent/disk.go - Remote storage client
persistent/remote.go
Coordination services
- LAN coordination server
cmd/utahfs-server/main.go
Other components
- Drive user
- Cloud object storage
Connections 22
- Drive user → FUSE client: mounts drive
README.md - FUSE client → Storage configuration: loads configuration
cmd/utahfs-client/main.go - FUSE client → Filesystem operations: selects filesystem
cmd/utahfs-client/main.go - FUSE client → Archive mode: selects archive mode
cmd/utahfs-client/main.go - Web UI → Storage configuration: loads configuration
cmd/utahfs-web/main.go - Web UI → Archive mode: creates archive view
cmd/utahfs-web/main.go - Web UI → HTTP filesystem adapter: serves through
cmd/utahfs-web/main.go - HTTP filesystem adapter → Filesystem operations: exposes over HTTP
- File node manager → Block filesystem: reads and writes blocks
node_manager.go - Storage configuration → Object storage providers: selects provider
cmd/internal/config/config.go - Storage configuration → Write-ahead log: configures local WAL
cmd/internal/config/config.go - Storage configuration → Storage caches: configures caching
cmd/internal/config/config.go - Storage configuration → Integrity protection: wraps with integrity
cmd/internal/config/config.go - Storage configuration → Encryption: wraps with encryption
cmd/internal/config/config.go - Storage configuration → Oblivious access: optionally enables ORAM
cmd/internal/config/config.go - Storage configuration → Application storage: creates application storage
cmd/internal/config/config.go - Storage configuration → Block filesystem: creates block filesystem
cmd/internal/config/config.go - Block filesystem → Application storage: reads and writes blocks
blockfs.go - Object storage providers → Cloud object storage: stores encrypted objects
README.md - Storage configuration → Local disk storage: can select local disk
cmd/internal/config/config.go - Storage configuration → Remote storage client: can use remote server
- LAN coordination server → Remote storage client: coordinates clients