본문 바로가기

배포

만든 프로젝트를 배포하면 바로 인터넷 주소가 생겨요.

배포 안내

배포 주소 안내

배포하면 앱 이름이 들어간 주소로 열려요.

https://앱이름.wenivops.co.kr

  • 앱 이름은 영문 소문자로 시작하고 소문자·숫자·하이픈(-)을 써서 3~30자로 정해요. 예: my-project
  • 하이픈으로 끝나거나 하이픈을 연달아 쓸 수 없어요.
  • 다시 배포하면 같은 주소가 새 내용으로 바뀌어요.
AI와 함께 시작하기

처음 만들 때 AI에게 주는 프롬프트

새 프로젝트를 만들 때 AI에게 그대로 붙여넣으면, 이 배포 화면에 올릴 수 있는 파일을 만들어 줘요.

  1. 프롬프트를 복사해요.

  2. 새 대화 맨 처음에 붙여넣어요.

  3. AI가 준 압축 파일을 배포 화면에 올려요.

프롬프트 내용 보기
이 프로젝트는 위니버시티 배포(교육용 호스팅)에 배포할 거야. 처음부터 아래 규칙을 지켜서 만들어 줘.

[가장 중요한 약속]
- 나는 코딩을 모르는 학생이야. 코드를 열거나 직접 고치게 하지 말고, 배포 화면에 그대로 올릴 수 있는 전체 프로젝트 압축 파일(.zip) 하나를 줘.
- 처음 완성할 때도, 기능을 바꾸거나 오류를 고칠 때도 항상 전체 프로젝트를 담은 새 ZIP을 줘. 일부 파일·수정 조각이나 "이 부분을 바꾸세요"로 끝내지 마.

[만들 수 있는 형태 - 셋 중 하나만]
1. 웹페이지: HTML/CSS/JS(가장 권장), 또는 Vite(React·Vue). Vite면 `npm run build` 결과가 dist/ 에 나오게.
2. Node.js 서버: Express 또는 Fastify. package.json에 "start" 명령(예: "start": "node server.js").
3. Python 서버: FastAPI(서버가 필요하면 가장 권장), Flask, Django, Streamlit 중 하나. 필요한 패키지는 requirements.txt에.
- 화면만 있으면 되면 웹페이지로, 서버가 꼭 필요하면 FastAPI로 만들어 줘. 배포 서버에서 가장 가볍게 돌아가.

[폴더 구조]
- 프로젝트 폴더 하나에 앱 하나만. ZIP을 열면 맨 위에 index.html, package.json, requirements.txt 중 해당 형태의 파일이 바로 보이게 압축해. 프로젝트를 감싸는 불필요한 폴더는 넣지 마.
- 프론트엔드와 백엔드를 따로 띄우지 말고, 서버가 필요하면 서버 하나가 화면(정적 파일)까지 같이 내보내게.
- Dockerfile, docker-compose 파일은 만들지 마 (배포 서버가 자동으로 빌드·실행함).

[서버 규칙]
- 서버는 반드시 환경변수 PORT의 포트로, 모든 주소(0.0.0.0)에서 열어.
  예) Node: app.listen(process.env.PORT || 3000, "0.0.0.0")
  예) Python: uvicorn main:app --host 0.0.0.0 --port $PORT
- 파일 저장(SQLite DB, 업로드 파일 등)은 /data 폴더에만 해. 다른 곳은 재배포하면 지워져.
  저장 폴더는 환경변수 DATA_DIR(로컬 기본값 ./data)로 받고, 배포할 때는 /data를 사용해. 폴더가 없으면 만들어.
- 별도 DB 서버(MySQL, PostgreSQL, MongoDB, Redis)는 쓸 수 없어. 필요하면 SQLite를 써.
- 메모리는 256MB 정도라 가볍게. 백그라운드 예약 작업(크론)은 앱이 잠들면 멈춰.

[비밀 값]
- API 키는 코드나 .env 파일에 직접 넣지 말고 process.env.이름 / os.environ["이름"] 으로 읽게 만들어.
  값은 내가 배포 화면의 '환경변수'에 넣을게.
- 브라우저에서 돌아가는 프론트엔드 코드에는 API 키를 절대 넣지 마 (누구나 볼 수 있음). 키가 필요한 호출은 서버를 거치게.

[압축에 넣지 말 것]
- node_modules, .venv, venv, .git, .env와 .env.local 같은 환경변수 파일, API 키·비밀번호·개인정보, 큰 동영상은 빼고 ZIP이 100MB를 넘지 않게 해.
- 실행·빌드에 필요한 소스, 설정, 의존성 목록, 화면 파일은 빠짐없이 넣어.

[ZIP을 주기 전 자체 점검]
아래 항목을 네가 먼저 확인하고, 결과를 짧은 체크리스트로 보여 줘. 해당 없는 항목은 "해당 없음", 확인 못 한 항목은 "미확인"으로 적어.
1. 형태: 웹페이지 / Node.js 서버 / Python 서버 중 하나
2. ZIP 맨 위: 실제 파일 이름과 index.html·package.json·requirements.txt 중 필요한 파일의 존재
3. 서버 접속: PORT 환경변수와 0.0.0.0 사용, 실행 명령과 시작 파일 일치
4. 저장: DB·업로드 파일이 /data에 저장되는지 (웹페이지의 브라우저 저장은 해당 없음)
5. 비밀 값·제외 파일 없음, ZIP 크기 100MB 이하
6. 빌드·실행: Vite면 package.json의 build 스크립트와 dist/ 출력 확인. 실행할 수 있는 환경이면 실제 빌드·실행 후 사용한 명령과 결과를 적어. 못 했으면 "빌드·실행하지 못함"과 이유를 적고 성공했다고 말하지 마.
7. 앱 이름 후보 2~3개: 영문 소문자로 시작, 소문자·숫자·하이픈으로 3~30자, 끝은 소문자·숫자, 하이픈 연속 사용 금지. 사용 가능 여부는 배포 화면에서 확인한다고 알려 줘.

[마지막 안내]
- 환경변수가 필요하면 답변 맨 마지막에 "환경변수"를 따로 적어. 필요한 이름·용도와 넣을 곳(배포 화면의 '환경변수')을 알려 줘. 실제 비밀 값은 묻거나 답변에 적지 마. 필요 없으면 "환경변수: 없음"이라고 해.
- 파일 첨부를 만들 수 없는 AI 환경에서만, 폴더 구조와 모든 파일의 전체 내용을 빠짐없이 주고 "이 파일들을 한 폴더에 저장한 뒤, 폴더 안의 파일들을 선택해 ZIP으로 압축합니다"라고 한 줄로 안내해.
- 다시 기억해: 학생이 직접 코드를 고치지 않게, 점검한 전체 프로젝트 ZIP 하나를 줘.

[진행 방법]
만들고 싶은 것을 아직 말하지 않았다면 먼저 물어봐 줘. 이미 설명했다면 그 요청으로 시작해. 내 설명을 듣고 위 세 가지 형태 중 하나를 골라 완성해 줘.
오류가 나면 내가 배포 화면의 'AI에게 원인 물어보기' 내용을 붙여넣을 거야. 네가 원인을 찾아 고친 뒤 같은 점검을 거친 새 전체 ZIP을 줘. 프로젝트가 대화에 없으면 기존 ZIP을 요청하고, 없는 파일을 추측해서 만들지 마.
최종 전달은 짧은 자체 점검 결과와 그대로 올릴 ZIP 하나야. 코드를 고치라는 안내로 끝내지 마. 필요한 환경변수는 답변 맨 마지막에 따로 알려 줘.

올릴 수 있는 프로젝트

프로젝트 종류와 배포 방식
종류예와 배포 방식
웹페이지HTML·CSS·JS, Vite로 만든 React·Vue필요하면 빌드해서 공개해요.
서버가 있는 앱Python(FastAPI 권장·Flask·Django·Streamlit), Node.js(Express·Next.js 등)필요한 것을 설치하고 실행해요.
  • 화면만 있으면 되는 앱은 웹페이지로 만드는 것이 가장 빠르고 안정적이에요.
  • 서버가 꼭 필요하면 가볍게 쓸 수 있는 FastAPI를 권해요.
  • 폴더 하나에 앱 하나예요. frontend/·backend/로 나뉘어 있다면 배포할 폴더 하나를 정해 올려요.
  • Dockerfile은 쓰지 않아요. Go·Java 같은 다른 언어는 아직 올릴 수 없어요.

서버가 있는 앱이라면 지킬 사항

위 프롬프트에 포함된 규칙이에요. AI가 파일을 만들 때 함께 점검해요.

  1. 접속 주소와 포트: 0.0.0.0 주소와 PORT 환경변수의 포트로 열어요. 예: uvicorn main:app --host 0.0.0.0 --port $PORT
  2. 파일은 /data 폴더에만 저장: 다시 배포하면 다른 곳의 파일은 지워져요. SQLite DB 파일도 여기에 둬요.
  3. API 키: 앱 화면의 환경변수에 저장하고 코드에서는 이름으로 불러 써요.
  4. 한동안 아무도 접속하지 않으면 잠들어요: 다음 접속 때 몇 초 만에 깨어나요. 잠든 동안에는 예약 작업이 돌지 않아요. 스터디 부스트 기간에는 잠들지 않아요.

할당 사용량

앱 개수와 크기 한도
앱 개수 (한 사람당)웹페이지 3개 · 서버가 있는 앱 1개 (참여한 프로그램 수와 상관없이)
스터디 부스트 자리 안 참여자 · 플러스웹페이지 10개 · 서버가 있는 앱 3개, 그 기간에는 서버가 있는 앱이 잠들지 않는다
한 번에 올릴 수 있는 크기100MB (압축 기준)
웹페이지 하나의 크기100MB
서버가 있는 앱메모리 256MB, 저장 공간(/data) 200MB

이용 기간

앱 종류별 이용 기간
웹페이지마지막으로 배포한 날부터 1년. 만료 30일 전부터 앱 화면의 '연장 신청'을 누르면 1년 늘어나고, 다시 배포해도 그날부터 1년이 된다
서버가 있는 앱처음 배포한 날부터 1년 쓰고 7일 쉰다. 쉬는 동안에는 서버가 있는 앱을 배포할 수 없고, 쉬기가 끝나면 앱 화면의 '다시 시작'으로 코드·데이터 그대로 1년을 더 쓴다. 중간에 지우고 새로 만들어도 끝나는 날은 같다
플러스·스터디 부스트 기간웹페이지와 서버가 있는 앱 모두 쉬지 않고 이어서 쓴다. 결제할 때마다 웹페이지 만료일이 결제일부터 1년으로 늘어난다
초대 코드로 참여한 프로그램의 앱프로그램이 끝나고 90일 뒤까지
  • 부트캠프·해커톤·수업에서 받은 초대 코드를 넣으면 서버가 있는 앱을 더 오래 쓸 수 있어요.
  • 부트캠프·해커톤·수업용 초대 코드를 발급받고 싶은 기업·기관은 paul-lab@naver.com로 메일을 보내거나 화면 오른쪽 아래 '문의하기' 채팅으로 신청하면 돼요.
  • 기간이 끝나기 전에 메일로 알려 드려요.
  • 기간이 끝나면 앱이 멈추고, 90일 안에는 코드와 데이터를 내려받을 수 있어요.
  • 스터디 부스트 기간에는 서버가 있는 앱의 ‘1년 쓰고 7일 쉬기’를 건너뛰어요. 부스트가 끝나면 무료 한도를 넘는 앱은 지우지 않고 멈춰 보관하고, 다시 부스트하면 이어져요.

쓰기 전에 알아 두세요

  • 배우고 실습하는 용도예요. 늘 켜져 있어야 하는 앱이나 중요한 데이터를 두기에 적합하지 않아요.
  • 돈을 버는 상업 서비스는 운영할 수 없어요.
  • 배포에 성공하면 앱 화면이 갤러리에 자동으로 올라가요. 화면·앱 이름·주소·제목·소개가 공개돼요. 플러스·스터디 부스트 회원은 앱마다 갤러리에 올리지 않을 수 있어요(요금제).
  • 갤러리에는 운영 중인 앱만 보여요. 앱을 멈추거나 이용 기간이 끝나면 보이지 않고, 앱을 지우면 갤러리 항목도 함께 지워져요. 만든 사람 이름 표시는 고를 수 있어요.
  • 서버 점검은 미리 알리지 않고 할 수 있어요. 점검 중에는 앱이 열리지 않거나 배포가 늦어질 수 있어요.
  • 신고가 들어온 앱은 확인하기 전이라도 바로 멈출 수 있어요. 문제가 없으면 다시 열어 드려요.

막히면

  • 배포가 실패하면 배포 화면의 AI에게 원인 물어보기 내용을 복사해 AI에 붙여넣어요. 오류 기록과 배포 규칙이 함께 복사돼요. AI가 고쳐 준 새 압축 파일로 다시 배포해요.
  • 그래도 안 되면 담당 강사에게 물어보면 돼요.
  • 피싱·불법 콘텐츠처럼 문제가 있는 앱이나 갤러리 소개·댓글은 신고하기로 알릴 수 있어요.