nginx: 서브패스(/admin)에서 SPA 서빙 (alias + fallback)

SPA를 /admin/처럼 서브패스에 배포하면, 새로고침/직접 접근 시 404가 나기 쉽습니다. (/admin/users 같은 라우트)

기본 패턴 (alias + try_files)

예시 경로: SPA 빌드 산출물이 /var/www/admin/에 있다고 가정합니다.

location ^~ /admin/ {
  alias /var/www/admin/;
  try_files $uri $uri/ /admin/index.html;
}

자주 막히는 포인트

• alias는 root와 경로 매핑 규칙이 달라 헷갈리기 쉽습니다.
• fallback URI는 /admin/index.html처럼 “브라우저 기준 경로”로 두는 편이 안전합니다.

같이 쓰면 좋은 설정

• 해시 자산 캐시: nginx: 해시 기반 정적 자산에 immutable 캐시 적용
• SPA 기본 개념: SPA 라우팅 fallback