본문으로 건너뛰기

Standard 배포

공식 공유 백엔드를 재사용하며 바로 사용할 수 있습니다. 먼저 프로젝트를 포크한 후 아래 방법 중 하나로 배포하세요.

시스템 요구 사항: Node.js 20.0 이상, macOS, Windows(WSL 포함), 또는 Linux.

Standard 배포 토폴로지: 포크 후 로컬 빌드, Vercel, Cloudflare Pages 또는 Docker로 배포하며, 모두 공식 공유 백엔드(로그인·즐겨찾기·커뮤니티·댓글·기기 간 동기화)를 재사용합니다

로컬 빌드

# 의존성 설치
yarn

# 로컬 개발
yarn start

# 빌드: 18개 언어를 청크로 나눠 빌드(한 번에 하면 OOM). 출력은 build/ — 한 언어만 필요하면 아래 --locale 참고
yarn build

특정 언어만 빌드하려면: yarn build --locale <locale>을 사용하세요 (예: zh-Hans, en, ja… 전체 로케일 목록은 scripts/i18nLocales.mjs를 참조). 여러 언어를 연결할 수 있습니다: yarn build --locale zh-Hans && yarn build --locale en.

Vercel 배포

아래 버튼을 클릭하여 Vercel에 원클릭 배포하세요:

Vercel

주의: Vercel 무료 플랜은 메모리 제한으로 인해 실패할 수 있습니다. 대신 단일 언어를 배포하세요 — 프로젝트의 Settings → Build & Deployment → Build Command로 이동하여 Override를 클릭하고 단일 언어 명령을 설정하세요 (중국어는 yarn build --locale zh-Hans, 포르투갈어는 yarn build --locale pt 등).

Cloudflare Pages 배포

먼저 👉 이 프로젝트 포크하기, 그런 다음 배포하세요:

  1. Pages 생성 페이지를 열고 Connect to Git을 선택합니다. Create a Worker 화면이 나오면 Pages 입구는 하단의 Get started 링크입니다
  2. 방금 포크한 저장소를 연결합니다
  3. 빌드를 구성합니다:
    • Build command: yarn build --locale zh-Hans (배포할 언어에 맞게 로케일을 변경하세요, 예: 포르투갈어는 yarn build --locale pt)
    • Output directory: build
    • Environment variables: YARN_VERSION = 1.22.22
  4. Deploy를 클릭하고 Cloudflare Pages 빌드가 완료될 때까지 기다립니다

YARN_VERSION은 생략할 수 없습니다: Cloudflare의 v3 빌드 시스템은 Yarn 4.9.1을 기본으로 쓰며, v2처럼 yarn.lock에서 버전을 추론하지 않습니다. 이 저장소는 Yarn Classic v1 lockfile이라 고정하지 않으면 Yarn 4가 처리합니다. Node는 설정할 필요가 없습니다 — v3 기본값이 22.16.0으로, 이 프로젝트가 요구하는 20 이상을 이미 충족합니다.

이후 모든 푸시는 자동으로 빌드 및 배포를 트리거합니다.

Docker 배포

원라인 배포:

# ghcr.io
docker run -d -p 3000:3000 --name chatgpt-shortcut ghcr.io/rockbenben/chatgpt-shortcut:latest

# docker hub
docker run -d -p 3000:3000 --name chatgpt-shortcut rockben/chatgpt-shortcut:latest

또는 docker-compose를 사용할 수도 있습니다:

services:
chatgpt-shortcut:
container_name: chatgpt-shortcut
image: ghcr.io/rockbenben/chatgpt-shortcut:latest
ports:
- "3000:3000"
restart: unless-stopped