CI/CD

Next.js 16 Server Actions 교차 출처 요청 거부? 역방향 프록시 점검 방법 (2026)

Server Actions 제출이 프록시 뒤에서 거부되거나 응답 없이 끝납니다.
가장 먼저 브라우저의 Origin, 프록시가 전달한 Host, 애플리케이션이 받은 요청을 대조하세요. 실제로 허용된 교차 출처 호출이라면 그때만 serverActions.allowedOrigins에 필요한 공개 출처를 좁혀 추가합니다.

이 글은 역방향 프록시나 게이트웨이 뒤에 Next.js 16 App Router 앱을 운영하는 프런트엔드 엔지니어를 위한 점검 절차입니다.
프록시 규칙과 요청 헤더를 관리하는 플랫폼 담당자도 전달 경로를 확인할 수 있습니다.
애플리케이션 보안 담당자는 허용 출처의 범위를 판단할 수 있습니다.

먼저 실패 지점을 요청 단계별로 구분합니다

브라우저에 표시되는 “출처가 허용되지 않음” 메시지만으로 CORS 문제라고 단정하지 마세요. Server Actions의 출처 검증 거부, 프록시의 요청 차단, 애플리케이션 코드의 예외는 서로 다른 원인입니다. Next.js 공식 문서는 Server Actions 요청의 Origin과 Host를 비교하며, 추가 허용 출처를 설정하는 방법도 안내합니다. Server Actions 보안 설명과 설정 문서를 기준으로 현재 앱 버전의 동작을 확인하세요.

Next.js 16 Server Actions가 출처를 허용하지 않는다고 표시하면 어디부터 확인하나요? 브라우저 네트워크 패널에서 실패한 요청의 주소, Origin, 응답 상태를 확인한 뒤, 같은 요청이 애플리케이션 로그까지 도달했는지 대조합니다. 앱에 도달하지 않았다면 프록시나 게이트웨이를 먼저 확인해야 합니다. 앱에 도달했지만 출처 검증 단계에서 거부됐다면 전달된 Host와 설정을 살펴봅니다.

Origin 헤더는 요청을 시작한 출처를 나타내며, 출처는 스킴과 호스트, 선택적으로 포트로 구분됩니다. 따라서 https와 http, 서로 다른 호스트명, 또는 포트 차이도 확인 대상입니다. MDN의 Origin 설명을 참고해 주소창의 페이지 주소와 요청 헤더를 비교하세요.

응답 상태는 단서이지 원인 판정 자체는 아닙니다. HTTP 403은 서버가 요청을 이해했지만 처리를 거부한 경우를 뜻합니다. 다만 이 상태만으로 거부 주체가 Next.js인지 프록시인지 확정할 수는 없습니다. HTTP 의미와 상태 코드 정의와 함께 프록시 로그 및 앱 로그를 확인하세요.

브라우저 호출자는 공개 주소와 요청 출처를 대조합니다

브라우저에서 페이지를 연 주소와 Action 요청 주소를 나란히 기록합니다. 개발, 미리 보기, 운영 환경이 서로 다른 도메인을 사용한다면 환경별 결과도 따로 남깁니다. 특히 미리 보기 주소에서 운영 도메인으로 폼을 제출하거나, 페이지는 HTTPS인데 요청 목적지가 HTTP로 바뀌는 구성이 있는지 확인하세요.

운영 환경에서만 교차 출처 오류가 생기면 어떻게 찾나요? 로컬에서 성공했다는 사실만으로 운영 프록시가 정상이라고 볼 수 없습니다. 운영 페이지에서 실패한 요청의 Origin, 요청 대상 호스트, 응답 상태를 확보하고 같은 기능을 미리 보기 환경과 비교합니다. 비교 자료에는 쿠키와 토큰을 포함하지 말고, 공유할 때는 민감한 요청 헤더와 경로 정보를 가립니다.

Server Actions의 호출 및 요청 흐름은 Next.js 데이터 변경 안내에서 확인할 수 있습니다. 여기서 설명하는 요청 흐름과 실제 브라우저 기록이 다르면, 앱 코드의 상태 처리나 캐시부터 손대기보다 먼저 요청 주소가 바뀌는 구간을 찾는 편이 정확합니다.

프록시 담당자는 전달 후 Host를 확인합니다

프록시 앞에서 보이는 공개 호스트와 앱 프로세스가 받은 Host가 다르면, 출처 비교가 예상과 달라질 수 있습니다. 여러 단계의 프록시를 사용한다면 각 단계에서 Host를 보존하는지, X-Forwarded-Host를 설정하거나 전달하는지, 내부 호스트로 덮어쓰는지 따로 확인합니다. X-Forwarded-Host는 프록시가 전달한 원래 호스트 정보를 나타내는 데 쓰입니다. MDN의 X-Forwarded-Host 설명을 기준으로 실제 헤더 값을 검토하세요.

Next.js의 자가 호스팅 배포 문서는 앞단 프록시를 포함한 배포 구성과 요청 전달을 다룹니다. 자가 호스팅 가이드도 함께 확인하세요. 프록시 앞과 앱 로그에서 확인한 값을 비교하면, 헤더가 사라진 단계나 내부 주소로 바뀐 단계를 좁힐 수 있습니다.

역방향 프록시 뒤에서 Origin과 Host가 다르면 바로 허용 목록을 늘려야 하나요? 아닙니다. 먼저 프록시 설정이 의도한 공개 호스트를 앱에 전달하는지 확인합니다. 잘못된 헤더 전달을 방치한 채 허용 출처를 넓히면 원래 원인은 남고 신뢰 범위만 커질 수 있습니다. 프록시를 우회한 최소 재현과 프록시를 통과한 재현을 비교하면 전달 문제인지 앱의 출처 검증 문제인지 구분하기 쉽습니다.

보안 담당자는 필요한 공개 출처만 허용합니다

serverActions.allowedOrigins는 모든 CORS 문제를 해결하는 스위치가 아닙니다. 프록시의 실제 전달 상태를 확인하고, 의도된 교차 출처 호출이 필요하다고 판단된 경우에만 공식 문서의 현재 버전 설정을 적용하세요. 허용 값은 앱이 받는 요청 경로와 배포 구조에 맞춰야 합니다. 넓은 와일드카드나 관련 없는 하위 도메인을 한꺼번에 허용하는 방식은 피합니다.

허용 출처에는 브라우저 도메인과 프록시 도메인 중 무엇을 적어야 하나요? 실제 요청의 Origin과 앱에 도달한 Host, 그리고 프록시 구성에 따라 결정해야 합니다. 브라우저 주소만 보고 입력하거나 내부 프록시 주소를 추측해 넣지 마세요. 설정 이름과 배열 형식, 설정 위치는 Server Actions 공식 설정 문서에서 사용 중인 Next.js 버전 기준으로 확인합니다. 설정 뒤에는 앱을 재시작하거나 해당 배포 절차에 따라 새 설정이 반영됐는지도 검증합니다.

다음 순서로 증거를 남기면 원인과 수정 범위를 추적하기 쉽습니다.

  • [ ] 실패 요청의 브라우저 주소와 Action 요청 주소를 기록합니다.
  • [ ] 요청의 Origin과 브라우저가 연결한 호스트를 확인합니다.
  • [ ] 프록시 각 단계의 Host 및 X-Forwarded-Host 전달 결과를 비교합니다.
  • [ ] 앱 로그에서 요청 도달 여부와 거부 지점을 확인합니다.
  • [ ] 허용 출처가 필요한 경우, 실제 공개 출처만 설정합니다.
  • [ ] 허용된 출처의 요청은 성공하고 예상하지 않은 출처는 거부되는지 각각 시험합니다.

배포 전에는 원인과 수정 범위를 표로 판정합니다

아래 비교에서 먼저 확인된 경로를 선택하세요. 상태 코드 한 번만으로 결론을 내리지 말고, 브라우저 기록과 각 서버 로그를 함께 대조해야 합니다.

관찰 결과 우선 의심할 구간 다음 확인
요청이 앱 로그에 없음 프록시, 게이트웨이, 경로 전달 프록시 차단 규칙과 전달 대상
앱에 도달했지만 Origin과 Host가 예상과 다름 헤더 전달 또는 호스트 재작성 프록시 단계별 헤더 비교
요청 헤더가 배포 의도와 일치하지만 출처 검증에서 거부됨 허용 출처 설정 또는 실제 교차 출처 호출 버전별 공식 설정과 필요한 허용 범위
출처 검증은 통과하고 앱 로직에서 오류 발생 Action 내부 처리 서버 로그와 데이터 변경 로직

수정 전후 결과는 정상 출처와 비허용 출처를 나눠 기록하세요. 정상 요청이 성공하는지만 확인하면 신뢰 범위가 의도보다 커졌는지 놓칠 수 있습니다. 공개 호스트 전환이나 미리 보기 주소 변경도 회귀 시험에 포함하고, 민감한 값은 제거한 요청 헤더와 결과를 보관합니다. 인증과 권한 확인은 출처 검증과 별개의 책임이므로 Next.js 인증 안내도 함께 검토하세요.

선택지 적합한 경우 비용·위험 판단
프록시 헤더 전달 수정 앱에 잘못된 Host가 도달하거나 전달 과정에서 값이 바뀌는 경우 설정 변경 후 요청 경로 전체를 다시 검증해야 합니다
serverActions.allowedOrigins에 출처 추가 전달 경로가 확인됐고 필요한 교차 출처 호출이 실제로 있는 경우 허용 범위를 좁게 유지하고 비허용 출처도 시험해야 합니다
앱의 인증·권한 로직 수정 출처 검증을 통과한 뒤 Action의 사용자 권한이나 처리 로직에서 실패하는 경우 출처 허용만으로 권한 문제를 해결할 수 없습니다

현재 팀이 개발자 로컬 환경과 공유 스테이징을 번갈아 쓰고 있다면, 환경별 도메인 차이로 재현 조건이 흐려지고 요청 헤더 기록이 한곳에 모이지 않는 문제가 생길 수 있습니다. 일시적인 macOS 브라우저 검증 환경이 필요할 때는 KuzCloud의 클라우드 맥 이용 안내를 살펴볼 수 있습니다. 분리된 개발·검증 환경은 브라우저 요청을 비교하는 데 보탬이 될 수 있지만, 운영 프록시나 서버를 대신하지는 않습니다. 장기간 고정 부하를 처리하거나 물리 장비와 직접 연결해야 한다면 임대보다 자체 장비가 적합할 수 있습니다. 임시 테스트용 맥 환경이 필요한 경우에 한해 KuzCloud 이용 환경을 확인하고, 실제 운영 요청은 반드시 배포된 프록시와 서버에서 다시 검증하세요.

실제 맥 환경에서 배포를 점검해 보세요

전용 맥 미니 엠사에서 역방향 대리 서버를 거치는 요청 흐름을 직접 확인해 보세요.

가상화 없이 물리 장비를 단독으로 사용하고, 루트 권한으로 필요한 개발 도구를 자유롭게 설치할 수 있습니다.