네트워크¶
NixOS host inventory와 WireGuard peer 설정을 평가한 최신 구성은 자동 생성 논리 네트워크 토폴로지에서 확인합니다. 설정 변경 후 inv update-network-topology으로 갱신합니다.
논리 네트워크 개요¶
Underlay host grouping, NAT gateway, wg-admin peer 관계와 평가된 주소는 자동 생성 논리 네트워크 토폴로지를 source of truth로 사용합니다. 이 문서는 각 레이어의 운영 정책을 설명합니다.
| 레이어 | 기술 | 용도 | 대역 |
|---|---|---|---|
| Underlay | VPS, KREN, 연구실 NAT | 호스트의 물리 IPv4 연결 | 네트워크별 상이 |
| WireGuard | wg-admin |
인프라 관리 (SSH, DB, 모니터링) | 10.100.0.0/24 |
| Headscale | Tailscale 호환 | 사용자 서비스 접근 | 100.64.0.0/10 |
WireGuard (wg-admin)¶
인프라 관리용 메시 VPN입니다. SSH, DB, 모니터링 트래픽이 이 네트워크를 통합니다.
- 인터페이스:
wg-admin - 포트:
51820/UDP - 대역:
10.100.0.0/24 - PersistentKeepalive: 25초
rho와 tau는 공개 WireGuard endpoint가 없으며, 공인 eta 또는 KREN NAT로 공개된 psi endpoint에 먼저 연결합니다.
Headscale (사용자 VPN)¶
사용자가 서비스에 접근하기 위한 Tailscale 호환 VPN입니다.
- 제어 서버:
https://hs.sjanglab.org - IPv4:
100.64.0.0/10 - Magic DNS:
sbee.lab - Split DNS:
sjanglab.org쿼리를 내부 DNS로 라우팅
ACL 그룹¶
ACL 그룹은 sjanglab-admins 하나이며, 관리자 계정 목록은 terraform/headscale/main.tf에 고정합니다. 나머지 사용자는 autogroup:member로 다룹니다. Headscale 로그인 자체가 Authentik 그룹 인가(allowed_groups)를 통과해야 하므로, 로그인한 member는 이미 승인된 사용자입니다.
| 대상 | 접근 |
|---|---|
sjanglab-admins |
tag:ai, tag:apps, tag:monitoring, nix-grpc-daemon |
autogroup:member |
tag:apps, 서버 SSH |
ACL 태그 소유권¶
| 태그 | 소유 그룹 | 설명 |
|---|---|---|
tag:server |
sjanglab-admins |
서버 노드 |
tag:ai |
sjanglab-admins |
AI 서비스용 정책 태그; 현재 서비스 endpoint 없음 |
tag:apps |
sjanglab-admins |
앱 서비스 (Nextcloud, n8n, Vaultwarden) |
tag:monitoring |
sjanglab-admins |
모니터링 (Grafana) |
ACL 정책 관리¶
Headscale ACL policy는 terraform/headscale의 headscale_policy.tailnet 리소스가 관리합니다. 사용자별 membership은 ACL에 없으므로, 사용자 추가·변경은 Authentik 그룹만으로 끝납니다. Headscale user는 Terraform에서 만들지 않고, Authentik 그룹 인가를 통과한 첫 OIDC 로그인 때 생성됩니다.
인증이 없는 서비스를 tailnet에 노출하는 경우, ACL이 아니라 Authentik forward auth로 보호합니다.
Headscale은 policy.mode = "database"로 동작합니다. ACL 변경 후 즉시 반영하려면 terraform/headscale에서 terragrunt apply를 실행합니다.
방화벽 정책¶
공통¶
wg-admin인터페이스: 신뢰 (모든 포트 허용)- WireGuard:
51820/UDP
호스트별¶
| 호스트 | 외부 개방 포트 | wg-admin 개방 포트 |
|---|---|---|
| eta | 80, 443, 10022 (공개키 SSH), 2323 (Upterm relay) | 10022, 8000 (Vaultwarden), 8081 (Gatus) |
| psi | — | 80/443 (Nixbot upstream), 10022, 5751 (niks3 API), 5432 (Nixbot/niks3 PostgreSQL) |
| rho | — | 10022, 443 (인증 nginx; Grafana public edge의 upstream), 5432 (PostgreSQL), 3100/9090 (ingest만) |
| tau | — | 10022, 5678 (n8n 웹훅) |
ACME 인증서¶
TLS 인증서는 eta에서 발급합니다. 공개 nginx vhost는 HTTP-01을 사용하고, 공개 HTTP endpoint가 없는 비공개 certificate-only 항목은 Cloudflare DNS-01을 사용합니다. DNS-01 전파 확인은 시스템 split DNS 대신 8.8.8.8:53을 사용합니다. Nixbot(nixbot.sjanglab.org)도 eta 인증서를 psi의 wg-admin upstream에 동기화하며 psi에서는 별도 발급하지 않습니다. rho, tau, psi의 인증서는 acme-sync 수신 계정을 통해 rsync로 동기화됩니다.