用 Docker 快速搭建自己的 ChatGPT 网页版：从部署到 HTTPS 一步到位

发布人：慈云数据-客服中心发布时间：20小时前阅读量：4

ChatGPT Docker部署教程｜一键部署

随着人工智能技术的快速发展，ChatGPT 已经成为很多开发者、运营人员、内容创作者和企业团队日常工作中不可或缺的工具。相比直接使用网页版，将 ChatGPT 相关应用部署到自己的服务器上，可以获得更灵活的访问方式、更好的数据管理能力，也方便与团队内部系统、知识库、自动化流程进行集成。

本文将围绕 “ChatGPT Docker部署教程｜一键部署” 这一主题，详细介绍如何使用 Docker 快速部署一个 ChatGPT Web 应用环境。文章会从准备工作、服务器环境配置、Docker 安装、Docker Compose 一键部署、环境变量配置、反向代理、HTTPS 证书、常见问题排查以及安全建议等多个方面进行讲解，适合新手和有一定 Linux 基础的用户阅读。

说明：本文中的“ChatGPT Docker部署”通常指部署一个可调用 OpenAI API 或兼容大模型 API 的 ChatGPT Web 客户端，而不是在本地部署 OpenAI 官方 ChatGPT 服务本体。OpenAI 官方 ChatGPT 并不支持用户自行私有化部署，但可以通过 API Key 使用模型能力，并通过开源 Web UI 搭建自己的聊天界面。

一、为什么要用 Docker 部署 ChatGPT？

在正式开始之前，我们先了解一下为什么推荐使用 Docker 部署 ChatGPT 类应用。

1. 部署简单

传统部署方式通常需要安装 Node.js、pnpm、数据库、反向代理等一系列依赖，过程较为繁琐。如果服务器环境不一致，还可能出现版本冲突、依赖安装失败等问题。

而 Docker 可以将应用和依赖打包到容器中，用户只需要执行少量命令，就可以快速启动服务。

2. 环境隔离

Docker 容器之间相互隔离，不会污染宿主机环境。即使某个应用出现问题，也可以快速删除容器重新部署，不影响服务器上其他服务。

3. 方便迁移

通过 Docker Compose 文件和环境变量配置，你可以非常方便地将服务从一台服务器迁移到另一台服务器。只要新服务器安装了 Docker，就可以复用原有部署配置。

4. 便于升级和回滚

使用 Docker 镜像部署时，升级通常只需要拉取新镜像并重启容器。如果新版本存在问题，也可以回滚到旧版本镜像。

5. 适合团队内部使用

很多团队希望搭建一个统一入口，让成员通过内部域名访问 AI 聊天工具。使用 Docker 部署 ChatGPT Web UI 后，可以结合 Nginx、HTTPS、账号认证等方式，更好地进行权限管理。

二、部署前准备

在开始部署之前，你需要准备以下内容。

1. 一台服务器

推荐使用云服务器，例如：

阿里云 ECS
腾讯云 CVM
华为云 ECS
AWS EC2
Google Cloud VM
Azure VM
Vultr
DigitalOcean

服务器配置建议：

使用场景	CPU	内存	磁盘	带宽
个人使用	1核	1GB	20GB	1Mbps+
小团队使用	2核	2GB	40GB	3Mbps+
多人频繁使用	2核以上	4GB以上	60GB以上	5Mbps+

如果只是部署一个调用 API 的 Web UI，对服务器性能要求并不高，因为真正的大模型推理是在 OpenAI 或其他模型服务商那边完成的。

2. 一个域名，可选但推荐

虽然可以通过服务器 IP 加端口访问，但生产环境更推荐绑定域名，例如：

chat.example.com
ai.example.com
gpt.example.com

绑定域名后，可以配置 HTTPS，访问体验和安全性更好。

3. 一个 API Key

如果你使用 OpenAI API，需要准备 OpenAI API Key。

一般格式类似：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

如果你使用的是兼容 OpenAI API 格式的其他服务商，也需要准备相应的：

API Key
API Base URL
模型名称

例如一些兼容接口可能是：

https://api.example.com/v1

注意：API Key 非常敏感，不要公开到 GitHub、博客、截图或聊天记录中。

4. 基础 Linux 操作能力

本文以 Ubuntu 22.04 为例进行演示。CentOS、Debian 等系统也类似，只是安装命令略有区别。

三、更新服务器系统

首先通过 SSH 登录服务器。

ssh root@你的服务器IP

登录后，建议先更新软件源和系统依赖：

apt update && apt upgrade -y

安装常用工具：

apt install -y curl wget git vim unzip ca-certificates gnupg lsb-release

如果你使用的是普通用户，需要在命令前加 sudo。

四、安装 Docker

Docker 是本教程的核心。下面介绍 Ubuntu 系统下的安装方式。

1. 使用官方脚本安装 Docker

执行：

curl -fsSL https://get.docker.com | bash

安装完成后，查看 Docker 版本：

docker version

如果能正常输出 Client 和 Server 信息，说明 Docker 已经安装成功。

2. 设置 Docker 开机自启

systemctl enable docker
systemctl start docker

查看 Docker 状态：

systemctl status docker

如果看到 active running，说明 Docker 正在运行。

3. 安装 Docker Compose

现在新版 Docker 一般已经内置 Compose 插件，可以通过以下命令检查：

docker compose version

如果可以正常输出版本号，例如：

Docker Compose version v2.x.x

说明已经可用。

如果没有安装，可以执行：

apt install -y docker-compose-plugin

五、选择 ChatGPT Web 项目

目前社区中有很多开源 ChatGPT Web UI 项目，例如：

NextChat
ChatGPT Next Web
Open WebUI
LibreChat
Lobe Chat
Chatbot UI

不同项目特点不同。为了方便一键部署，本文以常见的 NextChat / ChatGPT Next Web 类项目作为示例。它通常具备以下特点：

支持 OpenAI API
支持自定义 API 地址
支持多模型
支持访问密码
支持 Docker 部署
界面简洁，适合个人和小团队使用

不同项目的镜像名称和环境变量可能略有差异，实际使用时请以对应项目官方文档为准。本文提供的是通用部署思路和常见配置方式。

六、Docker 一键部署方式

如果你希望快速运行一个 ChatGPT Web UI，可以直接使用 docker run 命令。

以下是示例命令：

docker run -d \
  --name chatgpt-web \
  --restart always \
  -p 3000:3000 \
  -e OPENAI_API_KEY="你的OpenAI_API_Key" \
  -e CODE="访问密码" \
  yidadaa/chatgpt-next-web

参数说明：

参数	说明
`-d`	后台运行容器
`--name chatgpt-web`	容器名称
`--restart always`	容器异常退出或服务器重启后自动启动
`-p 3000:3000`	将服务器 3000 端口映射到容器 3000 端口
`-e OPENAI_API_KEY`	设置 OpenAI API Key
`-e CODE`	设置访问密码
`yidadaa/chatgpt-next-web`	Docker 镜像名称

部署完成后，浏览器访问：

http://你的服务器IP:3000

如果可以打开页面，说明部署成功。

七、使用 Docker Compose 一键部署

虽然 docker run 很方便，但参数较多时不利于长期维护。更推荐使用 Docker Compose。

1. 创建项目目录

mkdir -p /opt/chatgpt-web
cd /opt/chatgpt-web

2. 创建 `docker-compose.yml`

vim docker-compose.yml

写入以下内容：

services:
  chatgpt-web:
    image: yidadaa/chatgpt-next-web:latest
    container_name: chatgpt-web
    restart: always
    ports:
      - "3000:3000"
    environment:
      OPENAI_API_KEY: "你的OpenAI_API_Key"
      CODE: "你的访问密码"
      BASE_URL: "https://api.openai.com"

保存退出。

如果你使用的是兼容 OpenAI API 的第三方接口，可以将 BASE_URL 修改为对应地址，例如：

BASE_URL: "https://api.example.com"

有些项目要求填写完整 /v1 路径，有些则不需要，具体取决于项目实现。例如：

BASE_URL: "https://api.example.com/v1"

3. 启动服务

在 /opt/chatgpt-web 目录下执行：

docker compose up -d

查看容器状态：

docker ps

查看日志：

docker logs -f chatgpt-web

如果容器正常运行，就可以访问：

http://服务器IP:3000

八、环境变量详细说明

不同 ChatGPT Web 项目支持的环境变量不同，下面列出一些常见配置项。

1. `OPENAI_API_KEY`

用于配置 OpenAI API Key。

OPENAI_API_KEY: "sk-xxxxxxxx"

如果有多个 Key，有些项目支持用逗号分隔：

OPENAI_API_KEY: "sk-xxx1,sk-xxx2"

具体是否支持，需要查看项目文档。

2. `CODE`

访问密码。建议设置复杂一些，避免被陌生人使用。

CODE: "MyStrongPassword2026"

有些项目支持多个访问密码：

CODE: "password1,password2,password3"

3. `BASE_URL`

用于配置 API 地址。

OpenAI 官方接口一般可以写：

BASE_URL: "https://api.openai.com"

第三方兼容服务可能是：

BASE_URL: "https://api.example.com/v1"

4. `OPENAI_ORG_ID`

如果你的 OpenAI 账号关联了组织 ID，可以配置：

OPENAI_ORG_ID: "org-xxxxxxxx"

普通个人用户通常不需要配置。

5. `DEFAULT_MODEL`

某些项目允许设置默认模型：

DEFAULT_MODEL: "gpt-4o-mini"

如果项目支持，你也可以设置为其他模型名称。

6. `HIDE_USER_API_KEY`

部分 Web UI 允许用户在前端填写自己的 API Key。如果你希望隐藏该功能，可以配置：

HIDE_USER_API_KEY: "1"

九、配置防火墙

如果服务器开启了防火墙，需要放行 3000 端口。

1. Ubuntu UFW

查看状态：

ufw status

放行 SSH 和 3000 端口：

ufw allow 22
ufw allow 3000
ufw enable

2. 云服务器安全组

除了系统防火墙，你还需要在云平台后台安全组中放行端口：

TCP 3000

如果后续使用 Nginx 反向代理，并通过 80/443 访问，则可以关闭公网 3000，只保留：

TCP 80
TCP 443

十、绑定域名访问

假设你的域名是：

chat.example.com

你需要到域名 DNS 解析后台添加一条 A 记录：

类型	主机记录	记录值
A	chat	服务器公网 IP

等待 DNS 生效后，可以通过以下命令测试：

ping chat.example.com

如果解析到了服务器 IP，说明域名配置成功。

十一、使用 Nginx 反向代理

直接暴露 3000 端口并不是最佳实践。更推荐使用 Nginx 将域名代理到容器服务。

1. 安装 Nginx

apt install -y nginx

启动并设置开机自启：

systemctl enable nginx
systemctl start nginx

2. 创建站点配置

vim /etc/nginx/conf.d/chatgpt.conf

写入：

server {
    listen 80;
    server_name chat.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}

将 chat.example.com 替换为你的真实域名。

3. 检查 Nginx 配置

nginx -t

如果显示：

syntax is ok
test is successful

说明配置正确。

重载 Nginx：

systemctl reload nginx

此时访问：

http://chat.example.com

即可进入 ChatGPT Web 页面。

十二、配置 HTTPS 证书

为了安全，强烈建议配置 HTTPS。这里使用 Certbot 免费申请 Let’s Encrypt 证书。

1. 安装 Certbot

apt install -y certbot python3-certbot-nginx

2. 申请证书

certbot --nginx -d chat.example.com

根据提示输入邮箱、同意协议并选择是否自动跳转 HTTPS。

申请成功后，访问：

https://chat.example.com

3. 测试证书自动续期

Let’s Encrypt 证书有效期通常为 90 天，Certbot 会自动配置续期任务。可以测试：

certbot renew --dry-run

如果没有报错，说明自动续期正常。

十三、优化 Docker Compose 配置

为了更安全，我们可以将 Web UI 只监听本地地址，不直接暴露到公网。

修改 docker-compose.yml：

services:
  chatgpt-web:
    image: yidadaa/chatgpt-next-web:latest
    container_name: chatgpt-web
    restart: always
    ports:
      - "127.0.0.1:3000:3000"
    environment:
      OPENAI_API_KEY: "你的OpenAI_API_Key"
      CODE: "你的访问密码"
      BASE_URL: "https://api.openai.com"

这样外部用户无法直接通过：

http://服务器IP:3000

访问，只能通过 Nginx 代理访问，更加安全。

修改后重启：

docker compose down
docker compose up -d

十四、如何升级 ChatGPT Web 容器

如果你使用的是 latest 镜像，可以通过以下方式升级。

进入项目目录：

cd /opt/chatgpt-web

拉取最新镜像：

docker compose pull

重启容器：

docker compose up -d

清理旧镜像：

docker image prune -f

查看当前运行状态：

docker ps

如果升级后出现问题，可以指定旧版本镜像回滚。例如将：

image: yidadaa/chatgpt-next-web:latest

改为：

image: yidadaa/chatgpt-next-web:v2.15.8

然后重新启动。

十五、如何停止和删除服务

停止服务：

cd /opt/chatgpt-web
docker compose stop

重新启动：

docker compose start

彻底删除容器：

docker compose down

如果还想删除镜像：

docker rmi yidadaa/chatgpt-next-web:latest

注意：删除容器通常不会影响 docker-compose.yml 文件，但如果项目使用了挂载目录或数据库卷，删除前请确认是否需要备份。

十六、常见问题排查

1. 浏览器无法访问页面

可以按照以下顺序排查：

第一，检查容器是否运行：

docker ps

第二，检查日志：

docker logs -f chatgpt-web

第三，检查端口是否监听：

ss -tulnp | grep 3000

第四，检查服务器防火墙和云安全组是否放行端口。

第五，如果使用 Nginx，检查配置是否正确：

nginx -t
systemctl status nginx

2. 页面可以打开，但无法对话

常见原因包括：

API Key 填写错误
API Key 已失效
账户余额不足
API Base URL 配置错误
模型名称不支持
服务器无法访问 API 服务
项目环境变量名称写错

可以在服务器上测试 API 连通性：

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer 你的OpenAI_API_Key"

如果返回模型列表或相关 JSON 信息，说明接口可以访问。

3. 出现 401 Unauthorized

通常表示认证失败，可能是：

API Key 错误
Key 前后有空格
Key 被撤销
使用了错误的服务商接口
Header 格式不符合要求

建议重新生成 API Key 并更新 docker-compose.yml。

更新后执行：

docker compose down
docker compose up -d

4. 出现 429 Too Many Requests

这通常表示请求过多或达到限额，可能原因：

API 额度不足
频率限制
多人共享同一个 Key
账户风控限制

可以尝试：

降低请求频率
更换模型
增加账户额度
使用多个 API Key
给团队成员设置访问限制

5. Nginx 502 Bad Gateway

常见原因：

容器没有启动
代理端口写错
容器只监听了其他端口
服务启动较慢
Docker 网络异常

检查容器：

docker ps
docker logs chatgpt-web

检查本地访问：

curl http://127.0.0.1:3000

如果本地无法访问，问题在容器；如果本地可以访问，但域名 502，问题多半在 Nginx 配置。

十七、安全建议

ChatGPT Web 部署完成后，不建议直接裸奔到公网。以下安全措施非常重要。

1. 必须设置访问密码

不要让任何人都能使用你的 API Key，否则可能产生高额费用。

CODE: "足够复杂的访问密码"

密码建议包含：

大写字母
小写字母
数字
特殊符号
至少 12 位以上

2. 不要公开 API Key

不要把 API Key 写在公开仓库、博客截图、群聊消息中。一旦泄露，应立即删除旧 Key 并生成新的 Key。

3. 使用 HTTPS

HTTP 明文传输存在被窃听风险，尤其是访问密码和聊天内容。生产环境必须配置 HTTPS。

4. 限制访问来源

如果仅供公司内部使用，可以考虑：

Nginx Basic Auth
IP 白名单
VPN
Cloudflare Access
Zero Trust 访问控制

例如 Nginx IP 白名单：

location / {
    allow 1.2.3.4;
    deny all;

    proxy_pass http://127.0.0.1:3000;
}

5. 定期查看账单

如果使用 OpenAI 或其他商业模型 API，建议定期查看用量和账单，设置消费上限，避免异常调用造成费用损失。

十八、推荐的一键部署完整配置

下面给出一个相对完整、适合生产环境的 docker-compose.yml 示例。

services:
  chatgpt-web:
    image: yidadaa/chatgpt-next-web:latest
    container_name: chatgpt-web
    restart: always
    ports:
      - "127.0.0.1:3000:3000"
    environment:
      OPENAI_API_KEY: "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
      CODE: "YourStrongPassword2026"
      BASE_URL: "https://api.openai.com"
      DEFAULT_MODEL: "gpt-4o-mini"

启动命令：

cd /opt/chatgpt-web
docker compose up -d

Nginx 配置示例：

server {
    listen 80;
    server_name chat.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}

申请 HTTPS：

certbot --nginx -d chat.example.com

十九、Docker 部署流程总结

整个 ChatGPT Docker 一键部署流程可以概括为以下几步：

准备一台 Linux 服务器；
安装 Docker 和 Docker Compose；
获取 OpenAI API Key 或兼容 API Key；
创建 /opt/chatgpt-web 项目目录；
编写 docker-compose.yml；
执行 docker compose up -d 启动容器；
通过服务器 IP 和端口测试访问；
绑定域名；
使用 Nginx 反向代理；
使用 Certbot 配置 HTTPS；
设置访问密码和安全策略；
定期升级镜像并查看日志。

对于个人用户来说，最快只需要几分钟就能完成基础部署。对于团队或企业来说，建议在基础部署之外增加身份认证、访问控制、日志审计和费用监控。

二十、结语

通过本文的介绍，你应该已经掌握了如何使用 Docker 一键部署 ChatGPT Web 应用。Docker 的优势在于部署简单、环境独立、升级方便，非常适合快速搭建个人或团队 AI 助手平台。

需要再次强调的是，本文所说的 ChatGPT Docker 部署，核心是部署一个可以调用 OpenAI API 或兼容模型 API 的 Web 前端服务，而不是私有化部署 OpenAI 官方 ChatGPT 模型。如果你的需求是企业内部知识库问答、私有数据检索、权限控制、多用户管理等，可以在此基础上进一步集成向量数据库、RAG 系统、企业登录认证和后台管理系统。

对于大多数用户而言，使用 Docker Compose 加 Nginx 加 HTTPS 的组合，已经可以满足稳定、安全、易维护的部署需求。只要妥善保管 API Key、设置访问密码，并定期检查服务日志和账单，就可以长期稳定地使用自己的 ChatGPT Web 服务。

文章标签： ChatGPTDocker部署 DockerCompose Nginx反向代理 HTTPS证书

上一篇：从零跑通 ChatGPT API：新手也能照着做的接口调用指南

下一篇：生产环境跑稳 ChatGPT Web：Docker Compose + Nginx + HTTPS 部署实战

更多栏目

新闻动态

文档中心

下载中心

目录结构

全文

产品与服务

新闻帮助

生态合作

了解我们