콘텐츠로 이동

네트워크

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로 동기화됩니다.