주방 · 참고

문제 해결

사이트가 열리지 않거나 서버가 시작되지 않거나 링크가 작동하지 않을 때 해야 할 일, Pancake가 데이터를 보관하는 위치, 도움을 받는 방법을 설명합니다.

17.1먼저 확인할 것

상태 표시를 확인합니다. 확인 필요라고 표시되면 포인터를 올려 오류를 읽습니다.
로그 윈도우(⌥⌘L)를 엽니다. "Web server"와 "MySQL" 로그는 서버를 다루며, 각 사이트에는 "PHP errors" 로그와 "web server errors" 로그가 있습니다.
⌥ 키를 누른 채 모두 중지를 클릭하면 모든 것이 다시 시작됩니다.
어시스턴트에게 "블로그에 왜 오류가 나?"라고 물어보십시오. 어시스턴트가 로그를 대신 읽습니다.

17.2사이트가 열리지 않음

브라우저가 연결할 수 없음: 서버가 중지되어 있을 가능성이 높습니다. 모두 시작을 클릭하십시오. 서버가 중지된 동안에는 열기 버튼이 비활성화됩니다.
주소에 포트가 필요함: Mac의 다른 웹 서버(macOS의 Apache, MAMP, Docker)가 포트 80을 쓰고 있으면 Pancake는 8080으로 옮깁니다. 이때 상태 표시에 실행 중 :8080이 나타나고 주소는 http://blog.localhost:8080과 같은 형태가 됩니다. 항상 올바른 주소를 쓰는 사이트 카드의 열기 버튼을 사용하십시오.
빈 페이지 또는 "500 Internal Server Error": PHP 오류입니다. 사이트의 "PHP errors" 로그를 열거나, 페이지에 오류 표시를 사이트의 PHP 설정에서 켜십시오.
"Error establishing a database connection": MySQL이 실행 중이 아니거나(모두 시작), 사이트 구성이 Pancake가 제공하는 DB_… 변수 대신 고정된 데이터베이스 정보를 사용하고 있습니다. 가져온 WordPress 사이트는 이 변수를 읽도록 설정됩니다.
폴더에 "Forbidden"이 표시됨: index 페이지가 없습니다. index.html이나 index.php를 추가하거나 AutoIndex를 켜십시오.
React나 Vite 앱에서 /about 같은 링크가 "Not Found"가 됨: 사이트 카드(고급)에서 싱글 페이지 앱을 켜십시오.
WordPress가 예전 운영 주소로 이동함: 데이터베이스에 예전 주소가 남아 있습니다. 다시 가져오면서 바꿀 이전 사이트 주소를 입력하거나, 주소를 자동으로 바꿔 주는 운영 중인 웹사이트에서를 사용하십시오.

17.3서버가 시작되지 않음

"MySQL이 수신을 시작하지 않았습니다": MySQL이 충돌 후 아직 복구 중일 수 있습니다(Pancake는 최대 1분까지 기다립니다). "MySQL" 로그를 읽으십시오. 다른 MySQL이 포트 3306을 쓰고 있으면 Pancake가 다음 빈 포트를 자동으로 사용하므로, 그것은 원인이 아닙니다.
"… 예기치 않게 중지됨": 서버가 충돌하여 Pancake가 스택의 일관성을 유지하려고 모든 것을 중지했습니다. 메시지에 나온 로그를 읽은 다음 다시 모두 시작을 실행하십시오.
"템플릿 …이(가) 적용되지 않음": 편집한 템플릿을 불러오지 못했습니다. Pancake는 자체 템플릿을 사용하고 있습니다. 설정 ▸ 고급 ▸ 템플릿…을 열어 표시된 줄을 고치거나 재설정하십시오.
Python 사이트에 "아직 설정되지 않았습니다"가 표시됨: 사이트 카드에서 설정을 클릭하십시오. 앱이 시작되지 않으면 앱 로그를 읽고 앱 진입점(module:callable)을 확인하십시오.

17.4온라인 문제

테스트 링크가 나타나지 않음: 외부 접속이 켜져 있고 서버가 실행 중인지 확인하십시오. 새 링크는 약 20초 걸립니다. 1분이 지나도 나타나지 않으면 "test link" 로그에 이유가 나옵니다(나가는 터널을 차단하는 네트워크인 경우가 많습니다).
내 도메인에 Cloudflare 오류가 표시됨: 터널이 연결되어 있지 않습니다. 외부 접속이 꺼져 있거나, 서버가 중지되어 있거나, Mac이 잠자기 상태이거나 오프라인입니다. 온라인 패널의 사이트 카드에 터널 상태가 표시되며, 터널 로그 보기(고급)에서 자세한 내용을 볼 수 있습니다.
"요금제의 공개 사이트 한도 초과": 다른 사이트를 끄거나, 다른 Mac에서 사이트를 공개하고 있지 않은지 확인하십시오(어느 Mac인지는 온라인 패널에 표시됩니다).
휴대폰에서 blog.test가 열리지 않음: 휴대폰이 이 Mac의 주소를 DNS 서버로 사용하고 같은 네트워크에 있어야 합니다. blog.localhost는 휴대폰에서 절대 열리지 않습니다.

17.5기타 문제

https://name.localhost에서 브라우저가 인증서 경고를 표시함: 설정 ▸ 로컬 HTTPS를 열고 다시 신뢰…를 클릭하십시오. Firefox에서는 macOS 인증서를 사용하는 옵션을 켜십시오.
메일이 도착하지 않음: 의도된 동작입니다. 메일은 메일함(⇧⌘M)에 보관됩니다. 실제 메일을 보내려면 실제 메일 보내기를 참조하십시오.
외부 데이터베이스에 연결되지 않음: 테스트 후에 나오는 메시지를 읽으십시오. 테스트에 실패하면을 참조하십시오.
어시스턴트가 Apple Intelligence를 사용할 수 없다고 함: 시스템 설정 ▸ Apple Intelligence 및 Siri에서 Apple Intelligence를 켜고 모델이 다운로드될 때까지 기다리십시오. Apple Intelligence가 없는 Mac에서는 클라우드 제공업체를 사용할 수 있습니다(답변은 어디에서 오는가 참조).
AI 도구가 "changes are switched off"라고 함: 어시스턴트 패널의 고급 설정 맨 아래에서 변경 허용을 선택하십시오.

17.6Pancake가 데이터를 보관하는 위치

Pancake는 샌드박스에서 실행되므로 모든 데이터가 자체 컨테이너에 있습니다. 설정 ▸ 고급 ▸ 데이터 폴더 보기로 컨테이너를 엽니다.

폴더	내용
`Sites/`	사이트마다 폴더 하나.
`logs/`	모든 로그(로그 보기로도 열 수 있음).
`backups/`	백업과 저장 지점. 사이트마다 폴더 하나.
`mail/`	보관된 메일(`.eml` 파일).
`mysql/`	MySQL 데이터.
`templates/`	편집한 템플릿.

전체 경로는 ~/Library/Containers/jp.co.enfour.pancake/Data/Library/Application Support/Pancake/입니다. 암호와 키는 키체인에 있으며 이 폴더에는 절대 저장되지 않습니다.

서버	포트	사용 중일 때
웹(HTTP)	80	8080
웹(HTTPS)	443	8443
MySQL	3306	다음 빈 포트
PostgreSQL	5432	다음 빈 포트
Valkey	6379	다음 빈 포트
Memcached	11211	다음 빈 포트
MCP 서버	19810
Xdebug(편집기가 수신)	9003

17.7도움 받기

도움말 ▸ Pancake 도움말(⌘?)에서 영어, 일본어, 한국어로 된 주제를 검색할 수 있습니다.
Pancake Stack 지원 페이지에서 자주 묻는 질문에 대한 답과 문의 방법을 확인할 수 있습니다.
문의할 때는 macOS 버전, Mac 종류(Apple 실리콘 또는 Intel), 상태 표시와 로그의 내용을 알려 주십시오. 암호나 키는 절대 보내지 마십시오.