Chuyển đến nội dung chính

Triển khai Tiêu chuẩn

Dùng lại backend chính thức dùng chung và hoạt động ngay lập tức. Fork dự án trước, sau đó triển khai bằng một trong các phương thức dưới đây.

Yêu cầu: Node.js 20.0 trở lên, trên macOS, Windows (bao gồm WSL) hoặc Linux.

Sơ đồ triển khai tiêu chuẩn: sau khi fork, triển khai qua build cục bộ, Vercel, Cloudflare Pages hoặc Docker — tất cả đều dùng lại backend chính thức dùng chung (đăng nhập, bộ sưu tập, cộng đồng, bình luận, đồng bộ đa thiết bị)

Build Cục bộ

# cài đặt dependencies
yarn

# phát triển cục bộ
yarn start

# build: build toàn bộ 18 ngôn ngữ theo từng khối (chạy một lượt sẽ hết bộ nhớ); kết quả ở build/ — chỉ một ngôn ngữ xem --locale bên dưới
yarn build

Chỉ build một số ngôn ngữ cụ thể: dùng yarn build --locale <locale> (ví dụ: zh-Hans, en, ja… xem danh sách locale đầy đủ trong scripts/i18nLocales.mjs). Kết hợp nhiều locale: yarn build --locale zh-Hans && yarn build --locale en.

Triển khai Vercel

Nhấp nút bên dưới để triển khai một lần lên Vercel:

Vercel

Lưu ý: Gói miễn phí của Vercel có thể thất bại do giới hạn bộ nhớ. Hãy triển khai một ngôn ngữ duy nhất — vào Settings → Build & Deployment → Build Command của dự án, nhấp Override và đặt lệnh cho một ngôn ngữ (yarn build --locale zh-Hans cho tiếng Trung, yarn build --locale pt cho tiếng Bồ Đào Nha, v.v.).

Triển khai Cloudflare Pages

Trước tiên 👉 Fork dự án này, sau đó triển khai:

  1. Mở trang tạo Pages rồi chọn Connect to Git. Nếu bạn vào nhầm Create a Worker, lối vào Pages là liên kết Get started ở dưới cùng
  2. Kết nối repository bạn vừa fork
  3. Cấu hình build:
    • Build command: yarn build --locale zh-Hans (thay locale bằng ngôn ngữ bạn muốn triển khai, ví dụ: yarn build --locale pt cho tiếng Bồ Đào Nha)
    • Output directory: build
    • Environment variables: YARN_VERSION = 1.22.22
  4. Nhấp Deploy và chờ Cloudflare Pages hoàn tất build

YARN_VERSION là bắt buộc: hệ thống build v3 của Cloudflare mặc định dùng Yarn 4.9.1 và không còn suy ra phiên bản từ yarn.lock như v2 nữa. Kho này dùng lockfile v1 của Yarn Classic, nên nếu không ghim thì Yarn 4 sẽ tiếp quản. Node không cần đặt: v3 mặc định 22.16.0, đã cao hơn mức 20 mà dự án yêu cầu.

Mỗi lần push sau đó sẽ tự động kích hoạt quá trình build và deploy.

Triển khai Docker

Triển khai bằng một dòng lệnh:

# 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

Hoặc dùng docker-compose:

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