Pancake Stack › Pancake Stack 매뉴얼

1분 만에 사이트를 만듭니다. 종류를 고르고, 이름을 정하고, 누가 볼 수 있는지 정한 다음 name.localhost에서 엽니다.

3.1네 가지 질문으로 사이트 만들기

1. 사이트 패널 오른쪽 위의 새 사이트를 클릭하거나 ⌘N을 누르십시오.
2. 만들기 아래에서 PHP 사이트, 정적 HTML 사이트, Python 앱 중 하나를 고르십시오. (WordPress, Laravel 등 다른 선택지는 아래에서 설명합니다.)
3. 이름. blog와 같은 이름을 입력하십시오. 입력하는 동안 Pancake가 사이트의 주소 blog.localhost를 보여 줍니다.
4. 종류. 종류를 확인하거나 바꾸십시오. PHP 사이트, 정적 HTML 사이트, Python 앱 중 하나입니다.
5. 버전 또는 프레임워크. PHP라면 PHP 버전을 고르십시오. Python이라면 Django, Flask, FastAPI, 기존 프로젝트(WSGI) 중에서 고르십시오.
6. 누가 볼 수 있나요? 나만을 고르면 이 Mac에만 둡니다. 누구나(임시 테스트 링크)와 누구나(내 도메인, Cloudflare)는 사이트를 바로 온라인에 올립니다(사이트를 온라인에 올리기 참조).
7. 만들기를 클릭하십시오. Pancake가 폴더를 만들고, 사이트의 데이터베이스를 만들고, 서버를 시작하거나 다시 불러옵니다.

완료되면 사이트가 사이트 패널에 카드로 나타납니다. 열기를 클릭하면 브라우저에서 볼 수 있습니다.

3.2이름과 주소

사이트의 이름이 곧 주소가 됩니다. shop은 http://shop.localhost에서 열립니다. 이름에는 영문 소문자, 숫자, 하이픈(연속 불가)을 최대 40자까지 쓸 수 있습니다. 몇몇 이름은 Pancake 자체용으로 예약되어 있습니다. localhost, www, pancake, admin, adminer입니다.

Mac의 모든 브라우저는 별도 설정 없이 .localhost 이름을 인식하며, 이 이름은 인터넷으로 나가지 않습니다. 휴대폰에서 사이트를 열려면 내 네트워크와 로컬 HTTPS를 참조하십시오.

Pancake는 가능하면 표준 웹 포트 80을 사용합니다. Mac의 다른 웹 서버가 이미 포트 80을 쓰고 있으면 Pancake가 자동으로 8080으로 옮기며, 주소에 포트가 붙습니다(http://shop.localhost:8080). 포트가 80이 아닐 때는 상태 표시에 포트가 나타납니다. 대체 포트는 설정 ▸ 고급 ▸ 웹 포트에서 직접 고를 수 있습니다.

3.3어떤 종류의 사이트를 만들까요?

이미 있는 사이트를 가져오려면 같은 시트에서 사이트 가져오기를 여십시오. 사이트 가져오기를 참조하십시오.

3.4WordPress

1. 새 사이트 ▸ WordPress를 선택하십시오.
2. 사이트 이름, 제목, 관리자 사용자, 관리자 이메일을 입력하십시오. Pancake가 강력한 무작위 관리자 비밀번호를 만들어 줍니다. 복사를 클릭해 보관하거나, 직접 입력하십시오(8자 이상).
3. 볼 수 있는 사람과 WordPress를 가져올 곳을 고르십시오. wordpress.org에서 최신 버전 내려받기 또는 내려받은 ZIP입니다.
4. 만들기를 클릭하십시오. Pancake가 데이터베이스를 만들고, WordPress를 설치하고, 설정을 마칩니다. 사이트 열기를 클릭하면 /wp-admin/의 대시보드로 이동합니다.

데이터베이스 암호는 사이트의 파일에 기록되지 않습니다. WordPress는 Pancake가 제공하는 환경에서 암호를 읽습니다.

3.5Laravel

새 사이트 ▸ Laravel을 선택하고 이름을 정하십시오. Pancake가 내장된 Composer로 Laravel을 내려받고(1~2분 소요), public/ 폴더를 제공하며, 앱에 MySQL 데이터베이스를 주고 첫 마이그레이션을 실행합니다.

3.6Python 앱

Python 앱을 고른 다음 프레임워크를 고르십시오. Pancake가 최신 Python(3.14)으로 사이트 전용 Python 환경을 만들고, PyPI에서 프레임워크를 내려받아 시작합니다. 처음에는 1분 정도 걸립니다.

• Django는 gunicorn으로 실행되며, /static/은 staticfiles에서, /media/는 media에서 제공됩니다. 카드에 마이그레이트, 정적 파일 수집, 슈퍼유저…가 추가됩니다(그다음 /admin/에서 로그인하십시오).
• Flask는 app:app을 gunicorn으로, FastAPI는 main:app을 uvicorn으로 실행합니다.
• 기존 프로젝트(WSGI): 사이트를 만들고 프로젝트를 그 폴더에 넣은 다음(폴더 보기), 앱 진입점(예: wsgi:application)을 지정하고 설정을 클릭하십시오.

패키지는 필요한 패키지 설치로 PyPI에서 설치합니다. 샌드박스 안에서는 Pancake가 패키지를 컴파일할 수 없으므로, 대부분의 앱에 필요한 컴파일된 패키지(pydantic-core, psycopg2, cryptography, MarkupSafe 등)가 Pancake에 내장되어 있습니다. 순수 Python 패키지는 평소대로 설치됩니다.

3.7Pancake가 만들어 준 것

• 폴더: Pancake의 데이터 폴더 안 Sites/<name>에 있습니다. 카드의 폴더 보기를 클릭하면 Finder에서 열립니다.
• 웹 서버 항목: <name>.localhost용 Apache 가상 호스트입니다.
• MySQL 데이터베이스와 사용자: 둘 다 사이트 이름을 따르며(하이픈은 밑줄로 바뀜), 무작위 암호는 키체인에 보관됩니다.
• 환경 변수: 사이트 코드가 읽을 수 있으므로 비밀 정보를 파일에 넣지 않아도 됩니다.

PHP에서는 getenv('DB_NAME')으로, Python에서는 os.environ["DB_NAME"]으로 읽습니다. 외부 데이터베이스를 쓰는 사이트에는 DATABASE_URL도 주어집니다. FullStack에서는 Valkey와 Memcached의 주소도 주어집니다(서비스 참조).