Docs Menu
Docs Home
/ /
Atlas App Services
/ /

사용자 정의 404 페이지 사용

이 페이지의 내용

  • 개요
  • 절차

기본값 404 페이지 를 대체할 수 있습니다. 사용자가 사용자 지정 HTML 문서 에 존재하지 않는 리소스 에 액세스 하려고 할 때 Atlas App Services 에 표시되는 . App Services UI 에서 이 사용자 지정 404 페이지를 지정하거나 hosting 디렉토리 에 페이지가 포함된 애플리케이션 구성 디렉토리 를 가져올 수 있습니다. 사용하려는 방법에 해당하는 탭 을 아래에서 선택합니다.

참고

단일 페이지 앱의 404 오류

단일 페이지 애플리케이션 호스팅 이 활성화되면 App Services는 요청된 경로에 관계없이 항상 앱 루트와 함께 HTTP 200 응답을 반환합니다. 즉, SPA에 대해 사용자 지정 404 페이지를 지정할 수 없습니다. 대신 애플리케이션에 사용자 지정 코드를 포함하여 유효하지 않은 경로를 처리해야 합니다.

1

호스팅된 모든 파일을 사용자 지정 404 페이지로 사용할 수 있습니다. 다음 요소를 포함하는 HTML 파일을 사용하는 것이 일반적입니다.

  • 오류를 나타내는 짧은 메시지(예: "존재하지 않는 페이지입니다."

  • 사용자가 계속 탐색할 수 있는 대체 링크 또는 옵션입니다.

2

사용자 지정 404 파일 을 만든 후에는 해당 파일 을 App Services 에 업로드 해야 합니다. 파일 을 업로드하려면 App Services UI 의 Hosting 화면으로 이동하여 Upload Files 를 클릭하고 사용자 지정 HTML 파일 을 선택합니다.

3

404 파일을 성공적으로 업로드한 후에는 기본 404 페이지 대신 해당 파일을 제공하도록 App Services를 구성하는 것만 남았습니다.

  1. Hosting 페이지에서 Settings 탭을 클릭합니다.

  2. Custom 404 Page에서 Choose File을 클릭합니다.

  3. 목록에서 사용자 지정 404 파일을 선택합니다.

  4. Save를 클릭합니다.

Hosting 구성을 업데이트하면 App Services에서 기본 404 페이지 대신 사용자 지정 파일을 제공하기 시작합니다.

1

App Services CLI 를 사용하여 사용자 지정 404 페이지를 구성하려면 애플리케이션 구성 파일의 로컬 복사본이 필요합니다.

최신 버전의 앱의 로컬 사본을 가져오려면 다음을 실행하세요.

appservices pull --remote="<Your App ID>"

Realm UI의 Deploy > Import/Export App 화면에서 애플리케이션의 구성 파일 사본을 다운로드할 수도 있습니다.

2

애플리케이션의 404 페이지에 유효한 HTML 파일을 사용할 수 있습니다. 다음 요소를 통합하는 것을 고려하세요.

  • 오류를 나타내는 짧은 메시지(예: "존재하지 않는 페이지입니다."

  • 사용자가 계속 탐색할 수 있는 대체 링크 또는 옵션입니다.

3

사용자 지정 HTML 파일을 만든 후에 는 App Services에서 해당 파일을 호스팅해야 합니다.

App Services에서 HTML 파일을 아직 호스팅하지 않는 경우 해당 파일을 hosting/files/ 디렉토리에 추가하세요.

4

hosting/config.json 에서 default_error_path 을 404 페이지 HTML 파일의 리소스 경로 로 설정한 다음 구성 파일을 저장합니다.

"hosting": {
"enabled": true,
"default_error_path": "/pages/custom_404.html"
}
5

hosting/config.json 을(를) 업데이트한 후에는 업데이트된 구성을 원격 앱에 푸시할 수 있습니다. 404 페이지도 추가한 경우에는 --include-hosting 플래그를 사용해야 합니다. App Services CLI는 푸시 시 사용자 지정 404 페이지를 즉시 제공하기 시작합니다.

appservices push --remote="<Your App ID>" --include-hosting

돌아가기

Atlas App Services에 콘텐츠 업로드

이 페이지의 내용