kelin/EZ-Homelab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation files with recent tweaks

Browse Source
This commit is contained in:
Kelin
2026-02-08 18:42:16 -05:00
parent 0de82e55b6
commit 30143d5f75
5 changed files with 94 additions and 1659 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
docs/multi-server-deployment.md
View File

@@ -14,39 +14,43 @@ This guide explains the **current multi-server architecture** where:
```
┌─────────────────────────────────────────────────────────────────┐
│ 🌐 PUBLIC INTERNET │
│ 🌐 PUBLIC INTERNET │
│ HTTPS Traffic (Ports 80/443 forwarded from router) │
└─────────────────────┬───────────────────────────────────────────┘
│
▼ HTTPS (SSL/TLS)
┌─────────────────────────────────────────────────────────────────┐
│ CORE SERVER │
│ ┌────────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
│ │ DuckDNS │ │ Traefik │ │ Authelia │ │ Core Services │ │
│ │ (SSL DNS) │ │ (multi- │ │ (SSO) │ │ (local) │ │
│ │ │ │ provider)│ │ │ │ │ │
│ └────────────┘ └────┬─────┘ └──────────┘ └──────────────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ │ Routes: │ │ │
│ │ • Local │ (labels) │ │
│ │ • Remote │ (YAML files)│ │
└──────────┼──────────────┼──────────────┼────────────────────────┘
│ │ │
│ HTTP (internal network) │
│ No SSL/TLS encryption │
▼ ▼ ▼
┌─────────────────────────────────────────┐
│ ADDITIONAL SERVER (e.g., Pi) │
│ ┌──────────┐ ┌───────┐ ┌──────────┐ │
│ │ Sablier │ │ Media │ │ Exposed │ │
│ │ (lazy │ │ Apps │ │ Ports │ │
│ │ loading) │ │ │ │ 5001, │ │
│ └──────────┘ └───────┘ │ 8085... │ │
└────────────────────────────┼──────────┘
│
Direct port access
(no local reverse proxy)
└─────────────────────────────┬────┬──────────────────────────────┘
│ |
HTTP(S) ▼ HTTPS
| |
┌─────────────────────────────┼────┼──────────────────────────────┐
│ CORE SERVER │ | │
| ▼ |
│ ┌───────────────┐ ┌──────────┐ ┌────────────────┐ │
│ │ Core Services │ │ Traefik │ │ Local Services │ │
│ │ Authelia │ ---- │ │ ---- │ │ │
│ │ DuckDNS │ │ │ │ │ │
│ └───────────────┘ └────┬─────┘ └────────────────┘ │
│ │ │
│ ┌──────────────┼────────────┐ │
│ │ Routes: │ │
│ │ • Local (labels) │ │
│ │ • Remote (YAML files) │ │
| | | |
| └──────────────┬────────────┘ |
| | |
└───────────────────────────────┼─────────────────────────────────┘
│
HTTP (internal network) │
No SSL/TLS encryption │
▼
┌───────────────────────────────┼─────────────────────────────────┐
│ ADDITIONAL SERVER │
| |
│ ┌───────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ Sablier │ │ Your Apps │ │ Dockge | |
│ │ lazy loading │ │ expose ports │ │ | |
│ │ │ │ │ │ | |
│ └───────────────┘ └────────────────┘ └────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
### Traffic Flow Summary
@@ -119,12 +123,3 @@ When you deploy an additional server:
- **Centralized Access**: All services accessed through one domain
- **Unified SSO**: Authelia on core server protects all services
- **Local Lazy Loading**: Sablier manages containers on each server independently
## Performance Considerations
- **Latency**: Direct routing (core → service) minimizes hops
- **Resource Usage**: Additional servers run only Sablier (~50MB) - no Traefik needed
- **Scalability**: Can add unlimited additional servers without complexity
- **Network**: Internal 1Gbps+ recommended between servers
- **Deployment Speed**: Additional servers deploy in ~2 minutes (vs 5-10 with local Traefik)