도메인 & 라우팅
PCS의 모든 앱은 자동으로 공개 URL을 받습니다. 이 페이지에서는 도메인 구조, 요청 라우팅 방식, 가능한 옵션을 설명합니다.
도메인 형태
모든 Yundera 도메인은 다음 패턴을 따릅니다:
{서브도메인}.{사용자-도메인}.{서버-도메인}
예시: immich.john.nsl.sh
immich— 앱 이름 (서브도메인)john— 사용자 네임스페이스nsl.sh— 서버 도메인
요청 라우팅 방식
- 방문자가 브라우저에서
immich.john.nsl.sh를 엽니다. - DNS가 도메인을 NSL.SH 네트워크로 해석합니다.
- mesh-router 백엔드가 암호화 서명(libp2p)으로 요청을 검증합니다.
- 요청이 PCS에 도달하면, 로컬 mesh-router가 서브도메인을 올바른 Docker 컨테이너로 해석합니다.
- 컨테이너가 응답하고 페이지가 로드됩니다.
PCS에 접속하는 세 가지 방법
PCS에는 다양한 주소 유형으로 접속할 수 있으며, 각각 다른 특성을 가집니다:
| 주소 유형 | 형태 | 예시 | 작동 방식 |
|---|---|---|---|
| sslip.io (직접) | {대시-ip}.sslip.io | 203-0-113-42.sslip.io | DNS가 호스트명 자체에서 IP를 해석. TLS 세션 하나, PCS에서 종료. |
| nsl.sh (관리형) | {앱}.{사용자}.nsl.sh | immich.john.nsl.sh | NSL.SH가 DNS와 라우팅 처리. 전용 인증서로 연결 보안. |
| 커스텀 도메인 | 자체 도메인 | photos.example.com | 도메인을 PCS로 포인팅 (Cloudflare 또는 직접 A 레코드). |
각 모드의 프라이버시 영향은 TLS & 프라이버시를 참조하세요.
전송 계층: 직접 vs 터널
앱으로의 실제 트래픽(데이터 플레인)은 네트워크에 따라 두 가지 경로 중 하나를 취합니다:
- 직접 경로 — PCS가 인터넷에서 직접 접근 가능할 때(공개 IP, 포트 개방), 트래픽이 기기로 직접 전달됩니다. NSL.SH 게이트웨이는 경로에 없습니다.
- WireGuard 터널 — PCS가 CGNAT 뒤에 있거나 제한적인 네트워크에 있을 때(공개 IP 없음, 포트 포워딩 없음), 트래픽이 NSL.SH 인프라를 통해 암호화된 WireGuard 터널을 통과합니다.
두 경우 모두, 저장된 데이터는 항상 내 맨신에 남습니다.
커스텀 도메인
자신의 도메인을 PCS로 포인팅할 수 있습니다. 단계별 안내는 커스텀 도메인 가이드를 참조하세요.