Securely Exposing Your LND Node Using Tor, Socat, and a VPS
- Securely Exposing Your LND Node Using Tor, Socat, and a VPS
- Architecture Overview
- Why This Architecture?
- Implementation Overview
- Deployment Guide
- Configuration Options
- Testing
- LND Configuration
- Health Checks & Autoheal
- Advantages of the Tor-Based Architecture
- Disadvantages Compared to Cloudflare Tunnel
- Final Evaluation
- References
Securely Exposing Your LND Node Using Tor, Socat, and a VPS
A Cloudflare-Free Clearnet Proxy Architecture
Introduction & Motivation
Running a Lightning Network Daemon (LND) node with a publicly reachable TCP address is essential for channel opens, forwarding payments, and maintaining strong network connectivity. Many node operators expose LND through tunneling services such as Cloudflare Tunnel.
However, reliance on a proprietary centralized service introduces a structural single point of failure. The recent global Cloudflare outage demonstrated that even the most robust commercial infrastructures can go dark—taking dependent LND nodes offline.
To eliminate this dependency, this article presents a fully open, privacy-preserving alternative using:
- A minimal VPS exposing a public TCP listener
- Tor as an anonymizing transport
- socat to forward clearnet connections through Tor into your LND onion service
- Health checks + autoheal to keep the tunnel alive
This design preserves all the security benefits of outbound-only connectivity while removing Cloudflare from the trust chain.
Original Cloudflare-based article:
https://habla.news/a/naddr1qvzqqqr4gupzq0l6cwnvsk0242xdmkevwqp2dcgtx0h7hyksykc5att03gkk2ejhqqxnzde58yun2wpjxyerwd33tr0ph4
Architecture Overview
Clearnet → VPS:9735 → socat → Tor SOCKS Proxy → Onion:9735 → LND Node
The system uses three containers:
- tor – Runs Tor and exposes a SOCKS5 proxy
- socat – Listens on clearnet and forwards streams to the onion service
- autoheal – Restarts containers when health checks fail
Result: a public TCP endpoint with zero exposure of your LND node’s real IP.
Why This Architecture?
Key Properties
| Feature | Tor + socat + VPS | Cloudflare Tunnel |
|---|---|---|
| Keeps LND host inbound-closed | ✅ | ✅ |
| VPS cannot discover LND IP | ✅ | ❌ |
| No proprietary dependency | ✅ | ❌ |
| Fully decentralized | ✅ | ❌ |
| Built-in access control | ❌ | ✅ |
| Reliant on a third party | ❌ | ✅ |
| Resists Cloudflare outages | ✅ | ❌ |
| Tor-level privacy | ✅ | ❌ |
Summary
- Tor-based: privacy, independence, censorship-resistance
- Cloudflare-based: convenience, integrated access control, centralized trust
The Tor solution sacrifices some convenience in exchange for decentralization and resilience.
Implementation Overview
Components
1. Tor Container
- Boots Tor
- Provides SOCKS5 on port
9050 - Considered healthy after bootstrap reaches 100%
2. Socat Container
- Waits for Tor readiness
- Listens on clearnet port (default: 9735)
- Forwards streams through the Tor SOCKS proxy
3. Autoheal
- Monitors health status
- Restarts unhealthy containers automatically
- Ensures continuous operation
Deployment Guide
1. Start the Containers
cd /path/to/tor-tunnel-lnd
docker compose build
docker compose up -d
2. Check Runtime Status
docker compose ps
docker logs -f lnd-tor
docker logs -f lnd-socat
docker logs -f lnd-autoheal
3. Check Container Health
docker inspect --format='{{.State.Health.Status}}' lnd-tor
docker inspect --format='{{.State.Health.Status}}' lnd-socat
4. Configure Firewall
sudo ufw allow 9735/tcp
sudo ufw reload
Configuration Options
Environment Variables for socat
| Variable | Description | Default |
|---|---|---|
ONION_HOST |
Onion address of LND | b3pje4v…onion |
ONION_PORT |
LND port | 9735 |
TOR_HOST |
Tor container hostname | tor |
TOR_PORT |
SOCKS port | 9050 |
TIMEOUT |
Seconds to wait for Tor readiness | 180 |
Changing the External Port
ports:
- "19735:9735"
Testing
From an external host
nc -v <VPS_IP> 9735
From another LND node
lncli connect <pubkey>@<VPS_IP>:9735
From inside the containers
docker exec lnd-socat nc -z tor 9050
docker exec lnd-socat netstat -tlnp | grep 9735
LND Configuration
Advertise both the clearnet and onion endpoints:
externalip=<VPS_IP>:9735
externalip=b3pje4vztlrbilix7wp6fisyrdflbrx232v75xl4eyx4hjn2756avkyd.onion:9735
Restart LND and check:
lncli getinfo
Expected:
03abc...@<VPS_IP>:973503abc...@b3pje4vztlr...onion:9735
Health Checks & Autoheal
Tor Health Check
Verifies:
- Tor bootstrap completion
- Tor exit IP is recognized as a Tor exit
- SOCKS proxy remains reachable
Interval: 30s
Timeout: 30s
Start period: 60s
Socat Health Check
Verifies:
- Socat is listening
- Forwarding works end-to-end
- LND responds with a Lightning handshake
This ensures the tunnel isn’t just running but fully functional.
Autoheal Behavior
- Monitors container health
- Restarts unhealthy containers
- Logs all restart actions
Advantages of the Tor-Based Architecture
✔ Fully Open-Source
No central provider; no API tokens; no dashboards.
✔ Strong Privacy Guarantees
The VPS cannot identify your LND node or its network location.
✔ Resilient to Cloudflare and CDN Outages
No reliance on commercial infrastructure.
✔ Outbound-Only Connectivity
The LND node exposes zero inbound ports.
✔ Minimal Attack Surface
Only the VPS port is exposed; LND remains unreachable.
Disadvantages Compared to Cloudflare Tunnel
❌ No Integrated Access Control
Cloudflare’s Service Tokens provide elegant authorization.
Tor + socat relies on LND’s inherent authentication, which is strong but not policy-based.
❌ Higher Latency
Tor paths increase latency slightly, although this is irrelevant for Lightning gossip and peer maintenance.
❌ More Operational Complexity
Requires Docker, health checks, and Tor maintenance.
Cloudflare’s solution is plug-and-play.
❌ VPS Sees Connection Metadata
It cannot identify your LND, but it sees:
- number of incoming connections
- timing patterns
- clearnet origin IPs
Mitigations require additional layers if desired.
Final Evaluation
Both the Cloudflare and the Tor-based approaches achieve the same goal: providing a stable clearnet endpoint for your Lightning node without exposing the node itself to the internet.
The Cloudflare solution favors convenience, centralized control, and access management.
The Tor solution favors privacy, sovereignty, decentralization, and resilience to third-party outages.
For operators who value independence and censorship resistance, the Tor + socat architecture is a strong upgrade, fully eliminating proprietary dependencies while maintaining robust Lightning connectivity.
References
-
Original Cloudflare-based article (Habla.news):
https://habla.news/a/naddr1qvzqqqr4gupzq0l6cwnvsk0242xdmkevwqp2dcgtx0h7hyksykc5att03gkk2ejhqqxnzde58yun2wpjxyerwd33tr0ph4 -
Tor Project – Tor Documentation
https://community.torproject.org/ -
Socat manual (Linux man pages)
https://linux.die.net/man/1/socat -
Lightning Network Specification
https://github.com/lightning/bolts -
LND Documentation
https://docs.lightning.engineering/ -
Autoheal Docker Project
https://github.com/willfarrell/docker-autoheal
Write a comment