- Organized 252 files across project - Root directory: 187 → 2 files (98.9% reduction) - Moved configuration guides to docs/04-configuration/ - Moved troubleshooting guides to docs/09-troubleshooting/ - Moved quick start guides to docs/01-getting-started/ - Moved reports to reports/ directory - Archived temporary files - Generated comprehensive reports and documentation - Created maintenance scripts and guides All files organized according to established standards.
2.3 KiB
2.3 KiB
Quick Start Guide
Fastest path to get Cloudflare Tunnels running for your Proxmox hosts.
Prerequisites
✅ Cloudflare account with Zero Trust enabled
✅ Domain d-bis.org managed by Cloudflare
✅ VMID 102 exists and is running
✅ Network access from VMID 102 to Proxmox hosts
5-Minute Setup
1. Verify Prerequisites (30 seconds)
cd scripts/cloudflare-tunnels
./scripts/verify-prerequisites.sh
2. Create Tunnels in Cloudflare (2 minutes)
- Go to: https://one.dash.cloudflare.com
- Zero Trust → Networks → Tunnels → Create tunnel
- Create three tunnels:
tunnel-ml110tunnel-r630-01tunnel-r630-02
- Copy tunnel tokens/IDs
3. Run Setup Script (1 minute)
./scripts/setup-multi-tunnel.sh
Enter tunnel IDs and credential file paths when prompted.
4. Create DNS Records (1 minute)
In Cloudflare Dashboard → DNS → Records:
| Name | Type | Target | Proxy |
|---|---|---|---|
| ml110-01 | CNAME | <tunnel-id>.cfargotunnel.com |
🟠 ON |
| r630-01 | CNAME | <tunnel-id>.cfargotunnel.com |
🟠 ON |
| r630-02 | CNAME | <tunnel-id>.cfargotunnel.com |
🟠 ON |
5. Start Services (30 seconds)
# From VMID 102
systemctl start cloudflared-ml110 cloudflared-r630-01 cloudflared-r630-02
systemctl enable cloudflared-*
6. Verify (30 seconds)
./scripts/check-tunnel-health.sh
Test Access
# Test DNS
dig ml110-01.d-bis.org
# Test HTTPS
curl -I https://ml110-01.d-bis.org
Should see Cloudflare Access login page or redirect.
Next Steps
- Configure Cloudflare Access (see
docs/CLOUDFLARE_ACCESS_SETUP.md) - Start Monitoring (see
docs/MONITORING_GUIDE.md) - Set Up Alerting (edit
monitoring/alerting.conf)
Troubleshooting
If something doesn't work:
# Check service status
systemctl status cloudflared-*
# Check logs
journalctl -u cloudflared-* -f
# Run health check
./scripts/check-tunnel-health.sh
See TROUBLESHOOTING.md for detailed help.
Full Deployment
For complete setup with all features:
./scripts/deploy-all.sh
Or follow DEPLOYMENT_CHECKLIST.md step by step.
That's it! Your Proxmox hosts are now accessible via Cloudflare Tunnel.