Seoul

nginx 설정을 기반으로 서비스 바로가기 목록을 구성하는 PHP 대시보드입니다.

프로젝트 성격

Seoul은 서버에 흩어진 웹 서비스들을 한 화면에서 찾기 위한 시작 페이지입니다. nginx 설정 파일을 읽어 HTTPS server block과 document root를 수집하고, 각 root에서 얕은 PHP entry를 찾아 링크 목록으로 렌더링합니다.

주요 기능

nginx 설정 파일 순회
HTTPS server block의 host 추출
document root에서 index.php, monitor.php 같은 entry 탐색
자기 자신, 내부 host, IP literal, 변수, 정규식 형태 host 제외
서비스 이름, host, entry path 표시
PWA manifest와 service worker 제공

주요 진입점

index.php: 바로가기 대시보드
asset-version.php: 대시보드 파일 묶음의 현재 hash를 내려주는 JSON 엔드포인트
manifest.webmanifest: PWA manifest
sw.js: service worker

구성

index.php: nginx 설정 파싱과 HTML 렌더링
manifest.webmanifest: PWA 설치 정보
sw.js: 대시보드 캐시와 PWA 동작
assets/: 아이콘과 정적 자산

asset-version.php는 car/를 제외한 Seoul 대시보드의 PHP/JS/CSS/manifest/icon 파일을 읽어 크기, 수정 시각, sha256 hash를 묶은 버전을 만듭니다. assets/asset-reload.js는 열린 화면에서 이 값을 확인하고, 달라지면 Cache Storage를 비운 뒤 현재 화면을 다시 엽니다. 현재 URL의 assetReload 토큰이 최신 파일 묶음 hash와 다르면 첫 진입도 토큰을 붙인 URL로 다시 열어 낡은 JS/CSS가 먼저 실행되는 상황을 줄입니다. 모바일/삼성 브라우저 호환을 위해 화면 복귀, 온라인 복귀, 터치/클릭 복귀 이벤트도 확인하고, Web Storage 실패 시 쿠키 fallback으로 이전 버전을 비교합니다. index.php는 no-store 헤더를 내려 문서 자체가 오래 남지 않게 하고, service worker는 기존 정적 캐시를 정리한 뒤 요청을 네트워크로 넘깁니다.

입력 소스

/etc/nginx/nginx.conf
/etc/nginx/sites-enabled
/etc/nginx/conf.d
각 server block의 document root

처리 흐름

nginx 설정 경로를 순회합니다.
server_name과 document root를 수집합니다.
document root에서 얕은 PHP entry를 찾습니다.
제외 규칙을 통과한 항목만 링크 목록으로 렌더링합니다.

제외/필터 기준

자기 자신 또는 중복 host
내부 전용 host
IP literal
nginx 변수나 정규식 형태 host
외부 노출이 부적절한 entry

참고

car/ 디렉터리는 별도 저장소로 관리하므로 이 저장소에서는 제외합니다.

보안

nginx 설정 읽기는 표시용으로만 사용합니다.
생성된 host와 link 값은 렌더링 전에 escape합니다.
내부 전용 host와 IP literal은 목록에서 제외해 외부 노출 가능성을 낮춥니다.

운영 체크포인트

nginx 설정 변경 후 목록에 의도한 서비스만 노출되는지 확인합니다.
민감하거나 내부 전용 host가 목록에 나오지 않도록 제외 규칙을 유지합니다.
Car 서비스 명세는 별도 문서와 저장소에서 관리합니다.