ChatGPTNextWeb/NextChat · 上手攻略

  • 仓库：ChatGPTNextWeb/NextChat
  • 链接：https://github.com/ChatGPTNextWeb/NextChat
  • 分类：skill
  • 作者：Jay
  • 更新：2026-07-11

这是什么

NextChat（曾用名 ChatGPT-Next-Web）是一个轻量级跨平台 AI 助手，Stars 高达 88k，是 GitHub 上最受欢迎的 AI 对话应用之一。支持 Web、iOS、macOS、Android、Linux、Windows 全平台，核心特点是一键 Vercel 部署即可拥有自己的私有 ChatGPT 前端，同时支持 OpenAI、Claude、Gemini、DeepSeek、字节豆包、阿里通义、百度文心等数十家模型提供方，并自带 Prompt 模板（Mask）、Artifacts 预览、插件系统和团队协作功能。

⚠️ 重要更新：2024 年中起，项目团队主推商业化平台 302.ai，Web 端的官方免费部署入口已迁移至 302.ai；GitHub 源码仍公开（MIT 许可证），但部分新功能（如 iOS 客户端）未完全开源。

解决什么问题

  • 快速拥有私有 AI 前端：一行操作部署到 Vercel，不依赖 ChatGPT 官方网页，无需担心对话被审查或限流
  • 多模型统一管理：在一个界面里切换 OpenAI/Claude/Gemini/国产模型，不需要每个平台单独注册
  • Prompt 模板复用：用 Mask 功能将复杂提示词模板化，一键初始化多轮对话
  • 团队部署：管理员配置 API 资源，团队成员直接使用，无需每人单独配置
  • 数据隐私：对话存在 Vercel 绑定的浏览器本地（不经过项目服务器），可选私有部署

快速安装

方案一：Vercel 一键部署（最简，推荐）

https://vercel.com/new/clone?repository-url=https://github.com/Yidadaa/ChatGPT-Next-Web&env=OPENAI_API_KEY&env=CODE&project-name=nextchat-ai&repository-name=NextChat

点击链接后在 Vercel 填写： - OPENAI_API_KEY：你的 API Key（必填） - CODE：页面访问密码（必填，防止他人访问） - AZURE_API_KEY、ANTHROPIC_API_KEY 等：按需填写

⚠️ 若出现持续"有新版本"提示，是因为 Vercel 默认创建的是新项目而非 fork，建议先 fork 本仓库再重新部署，或手动同步上游代码。

方案二：Docker 私有部署

docker run -d \
  --name nextchat \
  -p 3000:3000 \
  -e OPENAI_API_KEY=sk-xxxx \
  -e CODE=your-password \
  yidadaa/chatgpt-next-web

访问 http://your-server:3000 即可。

方案三：桌面客户端（Tauri）

支持 Windows、macOS、Linux，从 GitHub Releases 下载对应平台的 ~5MB 安装包（约 5MB，极其轻量）。

⚠️ Tauri 桌面端使用本地 HTTP 请求获取 LLM API，相比纯 Web 版更安全（API Key 不经过浏览器扩展）。

核心用法

1. 环境变量配置（完整列表）

变量名 说明 示例
OPENAI_API_KEY OpenAI API Key（多个用逗号分隔） sk-xxx,sk-yyy
CODE 访问密码（多个用逗号分隔） pass1,pass2
OPENAI_API_BASE_URL API 代理地址 https://api.openai.com
AZURE_API_KEY / AZURE_API_VERSION Azure OpenAI —
GOOGLE_API_KEY Gemini —
ANTHROPIC_API_KEY Claude —
DEEPSEEK_API_KEY DeepSeek —
OPENAI_ORG_ID OpenAI 组织 ID —
DISABLE_GPT4 禁用 GPT-4 显示 1
ENABLE_MCP 启用 MCP 插件（需构建时开启） true
HIDE_USER_API_KEY 不允许用户自行输入 API Key 1
CUSTOM_MODELS 自定义模型列表 +llama,+claude-2,-gpt-3.5

2. Prompt 模板（Mask）

v2.0+ 支持创建 Prompt 模板：

对话中点击「+」→「Mask」→ 填写名称、图标、初始 Prompt

预设模板来源于 awesome-chatgpt-prompts-zh，开箱即用。

3. Artifacts 预览

v2.14+ 支持 Artifacts——AI 生成的代码/文档会在侧边独立窗口预览：

对话中生成 React 组件、HTML、Mermaid 图表时，右上角出现预览按钮

4. 插件系统

v2.15+ 支持插件，可扩展搜索、计算器、API 调用等：

# 需在构建时设置环境变量
ENABLE_MCP=true

插件生态见：https://github.com/ChatGPTNextWeb/NextChat-Awesome-Plugins

5. 自托管本地模型

配合 LocalAI 或 RWKV-Runner 使用，支持 llama/gpt4all/rwkv/vicuna 等开源模型，完全离线可用：

OPENAI_API_BASE_URL=http://localhost:8080/v1

典型适用场景

场景 说明
个人私有 ChatGPT 前端 不想用官方网页，有自己 API Key，直接部署
团队 AI 中台 管理员配置 API，团队成员免配置直接用
多模型对比 同一问题切换不同模型测试输出质量
Prompt 工程 用 Mask 功能批量测试不同提示词模板
企业私有化部署 私有化部署，数据不出公司网络

坑与注意

  1. Vercel 冷启动延迟：免费版 Vercel 长时间无访问后首次加载较慢（冷启动），可考虑升级或用 Docker 常驻。

  2. API Key 暴露风险：如果部署时没有设置 CODE 密码且未启用 HIDE_USER_API_KEY，任何知道 URL 的人都可以输入自己的 API Key 使用——记得配置密码。

  3. 上游同步问题：直接 Clone 而非 Fork 部署的版本，无法自动检测上游更新，需手动同步。

  4. 302.ai 商业绑定：官方推荐的免费使用入口已变为 302.ai 平台，若不愿使用第三方平台，请自行 Vercel 部署。

  5. 新模型支持有延迟：最新的 GPT-4.1、o3/o4 系列等模型可能需要 PR 合并后才能在界面上选择，可通过 CUSTOM_MODELS 环境变量强制添加。

  6. iOS 客户端未完全开源：NextChat-iOS 仓库标注"Source Code Coming Soon"，介意请使用 Web 或桌面端。

与同类对比

应用 部署难度 多模型 开源程度 插件生态 桌面端
NextChat ⭐ 一键 Vercel ✅ 30+ ⚠️ 部分开源 ✅ v2.15+ ✅ Tauri (~5MB)
Chatbox ⭐⭐ 下载即用 ✅ 主流全覆盖 ✅ GPL-3.0 ❌ ✅ Electron
LLM Studio ⭐⭐⭐ 需 GPU 以开源为主 ✅ ❌ ✅
Ollama Web UI ⭐⭐ Docker 仅 Ollama ✅ ❌ ❌

NextChat vs Chatbox：两者都支持多模型，核心区别在于部署和使用模式——NextChat 更适合有服务器/Vercel 账号、想快速建私有前端的用户；Chatbox 更适合希望数据完全本地、偏好桌面客户端的用户。NextChat 的插件生态和 Artifacts 功能是额外加分项。

一句话推荐结论

NextChat 是 GitHub 上 Star 最高的开源 AI 聊天前端，一键 Vercel 部署、30+ 模型支持、Prompt 模板和插件生态使它成为快速搭建私有 AI 助手的首选——如果你想不折腾拥有一个自己的 ChatGPT 前端，并且团队可以共享 API 资源，它是目前最成熟的开源方案；如果更看重完全本地存储和彻底开源，Chatbox 则是更彻底的替代。