README_KO.md 18 KB
NextChat
영어 / [简体中文](./README_CN.md)
](https://zeabur.com/templates/ZBUEFA) [
](https://gitpod.io/#https://github.com/ChatGPTNextWeb/NextChat)
[❤️ AI API 후원사
302.AI는 사용한 만큼만 비용을 지불하는 AI 애플리케이션 플랫폼으로, 다양한 AI API 및 온라인 애플리케이션을 제공합니다.
🥳 NextChat iOS 버전 출시!
👉 지금 설치하기
🫣 NextChat, MCP 지원!
빌드 전 환경 변수(env)
ENABLE_MCP=true설정 필요
엔터프라이즈 버전
회사 내부 시스템에 맞춘 프라이빗 배포 및 맞춤형 커스터마이징 지원:
- 브랜드 커스터마이징: 기업 이미지에 맞는 UI/UX 테마 적용
- 리소스 통합 관리: 다양한 AI 모델을 통합하여 팀원이 손쉽게 사용 가능
- 권한 제어: 관리자 패널을 통한 멤버·리소스·지식 베이스 권한 설정
- 지식 통합: 사내 문서 및 데이터와 AI를 결합한 맞춤형 답변 제공
- 보안 감사: 민감한 질문 차단 및 모든 기록 추적 가능
- 프라이빗 배포 지원: 주요 클라우드 서비스에 맞춘 배포 옵션
- 지속적 업데이트: 멀티모달 등 최신 AI 기능 지속 반영
엔터프라이즈 문의: business@nextchat.dev
🖼️ 스크린샷
주요 기능 소개
- Vercel에서 원클릭 무료 배포 (1분 내 완성)
- 모든 OS(Linux/Windows/MacOS)에서 사용 가능한 클라이언트 (~5MB) 지금 다운 받기
- 자체 LLM 서버와 완벽 호환. RWKV-Runner 또는 LocalAI와 함께 사용하는 것을 추천
- 개인 정보 보호: 모든 대화 기록은 브라우저에만 저장
- Markdown 지원: LaTex, Mermaid, 코드 하이라이팅 등
- 반응형 디자인, 다크 모드, PWA 지원
- 빠른 초기 로딩 속도 (~100kb), 스트리밍 응답
- 프롬프트 템플릿 생성/공유/디버깅 지원 (v2)
- v2: 프롬프트 템플릿 기반 도구 생성, 공유, 디버깅 가능
- 고급 프롬프트 내장 awesome-chatgpt-prompts-zh and awesome-chatgpt-prompts
- 긴 대화 내용 자동 압축 저장으로 토큰 절약
- I18n: English, 简体中文, 繁体中文, 日本語, Français, Español, Italiano, Türkçe, Deutsch, Tiếng Việt, Русский, Čeština, 한국어, Indonesia
개발 로드맵
- 시스템 프롬프트: 사용자가 정의한 프롬프트를 시스템 프롬프트로 고정하기 #138
- 사용자 프롬프트: 사용자 정의 프롬프트를 편집 및 저장하여 리스트로 관리 가능
- 프롬프트 템플릿: 사전 정의된 인컨텍스트 프롬프트로 새 채팅 생성 #993
- 이미지로 공유하거나 ShareGPT로 공유 #1741
- Tauri 기반 데스크톱 앱
- 자체 모델 호스팅: RWKV-Runner, LocalAI 등 서버 배포 모델들과 완벽 호환 (llama, gpt4all, rwkv, vicuna, koala, gpt4all-j, cerebras, falcon, dolly 등)
- 아티팩트: 생성된 콘텐츠 및 웹페이지를 별도 창으로 미리보기, 복사, 공유 가능 #5092
- 플러그인: 웹 검색, 계산기, 기타 외부 API 기능 지원 #165 #5353
- 실시간 채팅 지원 #5672
- 로컬 지식 베이스 지원 예정
🚀 최근 업데이트
- 🚀 v2.15.8 실시간 채팅 지원 #5672
- 🚀 v2.15.4 Tauri 기반 LLM API 호출 기능 추가 → 보안 강화 #5379
- 🚀 v2.15.0 플러그인 기능 추가 → NextChat-Awesome-Plugins
- 🚀 v2.14.0 아티팩트 및 Stable Diffusion 기능 추가
- 🚀 v2.10.1 Google Gemini Pro 모델 지원
- 🚀 v2.9.11 Azure Endpoint 사용 가능
- 🚀 v2.8 모든 플랫폼에서 실행 가능한 클라이언트 출시
- 🚀 v2.7 대화 내용을 이미지로, 또는 ShareGPT로 공유 가능
- 🚀 v2.0 릴리즈: 프롬프트 템플릿 생성 및 아이디어 구현 가능! → ChatGPT Prompt Engineering Tips
시작하기
- OpenAI API 키를 발급받습니다.
버튼을 클릭해 Vercel에 배포합니다.
CODE는 페이지 비밀번호라는 점을 기억하세요.Enjoy :)
FAQ
최신 상태 유지 (Keep Updated)
Vercel로 배포한 경우, "Updates Available" 메시지가 계속 나타날 수 있습니다. 이는 프로젝트를 포크하지 않고 새로 생성했기 때문입니다.
다음 절차에 따라 다시 배포를 권장합니다:
- 기존 레포 삭제
- 우측 상단 "Fork" 버튼 클릭 → 포크 생성
- 포크된 프로젝트를 다시 Vercel에 배포
→ 자세한 튜토리얼 보기
자동 업데이트 활성화 (Enable Automatic Updates)
Upstream Sync 오류 발생 시, 수동으로 코드 업데이트하세요.
프로젝트 포크 후에는 GitHub의 제약으로 인해 Actions 페이지에서 아래 항목들을 수동으로 활성화해야 합니다:
WorkflowsUpstream Sync Action
이후 매 시간 자동으로 업데이트됩니다:
수동 업데이트 방법 (Manually Updating Code)
즉시 업데이트가 필요한 경우, 깃헙 문서를 참고해 포크된 프로젝트를 upstream code와 동기화하세요.
릴리스 알림을 원하시면 star 또는 watch를 눌러주세요.
접근 비밀번호 설정 (Access Password)
이 프로젝트는 제한된 접근 제어를 제공합니다.
Vercel 환경 변수에 CODE를 다음 형식으로 추가하세요. value는 ,를 통해 구분된 비밀번호여야 합니다.:
code1,code2,code3
수정 후 반드시 다시 배포해야 적용됩니다.
환경 변수 (Environment Variables)
CODE (선택 사항)
접속 비밀번호. 쉼표로 구분합니다.
OPENAI_API_KEY (필수)
당신의 OpenAI API 키, 여러 개를 사용하려면 쉼표로 연결합니다.
BASE_URL (선택 사항)
기본값:
https://api.openai.com예시:
http://your-openai-proxy.com
OpenAI API 요청의 기본 URL을 재정의합니다.
OPENAI_ORG_ID (선택 사항)
OpenAI organization ID를 지정합니다.
AZURE_URL (선택 사항)
예시: https://{azure-resource-url}/openai
Azure 배포 URL입니다.
AZURE_API_KEY (선택 사항)
Azure API 키입니다.
AZURE_API_VERSION (선택 사항)
Azure API 버전입니다. Azure 문서에서 확인할 수 있습니다.
GOOGLE_API_KEY (선택 사항)
Google Gemini Pro API 키입니다.
GOOGLE_URL (선택 사항)
Google Gemini Pro API URL입니다.
ANTHROPIC_API_KEY (선택 사항)
Anthropic Claude API 키입니다.
ANTHROPIC_API_VERSION (선택 사항)
Anthropic Claude API 버전입니다.
ANTHROPIC_URL (선택 사항)
Anthropic Claude API URL입니다.
BAIDU_API_KEY (선택 사항)
Baidu API 키입니다.
BAIDU_SECRET_KEY (선택 사항)
Baidu Secret 키입니다.
BAIDU_URL (선택 사항)
Baidu API URL입니다.
BYTEDANCE_API_KEY (선택 사항)
ByteDance API 키입니다.
BYTEDANCE_URL (선택 사항)
ByteDance API URL입니다.
ALIBABA_API_KEY (선택 사항)
Alibaba Cloud API 키입니다.
ALIBABA_URL (선택 사항)
Alibaba Cloud API URL입니다.
IFLYTEK_URL (선택 사항)
iflytek API URL입니다.
IFLYTEK_API_KEY (선택 사항)
iflytek API 키입니다.
IFLYTEK_API_SECRET (선택 사항)
iflytek API 시크릿입니다.
CHATGLM_API_KEY (선택 사항)
ChatGLM API 키입니다.
CHATGLM_URL (선택 사항)
ChatGLM API URL입니다.
DEEPSEEK_API_KEY (선택 사항)
DeepSeek API 키입니다.
DEEPSEEK_URL (선택 사항)
DeepSeek API URL입니다.
HIDE_USER_API_KEY (선택 사항)
기본값: 비어 있음
사용자가 자신의 API 키를 입력하지 못하게 하려면 이 값을 1로 설정하세요.
DISABLE_GPT4 (선택 사항)
기본값: 비어 있음
사용자가 GPT-4를 사용하지 못하게 하려면 이 값을 1로 설정하세요.
ENABLE_BALANCE_QUERY (선택 사항)
기본값: 비어 있음
사용자가 쿼리 잔액을 조회할 수 있도록 하려면 이 값을 1로 설정하세요.
DISABLE_FAST_LINK (선택 사항)
기본값: 비어 있음
URL에서 설정을 파싱하는 기능을 비활성화하려면 이 값을 1로 설정하세요.
CUSTOM_MODELS (선택 사항)
기본값: 비어 있음
예시:+llama,+claude-2,-gpt-3.5-turbo,gpt-4-1106-preview=gpt-4-turbo
이는llama,claude-2를 모델 리스트에 추가하고,gpt-3.5-turbo를 제거하며,gpt-4-1106-preview를gpt-4-turbo로 표시합니다.
사용자 지정 모델 제어 시 +는 추가, -는 제거, 이름=표시이름은 모델명 커스터마이징을 의미합니다. 쉼표로 구분하세요.
-all은 기본 모델을 모두 비활성화+all은 기본 모델을 모두 활성화
Azure 용법 예시: modelName@Azure=deploymentName → 배포 이름을 커스터마이징 가능
예시:
+gpt-3.5-turbo@Azure=gpt35→ 리스트에gpt35(Azure)표시됨
Azure 모델만 사용할 경우:-all,+gpt-3.5-turbo@Azure=gpt35
ByteDance 용법 예시: modelName@bytedance=deploymentName
예시:
+Doubao-lite-4k@bytedance=ep-xxxxx-xxx→Doubao-lite-4k(ByteDance)로 표시됨
DEFAULT_MODEL (선택 사항)
기본 모델을 변경합니다.
VISION_MODELS (선택 사항)
기본값: 비어 있음
예시:gpt-4-vision,claude-3-opus,my-custom-model
위의 모델들에 시각 기능을 부여합니다 (기본적으로"vision","claude-3","gemini-1.5"키워드를 포함한 모델은 자동 인식됨). 기본 모델 외에도 모델을 추가할 수 있습니다. 쉼표로 구분하세요.
WHITE_WEBDAV_ENDPOINTS (선택 사항)
접속 허용할 WebDAV 서비스 주소를 늘리고자 할 때 사용합니다.
- 각 주소는 완전한 endpoint 여야 함:
https://xxxx/yyy - 여러 주소는
,로 구분
DEFAULT_INPUT_TEMPLATE (선택 사항)
설정 메뉴의 사용자 입력 전처리 구성 항목 초기화 시 사용할 기본 템플릿을 설정합니다.
STABILITY_API_KEY (선택 사항)
Stability API 키입니다.
STABILITY_URL (선택 사항)
Stability API URL을 커스터마이징합니다.
ENABLE_MCP (선택 사항)
MCP (Model Context Protocol) 기능을 활성화합니다.
SILICONFLOW_API_KEY (선택 사항)
SiliconFlow API 키입니다.
SILICONFLOW_URL (선택 사항)
SiliconFlow API URL입니다.
AI302_API_KEY (선택 사항)
302.AI API 키입니다.
AI302_URL (선택 사항)
302.AI API URL입니다.
요구 사항 (Requirements)
NodeJS >= 18, Docker >= 20
개발 (Development)
개발을 시작하기 전에 프로젝트 루트에 .env.local 파일을 만들고, 아래와 같이 API 키를 입력하세요:
OPENAI_API_KEY=<여기에 API 키 입력>
# OpenAI 서비스를 사용할 수 없는 경우 아래 BASE_URL 사용
BASE_URL=https://chatgpt1.nextweb.fun/api/proxy
로컬 개발 실행
# 1. Node.js와 Yarn을 먼저 설치
# 2. `.env.local` 파일에 환경 변수 설정
# 3. 실행
yarn install
yarn dev
배포 (Deployment)
Docker (권장)
docker pull yidadaa/chatgpt-next-web
docker run -d -p 3000:3000 \
-e OPENAI_API_KEY=sk-xxxx \
-e CODE=your-password \
yidadaa/chatgpt-next-web
서비스에 프록시를 사용하려면:
docker run -d -p 3000:3000 \
-e OPENAI_API_KEY=sk-xxxx \
-e CODE=your-password \
-e PROXY_URL=http://localhost:7890 \
yidadaa/chatgpt-next-web
프록시에 인증이 필요한 경우:
-e PROXY_URL="http://127.0.0.1:7890 user pass"
MCP를 활성화하려면:
docker run -d -p 3000:3000 \
-e OPENAI_API_KEY=sk-xxxx \
-e CODE=your-password \
-e ENABLE_MCP=true \
yidadaa/chatgpt-next-web
로컬 배포
콘솔에서 다음 명령을 실행하세요.
bash <(curl -s https://raw.githubusercontent.com/Yidadaa/ChatGPT-Next-Web/main/scripts/setup.sh)
⚠️ 참고: 설치 중에 문제가 발생하면 Docker 배포를 사용하세요.
채팅 기록 동기화 (UpStash)
| 简体中文 | English | Italiano | 日本語 | 한국어
문서 (Documentation)
더 많은 문서는 docs 디렉토리를 참고하세요.
번역 (Translation)
새로운 번역을 추가하고 싶다면, 이 문서를 읽어보세요.
후원 (Donation)
특별 감사 (Special Thanks)
기여자 (Contributors)