每周一个开源项目 #4：ChatGPT-Next-Web 增强版

🚀 一句话看懂项目：ChatGPT-Next-Web 增强版是近期GitHub最火的AI聊天前端项目，基于原版升级优化，支持多模型切换、自定义主题、离线对话缓存，无需复杂部署，新手5分钟即可搭建属于自己的AI聊天界面，兼顾颜值与实用性，星标一周暴涨20k+。

💬 项目核心简介

ChatGPT-Next-Web 增强版是一款轻量高效、可高度定制的AI聊天前端框架，核心基于React+TypeScript开发，适配OpenAI、智谱、百度文心一言等主流大模型，解决了原版功能单一、部署繁琐、适配性差的痛点，新增离线缓存、多账号管理、主题定制等实用功能。

项目定位为"人人可用的AI聊天工具前端"，无需深厚的前端开发基础，普通人可通过一键部署快速搭建，开发者可基于源码二次开发，适配自己的业务需求，目前已成为GitHub近一周前端领域星标增长最快的开源项目，广泛应用于个人AI助手、企业内部聊天工具搭建等场景。

项目GitHub地址：https://github.com/Yidadaa/ChatGPT-Next-Web

官方文档：https://chatgpt-next-web.js.org/docs/getting-started

🔍 核心功能与适用场景

核心能力

多模型无缝切换：支持OpenAI、智谱GLM、百度文心一言、阿里通义千问等10+主流大模型，一键切换无需重启服务
高度自定义配置：支持自定义主题颜色、聊天背景、字体大小，可添加自定义Prompt、设置对话记忆长度
离线缓存与备份：对话记录本地缓存，支持导出Markdown/PDF，断网也能查看历史对话，防止数据丢失
多账号管理：支持添加多个大模型API Key，按需切换账号，适配不同场景下的使用需求
轻量高效：打包后体积不足10MB，加载速度快，支持PC/手机端自适应，适配各种设备
扩展功能丰富：支持插件扩展、自定义快捷键、对话翻译、代码高亮等实用功能，可按需开启

适用人群

想拥有个人AI聊天界面，不想依赖第三方平台的普通用户
前端开发者，需要快速搭建AI聊天前端框架，进行二次开发
企业员工，需要搭建内部AI聊天工具，适配企业专属大模型
AI爱好者，喜欢尝试各类开源AI工具，追求个性化使用体验

🛠️ 本地部署教程（三种方案，新手首选一键部署）

基础环境要求

系统：Windows 10+/macOS 12+/Linux（Ubuntu 20.04及以上）
硬件：CPU≥1核、内存≥2GB、磁盘剩余空间≥50MB（轻量化部署，无过高硬件要求）
基础依赖：Node.js ≥ 18版本（一键部署可自动安装，无需手动配置）
可选配置：任意大模型API Key（无API Key也可体验离线缓存功能）

方案一：一键安装（新手首选，5分钟上手）

Windows系统（PowerShell运行）

powershell 复制代码

# 克隆项目仓库（无需手动下载源码）
git clone https://github.com/Yidadaa/ChatGPT-Next-Web.git
cd ChatGPT-Next-Web

# 一键安装依赖并启动
npm run setup
npm run start

启动成功后，浏览器访问 http://localhost:3000 即可进入聊天界面，首次打开需配置API Key（可选）。

macOS/Linux系统（终端运行）

bash 复制代码

# 克隆项目
git clone https://github.com/Yidadaa/ChatGPT-Next-Web.git
cd ChatGPT-Next-Web

# 一键部署启动
bash <(curl -s https://raw.githubusercontent.com/Yidadaa/ChatGPT-Next-Web/main/scripts/setup.sh)

启动后访问 http://localhost:3000，默认自带演示模式，无需API Key即可体验基础功能。

方案二：Docker容器部署（稳定隔离，推荐服务器使用）

bash 复制代码

# 拉取最新镜像
docker pull yidadaa/chatgpt-next-web

# 启动容器（映射端口3000，可自定义）
docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=your-api-key \
  -e CODE=your-access-code \
  yidadaa/chatgpt-next-web

参数说明：OPENAI_API_KEY 填写你的大模型API Key，CODE 是访问密码，可自定义设置，防止他人滥用。

方案三：静态页面部署（无需后端，仅前端展示）

bash 复制代码

# 克隆项目
git clone https://github.com/Yidadaa/ChatGPT-Next-Web.git
cd ChatGPT-Next-Web

# 打包静态文件
npm run build

# 启动静态服务器（需安装serve）
npm install -g serve
serve -s out -l 3000

静态部署仅支持离线缓存、主题定制等基础功能，无法调用大模型API，适合仅需展示界面的场景。

⚙️ 核心配置文件详解

项目核心配置文件为 .env.local，修改该文件可适配自身需求，核心配置项如下（复制即可使用）：

yaml 复制代码

# 大模型配置（示例：OpenAI）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://api.openai.com/v1

# 访问权限配置
CODE=123456 # 访问密码，可自定义，留空则无需密码
DISABLE_GPT4=false # 是否禁用GPT-4，true为禁用，false为启用

# 界面配置
THEME=light # 主题，可选light（浅色）、dark（深色）、auto（自动切换）
DEFAULT_MODEL=gpt-3.5-turbo # 默认使用的模型
MAX_HISTORY=100 # 最大对话记忆长度

# 缓存配置
CACHE_TYPE=local # 缓存类型，local为本地缓存，redis为Redis缓存（需配置Redis）

📌 实战常用操作（直接复制使用）

场景1：自定义主题颜色

操作：进入聊天界面 → 点击右上角设置 → 选择"主题设置" → 输入自定义颜色值（如#1677ff） → 点击保存，立即生效。

场景2：导出对话记录

操作：打开需要导出的对话 → 点击对话右上角"更多" → 选择"导出为Markdown"或"导出为PDF" → 保存至本地即可。

场景3：切换大模型

操作：点击聊天输入框上方"模型"下拉框 → 选择需要使用的模型（如智谱GLM-4、文心一言） → 若未配置对应API Key，点击"配置"填写 → 切换完成后即可使用该模型聊天。

⚠️ 新手避坑注意事项

部署失败优先检查Node.js版本，必须升级至18及以上，可使用nvm管理版本（npm install -g nvm）
启动后无法访问，检查端口是否被占用，可修改端口：npm run start -- --port 3001
调用大模型失败，核对API Key是否正确、是否有余额，国内用户需配置代理（修改BASE_URL）
离线缓存无法使用，清除浏览器缓存，重启服务后重新生成对话记录
Docker部署后无法保存配置，需添加数据卷映射：-v ./data:/app/data

✨ 项目核心亮点

零门槛部署：一键安装脚本，新手无需配置环境，5分钟即可搭建完成
高度可定制：主题、Prompt、模型、快捷键均可自定义，适配不同使用习惯
跨平台适配：PC/手机端自适应，支持浏览器直接访问，无需安装额外软件
轻量高效：打包体积小，加载速度快，低配置设备也能流畅运行
社区活跃：一周星标增长20k+，开发者响应及时，插件扩展丰富，持续更新优化

✅ 上手建议

新手优先选择一键部署，无需配置复杂环境，先体验基础聊天、主题定制功能，熟悉后再配置API Key调用大模型；前端开发者可基于源码修改界面样式、添加自定义插件，适配自己的业务场景。

作为近期GitHub最火的AI前端项目，ChatGPT-Next-Web 增强版完美解决了普通用户"搭建难、定制难"的痛点，不管是个人使用还是二次开发，都是极具性价比的开源选择，值得入手尝试。