## 前言
ChatGPT-Next-Web是一个开源的ChatGPT网页客户端，一键部署到自己的服务器上，界面美观、支持多模型、数据完全自控。本教程零基础手把手教你Docker部署。
## 一、前期准备
### 1.1 你需要什么
– 一台服务器或VPS（Linux推荐Ubuntu 22.04）
– OpenAI API Key或兼容的API密钥
– Docker环境
### 1.2 安装Docker
curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker
## 二、一键部署
### 2.1 基础部署
docker run -d -p 3000:3000 -e OPENAI_API_KEY=sk-你的API密钥 -e CODE=你的访问密码 –name chatgpt-next-web –restart always yidadaa/chatgpt-next-web
### 2.2 国内服务器部署（需要代理）
docker run -d -p 3000:3000 -e OPENAI_API_KEY=sk-你的API密钥 -e CODE=你的访问密码 -e PROXY_URL=http://127.0.0.1:7890 –name chatgpt-next-web –restart always yidadaa/chatgpt-next-web
### 2.3 Docker Compose部署（推荐）
创建docker-compose.yml：
version: ‘3’
services:
chatgpt-next-web:
image: yidadaa/chatgpt-next-web
container_name: chatgpt-next-web
ports:
– “3000:3000”
environment:
– OPENAI_API_KEY=sk-你的密钥
– CODE=你的访问密码
– PROXY_URL=http://代理地址:端口
restart: always
启动：docker compose up -d
## 三、访问和配置
1. 浏览器打开 http://IP:3000
2. 输入你设置的访问密码
3. 设置中可调整模型、温度等参数
4. 对话数据保存在浏览器本地
## 四、兼容其他API
ChatGPT-Next-Web支持多种API：
| API提供商 | 配置方法 |
|———–|———|
| DeepSeek | 自定义接口地址填 https://api.deepseek.com |
| 智谱AI | 自定义接口地址填 https://open.bigmodel.cn/api/paas/v4 |
| 本地Ollama | 自定义接口地址填 http://localhost:11434/v1 |
## 五、常见报错解决
| 报错 | 原因 | 解决方案 |
|——|——|———|
| 镜像拉取失败 | Docker版本过低 | 升级Docker到20以上 |
| 401认证错误 | API Key无效 | 确认Key以sk-开头且有额度 |
| 无法连接API | 国内网络限制 | 配置PROXY_URL代理 |
| 访问密码被爆破 | 密码太简单 | CODE密码至少7位，含数字和字母 |
| 容器启动后退出 | 配置错误 | docker logs chatgpt-next-web查看日志 |
| Docker Hub拉不动 | 国内网络 | 配置镜像加速器或用GHCR镜像 |
## 六、安全建议
1. 访问密码至少7位，包含数字和字母
2. 不要把API Key直接暴露在前端代码中
3. 定期更换访问密码
4. 服务器防火墙只开放必要端口
## 七、避坑总结
1. 国内服务器必须配代理，不然调不通OpenAI
2. 密码别太简单，会被扫到滥用你的API额度
3. Docker Compose部署更方便管理
4. 兼容多种API，不限于OpenAI
5. 数据存在浏览器本地，清除浏览器数据会丢失对话记录
本教程由技术保姆网原创，转载请注明出处。