스프쌤
스레드

Vercel로 배포한 웹앱이라면

✍ @caffeine__coder⏱ 8분 소요2026-09-18👁
← 목록으로 돌아가기

배포 버튼을 누른 뒤 화면이 잘 뜨는지만 확인하고 끝냈다면, 브라우저 개발자도구를 다시 열어볼 차례다.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: Vercel로 배포한 웹앱의 브라우저 기반 배포 직후 점검

✦ KR 핵심 요약: Vercel 배포 후 개발자도구의 Network·Sources 탭에서 NEXT_PUBLIC_ 변수, secret 노출, API 주소, sourcemap, 인증 없는 엔드포인트, Preview 접근 범위를 확인하고, 주소창에서 HTTPS 전환과 404·관리자 경로까지 점검하는 것이 기본 순서다.

🌐 Global Takeaway: After deploying on Vercel, open DevTools and audit the Network and Sources panels for exposed env vars, sourcemaps, and unauthenticated APIs. Also verify HTTPS redirects, clean 404 pages, and access control on preview and admin routes.

배포 버튼을 누른 뒤 화면이 정상적으로 뜨는지만 확인하고 끝내기 쉽다. 하지만 Vercel로 배포한 웹앱은 빌드 결과물과 설정값이 브라우저까지 그대로 내려오기 때문에, 개발자도구의 Network 탭과 Sources 탭만 열어도 점검할 거리가 생각보다 많이 보인다. 스레드 원문에서 정리한 10가지 항목과 공개된 점검 글에서 확인되는 기본 항목을 함께 엮어, 배포 직후 바로 해볼 수 있는 확인 순서로 정리했다. 전문 보안 진단이 아니라 흔한 실수를 빠르게 걸러내기 위한 체크리스트에 가깝다.

브라우저에서 먼저 보는 이유

확인되는 범위에서 Vercel은 글로벌 배포, 서버리스 함수, 프리뷰 URL, 커스텀 도메인과 SSL 인증서 같은 기능을 함께 제공한다. 도메인을 프로젝트에 연결하면 SSL 인증서 발급을 자동으로 시도한다는 점도 안내되어 있다. 문제는 그 편리함이 “설정을 확인하지 않아도 된다”는 뜻은 아니라는 것이다.

브라우저로 내려오는 것은 크게 두 갈래다. 하나는 HTML·JS·CSS 같은 정적 결과물이고, 다른 하나는 그 결과물이 호출하는 API 요청과 응답이다. 개발자도구의 Network 탭은 두 번째를, Sources 탭은 첫 번째를 보여준다. 서버 코드를 열어보지 않아도 이 두 탭에서 상당 부분이 드러난다.

개발자도구에서 확인할 항목

원문에서 제시한 10가지를 표로 정리하면 다음과 같다.

번호 확인 항목 주로 보는 곳 문제 신호
1 NEXT_PUBLIC_ 변수에 이상한 값이 없는지 Sources(번들) 키처럼 보이는 문자열
2 브라우저 JS에 secret처럼 보이는 값이 없는지 Sources 토큰·비밀키 하드코딩
3 API 주소가 그대로 노출되어 있는지 Network 내부용 주소 노출
4 sourcemap 파일이 열리는지 Sources 원본 소스 열람 가능
5 에러 메시지에 내부 정보가 보이는지 Console·Network 스택 트레이스, 내부 경로
6 관리자/테스트 경로가 추측 가능한지 주소창 /admin 등 무인증 접근
7 요청 응답에 불필요한 헤더가 많은지 Network 서버·프레임워크 정보
8 로그성 응답이 사용자에게 보이지 않는지 Network 디버그 로그 노출
9 인증 없이 호출되는 API가 없는지 Network 무인증 데이터 반환
10 Preview 주소가 아무나 접근 가능한지 주소창 배포 전 버전 공개

각 항목은 같은 도구로 확인하지만 의미는 조금씩 다르다. 아래에서 특히 자주 문제가 되는 세 가지를 짚어본다.

환경변수와 클라이언트 번들

Next.js에서 NEXT_PUBLIC_ 접두사가 붙은 환경변수는 빌드 시점에 클라이언트 코드로 인라인되는 것으로 알려져 있다. 즉 브라우저로 전달되는 번들 안에 값이 그대로 들어간다. 따라서 이 접두사가 붙은 변수에는 공개되어도 무방한 값만 넣어야 한다. Sources 탭에서 번들을 검색해 이상한 문자열이나 secret처럼 보이는 값이 보이지 않는지 확인하는 이유가 여기에 있다.

sourcemap과 원본 소스 노출

프로덕션 빌드에서 sourcemap이 함께 배포되면 브라우저가 압축된 번들을 원본 소스 형태로 복원해 보여줄 수 있다. 개발 편의를 위해 켜두는 경우가 있지만, 배포 환경에서는 의도한 설정인지 한 번쯤 확인할 항목이다. Sources 탭에서 원본 파일 트리가 그대로 보인다면 설정을 점검해볼 만하다.

API 주소와 무인증 엔드포인트

Network 탭을 열고 페이지를 조작하면 앱이 호출하는 API 목록이 그대로 나열된다. 여기서 확인할 것은 두 가지다. 첫째, 내부용이어야 할 주소가 클라이언트에 박혀 있지 않은지. 둘째, 그중 인증 없이 호출해도 데이터가 돌아오는 엔드포인트가 없는지다. 주소가 노출되는 것 자체가 곧 취약점은 아니지만, 인증 없이 데이터를 반환하는 엔드포인트는 별개의 문제다.

배포가 쉬워진 만큼, 배포 후 확인해야 할 기본 항목을 놓치기도 쉽다.

HTTPS와 실패 화면도 함께 본다

공개된 점검 글에서는 개발자도구 항목 외에 주소창에서 바로 확인할 수 있는 기본 항목도 함께 다룬다.

먼저 http://로 접속했을 때 https://로 이동하는지, 자물쇠 표시가 정상인지, 인증서 경고가 뜨지 않는지를 본다. 커스텀 도메인을 막 연결한 직후에는 DNS 전파 시간이 필요할 수 있으므로 바로 판단하지 말고 잠시 뒤 다시 확인하는 편이 좋다.

다음으로 존재하지 않는 주소로 접속해본다. 사용자에게는 깔끔한 404 화면이 보이는 것이 좋고, 서버 내부 경로나 프레임워크 디버그 정보, 스택 트레이스, 데이터베이스 관련 오류, 환경변수 이름 같은 것이 노출되면 좋지 않다.

마지막으로 /admin, /dashboard, /manager, /test, /dev, /cms 같은 경로를 직접 입력해본다. 해당 페이지가 없다면 404가, 있다면 로그인이나 권한 확인이 먼저 나와야 한다. 로그인 없이 관리자 화면이 열리는 경우가 가장 경계해야 할 신호다.

핵심 정리

  • Vercel 배포 후에는 화면 동작만 보지 말고 개발자도구의 Network·Sources 탭을 함께 확인한다.
  • NEXT_PUBLIC_ 접두사가 붙은 값과 번들에 포함된 문자열은 브라우저에서 그대로 보인다고 가정한다.
  • sourcemap 공개 여부, API 주소 노출, 인증 없는 엔드포인트는 서로 다른 문제이므로 각각 따로 확인한다.
  • Preview 주소는 배포 전 버전을 담고 있으므로 접근 범위를 의도한 대로 두었는지 확인한다.
  • 정상 화면뿐 아니라 404·에러 화면과 /admin 같은 추측 가능한 경로도 점검 대상에 넣는다.
  • HTTPS 리다이렉트와 인증서 상태는 커스텀 도메인 연결 직후 특히 확인한다.

실무 적용 포인트

배포할 때마다 모든 항목을 손으로 확인하기는 어렵다. 현실적인 방법은 순서를 정해두는 것이다.

  1. 배포 직후 주소창에서 http 접속과 인증서 상태를 확인한다.
  2. 개발자도구를 열고 Network 탭에서 요청 목록과 응답 헤더를 훑는다.
  3. Sources 탭에서 번들을 검색해 환경변수 이름과 의심스러운 문자열을 찾아본다.
  4. 존재하지 않는 경로와 /admin 계열 경로를 직접 입력해 실패 화면을 확인한다.
  5. Preview 주소가 외부에 공개되어도 되는지 배포 정책과 비교한다.

여기에 더해, 인증이 필요한 API는 클라이언트 코드가 아니라 서버 측에서 한 번 더 검증하는 구조를 권장한다. 브라우저에서 호출 가능한 엔드포인트는 누구나 호출할 수 있다고 보는 편이 안전하다. 확인되는 범위에서 Vercel은 WAF나 배포 환경 분리 같은 기능도 제공하므로, 수동 점검과 함께 이런 계층을 활용하는 것도 방법이다.

점검 결과를 간단히라도 기록해두면 다음 배포 때 비교하기 쉽다. 거창한 도구 없이 브라우저 개발자도구만으로도 상당 부분을 걸러낼 수 있다는 점이 이 체크리스트의 장점이다.

자주 묻는 질문

Q. 왜 서버 코드를 보지 않고 브라우저만으로 점검이 가능한가요?
A. 브라우저로 내려오는 번들, 요청, 응답 자체가 배포 결과물이기 때문입니다. Sources 탭에서는 클라이언트에 포함된 문자열과 sourcemap 공개 여부를, Network 탭에서는 호출되는 API 주소와 응답 헤더·본문을 확인할 수 있습니다. 서버 코드를 열지 않아도 배포 직후의 흔한 실수는 상당 부분 드러납니다.

Q. NEXT_PUBLIC_ 환경변수는 왜 따로 확인해야 하나요?
A. Next.js에서 NEXT_PUBLIC_ 접두사가 붙은 환경변수는 빌드 시점에 클라이언트 코드로 인라인되는 것으로 알려져 있습니다. 즉 브라우저 번들 안에 값이 그대로 들어가므로, 이 접두사가 붙은 변수에는 공개되어도 무방한 값만 넣어야 합니다.

Q. Preview 주소는 무엇을 기준으로 확인해야 하나요?
A. 배포 전 버전이 담기는 주소이므로 외부에 공개되어도 되는지 배포 정책과 비교하는 것이 기준입니다. 접근 범위를 의도한 대로 두었는지, 주소를 아는 사람이면 누구나 열 수 있는 상태인지를 확인하고 필요하면 접근 제한을 검토하는 편이 좋습니다.

원본

https://www.threads.com/@caffeine__coder/post/DZ638dKEfeU

함께 보면 좋은 글

댓글 0개