문제 해결

빌드 실패: vitepress를 찾을 수 없음

의존성이 설치되어 있고 Cloudflare Pages가 빌드 전에 설치 단계를 실행하는지 확인하세요.

npm install
npm run build

빌드는 성공하지만 페이지가 404를 반환함

빌드 출력 디렉터리가 .vitepress/dist인지 확인하세요. 출력 디렉터리가 잘못되면 다른 파일이 배포됩니다.

.vitepress/dist

docs.hideapps.top이 열리지 않음

1. docs.hideapps.top이 Pages Custom domains에 추가되었는지 확인합니다.
2. docs CNAME 레코드가 있는지 확인합니다.
3. 대상이 hideapps-docs.pages.dev인지 확인합니다.
4. 방금 추가했다면 Cloudflare 인증서 발급이 끝날 때까지 기다립니다.

HTTPS 인증서가 계속 대기 중

hideapps.top에 인증서 발급을 제한하는 CAA 레코드가 있는지 확인하세요.

로컬 미리보기는 정상인데 온라인 스타일이 누락됨

이 프로젝트는 하위 도메인 루트에 배포되므로 VitePress base 설정이 필요 없습니다.