cb47cce074
- 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.
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.
|
|
|