chatgpt-web

环境要求

• Node 与 PNPM（本地源码运行/打包时需要）
• Docker（使用镜像方式部署）
• OpenAI API Key（OPENAI_API_KEY 必填）
• MongoDB（登录、同步历史会话等功能需要 MONGODB_URL）

安装与启动步骤

1. 1克隆项目代码

   先从 GitHub 拉取 chatgpt-web 源码，之后的 Docker 构建和本地运行都在该目录中进行。

   git clone https://github.com/chatgpt-web-dev/chatgpt-web.git

   复制

2. 2构建 Docker 镜像

   进入项目目录，用 Git 提交哈希和当前分支名作为构建参数，生成 chatgpt-web 镜像。

   GIT_COMMIT_HASH=`git rev-parse HEAD`
   RELEASE_VERSION=`git branch --show-current`
   docker build --build-arg GIT_COMMIT_HASH=${GIT_COMMIT_HASH} --build-arg RELEASE_VERSION=${RELEASE_VERSION} -t chatgpt-web .

   复制

3. 3前台运行容器

   映射 3002 端口并注入 OPENAI_API_KEY、MONGODB_URL，前台运行便于查看启动日志。

   docker run --name chatgpt-web --rm -it -p 3002:3002 --env OPENAI_API_KEY=your_api_key --env MONGODB_URL=your_mongodb_url chatgpt-web

   复制

4. 4后台运行容器

   加 -d 后台常驻，端口仅绑定本机 127.0.0.1:3002，更适合长期运行。

   docker run --name chatgpt-web -d -p 127.0.0.1:3002:3002 --env OPENAI_API_KEY=your_api_key --env MONGODB_URL=your_mongodb_url chatgpt-web

   复制

5. 5Compose 编排部署

   按 README 示例写好 docker-compose.yml（app 用 chatgptweb/chatgpt-web 镜像，另起 mongo 服务），再启动。

   docker compose up -d

   复制

6. 6本地源码运行

   不用容器时先 pnpm install 安装依赖，再执行 pnpm prod 运行；不打包可直接 pnpm start。

   pnpm install
   pnpm prod

   复制

关键配置

如何确认成功

浏览器访问 http://localhost:3002/ ，能正常打开 ChatGPT Web 页面即表示启动成功。

常见问题

注意事项

• OPENAI_API_KEY 为必填项，缺失会导致服务不可用。
• 此项目 Fork 自 Chanzhaoyu/chatgpt-web，仅发布于 GitHub，基于 MIT 协议免费开源，谨防各类卖号与付费服务骗局。
• 使用 Railway 部署时，修改环境变量会触发重新 Deploy。
• 注册功能需先开启（REGISTER_ENABLED），注册出管理员后可在管理员页面继续配置，也可后续关闭注册。