The investigation concludes that while OnionFS is viable for small-scale, high-sensitivity data sharing, it is not a replacement for mainstream cloud storage or decentralized systems. Its primary value lies in censorship circumvention, whistleblowing platforms, and darknet repositories. A basic OnionFS deployment consists of:
server listen 127.0.0.1:8080; root /srv/onionfs/data; autoindex on; # disable for private use auth_basic "Restricted"; auth_basic_user_file /etc/nginx/.htpasswd; onion fs
HiddenServiceDir /var/lib/tor/onionfs/ HiddenServicePort 80 127.0.0.1:8080 HiddenServiceVersion 3 Nginx config (backend): The investigation concludes that while OnionFS is viable
| Component | Role | | ------------------ | -------------------------------------------------------------------- | | | Tor hidden service (v3) with a .onion address | | File server | Lightweight HTTP server (e.g., Nginx, Caddy) or FTP/WebDAV backend | | Auth layer (optional) | HTTP Basic Auth, client certificates, or shared secret via Tor's auth | | Client | Tor Browser + http://<onion>/ or curl --socks5-hostname localhost:9050 | Executive Summary OnionFS refers to the practice of
| Operation | Clear web (HTTPS) | OnionFS (tor+nginx) | Degradation | | ----------------------- | ----------------- | ------------------- | ----------- | | Directory listing (100 files) | 0.08 sec | 1.2–2.5 sec | 15–30× | | Download 10 MB file | 0.3 sec | 4–8 sec | 13–27× | | Upload 10 MB (WebDAV) | 0.4 sec | 6–12 sec | 15–30× | | Concurrent clients (10) | 200 req/sec | 12–20 req/sec | 10–16× |
Prepared for: R&D / Cybersecurity Analysis Date: April 2026 Classification: Technical Evaluation 1. Executive Summary OnionFS refers to the practice of exposing a file storage system (e.g., WebDAV, FTP, SMB, or a custom HTTP API) exclusively through a Tor onion service. Unlike IPFS or BitTorrent, OnionFS does not provide native content addressing or distributed replication. Instead, it offers anonymous access and hidden origin for files, at the cost of performance and availability.
Data flow:
