Update server infrastructure docs

This commit is contained in:
Codex
2026-05-30 21:19:05 +09:00
parent b382d99800
commit 5b89b1046f
6 changed files with 108 additions and 4 deletions

View File

@@ -1,6 +1,6 @@
# 서비스 전체 목록
> 기준일: 2026-05-23 | 호스트: srv (Rocky Linux 8.10)
> 기준일: 2026-05-30 | 호스트: srv (Rocky Linux 8.10)
## 서비스 맵
@@ -25,6 +25,9 @@
| **ASR Whisper** | `asr.du5t.xyz` | `10.89.0.2:8000` | — | *(미적용)* | [gm/asr](https://git.du5t.xyz/gm/asr) |
| **Wiki.js** | `wiki.du5t.xyz` | `10.89.0.45:3000` | 2.5.314 | Authentik OIDC | [gm/wikijs](https://git.du5t.xyz/gm/wikijs) |
| **Reservation App** | `reservation.du5t.xyz` | `10.89.0.22:3000` | — | JWT 자체 인증 | [gm/reservation](https://git.du5t.xyz/gm/reservation) |
| **Telegram Reminder Bot** | `reminder.du5t.xyz/setup` | `10.89.0.23:8088` | 0.1.2 | Authentik OIDC + Telegram 관리자 매핑 | [gm/telegram-reminder-bot](https://git.du5t.xyz/gm/telegram-reminder-bot) |
| **Telegram Calendar Bot** | *(Telegram Bot)* | `10.89.0.99` | — | Telegram + Nextcloud CalDAV 계정 | [gm/telegram-calendar-bot](https://git.du5t.xyz/gm/telegram-calendar-bot) |
| **Postfix Relay** | *(SMTP 내부)* | `10.89.0.50` | latest | 내부 릴레이 | — |
| **MariaDB** | *(내부 전용)* | `0.0.0.0:3306` | 12.2.1 | 내부망 전용 | — |
| **PostgreSQL** | *(내부 전용)* | `10.89.0.40:5432` | 16 | 내부망 전용 | [gm/postgres](https://git.du5t.xyz/gm/postgres) |
@@ -35,6 +38,7 @@
- Gitea — `gitea admin auth add-oauth`
- Nextcloud — `user_oidc`
- Open WebUI — 컨테이너 환경변수
- Telegram Reminder Bot — `/setup` 관리자 UI 및 Telegram 관리자 계정 연결
### Authentik Proxy Provider (Embedded Outpost 경유)
NPM이 트래픽을 `10.89.0.20:9000`으로 전달, Outpost가 인증 후 실제 서비스로 포워딩.
@@ -47,15 +51,33 @@ NPM이 트래픽을 `10.89.0.20:9000`으로 전달, Outpost가 인증 후 실제
- ASR API (`asr.du5t.xyz`) — 내부 사용 전제
### 자체 인증
- Jellyfin, SFTPGo, JupyterHub, Reservation App, NPM
- Jellyfin, SFTPGo, JupyterHub, Reservation App, NPM, Telegram Calendar Bot
## 기반 인프라 서비스
| 서비스 | 역할 | 내부 주소 |
|---|---|---|
| `postgres-main` | Authentik, Nextcloud, Wiki.js DB | `10.89.0.40:5432` |
| `postgres-main` | Authentik, Nextcloud, Wiki.js, Telegram Reminder Bot DB | `10.89.0.40:5432` |
| `authentik-redis` | Authentik 캐시/큐 | `10.89.0.41:6379` |
| `redis-nextcloud` | Nextcloud 캐시/세션 | `10.89.0.44:6379` |
| `postfix` | 내부 SMTP 릴레이 | `10.89.0.50` |
| `MariaDB` | NPM DB | `host:3306` |
| `proxy.network` | 서비스 간 통신 브리지 | `10.89.0.0/24` |
| `fail2ban` | SSH/서비스 브루트포스 차단 | host |
## Telegram Reminder Bot 운영 특이사항
- 컨테이너: `telegram-reminder-bot`
- systemd unit: `telegram-reminder-bot.service`
- 데이터베이스: `postgres-main``telegram_reminder` DB 사용
- 런타임 설정: `/podman/data/telegram-reminder-bot/data/runtime.env`
- 관리자 UI: `https://reminder.du5t.xyz/setup`
- 웹 UI 기능:
- 런타임 상태/재시작
- 대상 등록
- 리마인더 생성
- 리마인더 일시중지/재개/보관
- Tabulator 기반 통계 조회
- 접근 제어:
- `/setup`은 Authentik OIDC로 보호된다.
- 대상/리마인더 조작은 Authentik `sub`가 Telegram 로그인으로 검증된 `admin_identities`와 매핑된 경우에만 허용된다.