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 제공

주요 진입점

index.php: 바로가기 대시보드
api.php: seo.chaegeon.com/api.php?action=wake_lan* 호환 WOL 엔드포인트
asset-version.php: 대시보드 파일 묶음의 현재 hash를 내려주는 JSON 엔드포인트
manifest.webmanifest: PWA manifest
sw.js: 과거 등록된 service worker 정리용 파일

구성

index.php: nginx 설정 파싱과 HTML 렌더링
api.php: wake_lan, wake_lan_status 요청만 /var/www/control/public/api.php로 넘기는 호환 파일
manifest.webmanifest: PWA 설치 정보
sw.js: 과거 등록된 service worker 정리용 파일
assets/: 아이콘과 정적 자산

asset-version.php는 car/를 제외한 Seoul 대시보드의 PHP/JS/CSS/manifest/icon 파일을 읽어 전체 버전과 파일별 버전을 만듭니다. index.php는 실제 파일 수정 시각과 hash 기반 v 값을 정적 파일 경로에 붙입니다. assets/asset-reload.js는 전체 버전이나 현재 로드된 script/link의 파일별 v 값이 달라지면 Cache Storage를 비우고 service worker 등록을 해제한 뒤 현재 화면을 다시 엽니다. 모바일/삼성 브라우저 호환을 위해 화면 복귀, 온라인 복귀, 터치/클릭 복귀 이벤트도 확인하고, 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은 목록에서 제외해 외부 노출 가능성을 낮춥니다.
api.php는 Control API 전체가 아니라 WOL 관련 액션만 받습니다. 인증과 WOL 전용 토큰 검증은 Control 쪽에서 처리합니다.

운영 체크포인트

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