ChatGPT-WEB

注意：图中的余额指的是chatgpt中API_KEY的余额。

本项目为chatgpt私有化部署，基于fastapi vue3 chatgpt api实现。

• 笔者案例 - 我用AI帮我完成了单子

更新日志：

03-04：支持代理，环境变量HTTPS_PROXY，如HTTPS_PROXY=http://127.0.0.1:7890，如果不需要代理，可以不设置。

03-02：支持 gpt-3.5-turbo 模型

02-20：支持了API的连续对话

02-15：前端可以自定义 API_KEY ，优先级大于后端自定义的 API_KEY 。

快速开始

1. docker 部署

作者已经将 chatgpt 打包成镜像，可以直接使用 docker 部署。

docker run --name chatgpt -d -p 8000:8000 -e API_KEY=sk-xxxx miclon/chatgpt:latest

docker-compose 部署

version: '3'

services:
  chatgpt:
    image: miclon/chatgpt:latest
    container_name: chatgpt
    ports:
      - "8000:8000"
    environment:
      # 填写你的 API_KEY
      - API_KEY=sk-xxxxxx
      # 填写API请求代理地址
      - HTTPS_PROXY=http://192.168.1.17:7890

代理相关问题移步： PROXY.md

2. 本地部署

• 拉取项目，安装依赖

cd web
pnpm install
pnpm run build

cp -r web/dist api/dist
cd api
pip install -r requirements.txt

• 启动项目

# 启动前端
cd web
pnpm run dev

# 启动后端
cd api
python app.py

如果你不想动手

笔者自建了微信公众号：代码领悟，您关注后即可直接与AI对话。

公众号搭建chatGPT搭建流程图：

答疑

• 为什么需要API_KEY？

API_KEY是chatgpt的API密钥，通过API_KEY方可调用官方接口，您可以在chatgpt官网申请。API_KEY通常是sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx这种形式。

• 我想修改项目中版权信息，如何修改？

如果你不懂前端，你可以直接fork项目，替换前端字符串然后提交自己仓库，然后会自动docker构建。但是有个前提，你需要在github actions中配置DOCKER_USERNAME和DOCKER_PASSWORD，这两个变量是你的docker账号和密码。

• 为什么要内置后端？

前端其实可以直接通过axios请求chatgpt官方接口，但是为了数据安全，如果前端调用那就会暴露自己的API_KEY，所以笔者将前端和后端分离，前端只负责展示，后端负责调用chatgpt官方接口。

ChatGPT-WEB 快速上手指南

ChatGPT-WEB 是一个基于 FastAPI + Vue3 实现的 ChatGPT 私有化部署项目，支持连续对话、自定义 API Key 及代理配置。

环境准备

• 操作系统：Linux / macOS / Windows (需安装 Docker 或 Python/Node.js 环境)
• 前置依赖：
  • 方案 A (推荐)：Docker 及 Docker Compose
  • 方案 B (本地开发)：
    • Python 3.x
    • Node.js (建议 v16+)
    • pnpm (npm install -g pnpm)
• 必要凭证：OpenAI API_KEY (格式如 sk-...)

安装步骤

方案一：Docker 部署（推荐）

作者已提供构建好的镜像，只需一条命令即可启动。

1. 单容器启动

docker run --name chatgpt -d -p 8000:8000 -e API_KEY=sk-xxxx miclon/chatgpt:latest

注：将 sk-xxxx 替换为你的真实 API_KEY。如需配置代理，可追加 -e HTTPS_PROXY=http://127.0.0.1:7890。

2. Docker Compose 启动 创建 docker-compose.yml 文件：

version: '3'

services:
  chatgpt:
    image: miclon/chatgpt:latest
    container_name: chatgpt
    ports:
      - "8000:8000"
    environment:
      # 填写你的 API_KEY
      - API_KEY=sk-xxxxxx
      # 填写 API 请求代理地址 (国内访问通常需要)
      - HTTPS_PROXY=http://192.168.1.17:7890

执行启动：

docker-compose up -d

方案二：本地源码部署

1. 前端构建

cd web
pnpm install
pnpm run build
cp -r web/dist api/dist

2. 后端环境配置

cd api
pip install -r requirements.txt

3. 启动服务 分别开启两个终端窗口：

# 终端 1：启动前端
cd web
pnpm run dev

# 终端 2：启动后端
cd api
python app.py

基本使用

1. 访问界面：

   • Docker 部署：浏览器打开 http://localhost:8000
   • 本地部署：浏览器打开 http://localhost:5173 (Vite 默认端口，具体以终端输出为准)

2. 配置密钥：

   • 若启动时未通过环境变量设置 API_KEY，可在前端界面输入框旁或设置项中填入你的 sk- 开头的密钥。
   • 提示：前端输入的 API_KEY 优先级高于后端配置。

3. 开始对话：

   • 在聊天框输入问题，系统将通过后端调用 OpenAI 接口返回结果，支持多轮连续对话。