112 lines
2.3 KiB
Markdown
112 lines
2.3 KiB
Markdown
|
# 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)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd scripts/cloudflare-tunnels
|
||
|
|
./scripts/verify-prerequisites.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
### 2. Create Tunnels in Cloudflare (2 minutes)
|
||
|
|
|
||
|
|
1. Go to: https://one.dash.cloudflare.com
|
||
|
|
2. Zero Trust → Networks → Tunnels → Create tunnel
|
||
|
|
3. Create three tunnels:
|
||
|
|
- `tunnel-ml110`
|
||
|
|
- `tunnel-r630-01`
|
||
|
|
- `tunnel-r630-02`
|
||
|
|
4. Copy tunnel tokens/IDs
|
||
|
|
|
||
|
|
### 3. Run Setup Script (1 minute)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
./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)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# From VMID 102
|
||
|
|
systemctl start cloudflared-ml110 cloudflared-r630-01 cloudflared-r630-02
|
||
|
|
systemctl enable cloudflared-*
|
||
|
|
```
|
||
|
|
|
||
|
|
### 6. Verify (30 seconds)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
./scripts/check-tunnel-health.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
## Test Access
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 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
|
||
|
|
|
||
|
|
1. **Configure Cloudflare Access** (see `docs/CLOUDFLARE_ACCESS_SETUP.md`)
|
||
|
|
2. **Start Monitoring** (see `docs/MONITORING_GUIDE.md`)
|
||
|
|
3. **Set Up Alerting** (edit `monitoring/alerting.conf`)
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
If something doesn't work:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Check service status
|
||
|
|
systemctl status cloudflared-*
|
||
|
|
|
||
|
|
# Check logs
|
||
|
|
journalctl -u cloudflared-* -f
|
||
|
|
|
||
|
|
# Run health check
|
||
|
|
./scripts/check-tunnel-health.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
See [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) for detailed help.
|
||
|
|
|
||
|
|
## Full Deployment
|
||
|
|
|
||
|
|
For complete setup with all features:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
./scripts/deploy-all.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
Or follow [DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md) step by step.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**That's it!** Your Proxmox hosts are now accessible via Cloudflare Tunnel.
|
||
|
|
|