아키텍처 개요¶
아키텍처 도식 모음에서 전체 서비스·인증·네트워크·백업·운영 경로를 탐색할 수 있습니다. 왼쪽 아키텍처 도식 메뉴에서 각 HTML 지도로 바로 이동할 수도 있습니다.
기술 스택¶
- NixOS + Flakes + flake-parts — 선언적 시스템 구성
- sops-nix (age 암호화) — 시크릿 관리
- disko — 선언적 디스크 관리
- Terraform/Terragrunt — 외부 리소스 관리 (Cloudflare, GitHub, healthchecks.io, Authentik, Headscale)
- invoke (
tasks.py) — 관리 작업 자동화
호스트별 서비스 배치¶
graph LR
eta["<b>eta</b><br/>게이트웨이 · 인증<br/>nginx · Authentik · Headscale · gitea-mq"]
psi["<b>psi</b><br/>GPU · CI/CD<br/>Nixbot · niks3 · BioDB · 로컬 Borg"]
rho["<b>rho</b><br/>DB · 모니터링<br/>PostgreSQL primary · Grafana · Loki · 로컬 Borg"]
tau["<b>tau</b><br/>앱 · DB replica<br/>Nextcloud · n8n · 로컬 Borg"]
r2["Cloudflare R2<br/>eta Restic 저장소"]
cache["Cloudflare R2<br/>Nix 캐시"]
eta -- "인증서 동기화" --> psi & rho & tau
rho -- "WAL 스트리밍" --> tau
eta -- "PostgreSQL·Vaultwarden Restic" --> r2
cache -- "캐시 읽기" --> psi & rho & tau & eta
| 호스트 | 위치 | 주요 서비스 |
|---|---|---|
| eta | Vultr VPS | nginx 리버스 프록시, Authentik SSO, Headscale VPN, gitea-mq, Vaultwarden, Gatus, Upterm relay, ACME 인증서 |
| psi | KREN 베어메탈 | Nixbot+PostgreSQL+nginx/TLS, niks3 control plane, Apptainer, db-sync, 로컬 Borg; workspace 16TB RAID0, data 30TB usable RAID1 |
| rho | 랩 내부 베어메탈 | PostgreSQL primary, Grafana, Prometheus, Loki, Vector, 로컬 Borg; /srv 2TB usable RAID1 |
| tau | 랩 내부 베어메탈 | Nextcloud, Collabora, n8n, Vaultwarden tailnet proxy, PostgreSQL replica, 로컬 Borg; /srv 2TB usable RAID1 |
각 bare-metal 호스트의 Borg는 해당 시스템 SSD와 SQL 덤프를 같은 호스트의 HDD에 저장합니다. 홈·workspace·HDD data·live PGDATA는 제외되며 RAID1이나 DB replica가 독립적인 백업을 대신하지 않습니다. eta는 R2 Restic으로 DB·Vaultwarden을 보호합니다. 상세 범위는 백업을 따릅니다.
호스트별 IP, 네트워크 위치, 방화벽 정책은 네트워크를 참조하세요.
인증 흐름¶
flowchart LR
user["사용자"] --> vpn["Tailscale VPN · ACL"]
vpn --> nginx["내부 nginx"]
nginx --> auth["Authentik Forward Auth<br/>n8n · Grafana 등"]
auth --> svc["허용된 upstream"]
user --> oidc["앱의 OIDC 로그인<br/>Nextcloud · Vaultwarden"]
oidc -. "인증" .-> authentik["Authentik"]
Terraform은 같은 사용자 inventory에서 Authentik 그룹과 Headscale ACL을 구성합니다. Headscale은 VPN 제어 평면이며 사용자 트래픽을 eta로 중계하는 프록시가 아닙니다. Nextcloud는 공개 edge 또는 tailnet으로 접속하고 앱 OIDC로 로그인합니다. 다른 서비스는 네트워크 제한과 서비스별 인증을 함께 적용합니다. 상세는 인증과 네트워크 — ACL을 참조하세요.
리포지토리 구조¶
flake.nix # 진입점
configurations.nix # 호스트 목록
hosts/ # 호스트별 설정 (.nix) + 시크릿 (.yaml)
modules/ # 서비스 모듈
├── hosts.nix # 호스트 정의 (IP, MAC, 태그)
├── network.nix # 네트워크 설정
├── users/ # 사용자 관리
├── <service>/ # 서비스별 모듈 + secrets.yaml
└── ...
terraform/ # Cloudflare, GitHub, Authentik, Headscale, healthchecks.io 리소스
tasks.py # invoke 관리 명령어