NextChat (ChatGPT-Next-Web) 集成教程

NextChat 是 GitHub 上最流行的 ChatGPT Web 界面之一，支持一键部署和自定义 API。本文介绍如何配置 NextChat 使用玄州API。

配置步骤

方式一：Docker 部署（推荐）

docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx \
  -e BASE_URL=https://xuanzhouapi.top \
  -e CODE=your-access-password \
  yidadaa/chatgpt-next-web

部署完成后访问 http://localhost:3000。

方式二：Vercel 一键部署

1. Fork ChatGPT-Next-Web 仓库
2. 在 Vercel 中导入该项目
3. 设置环境变量：
   • OPENAI_API_KEY = sk-xxxxxxxxxxxxxxxxxxxxxxxx
   • BASE_URL = https://xuanzhouapi.top
   • CODE = 自定义访问密码
4. 完成部署

方式三：直接在设置中配置

如果你已有一个运行中的 NextChat 实例：

1. 点击左下角设置图标
2. 在「API Key」中输入 sk-xxxxxxxxxxxxxxxxxxxxxxxx
3. 在「接口地址」中输入 https://xuanzhouapi.top
4. 点击保存

自定义模型

NextChat 支持在设置中添加自定义模型：

1. 进入设置页面
2. 找到「自定义模型名称」
3. 输入模型名称，多个模型用英文逗号分隔：

gpt-5.5,gpt-5.5-s,claude-sonnet-4-6,claude-opus-4-7-s,deepseek-v4-pro,deepseek-v4-flash,gemini-3.5-flash,glm-5.1,kimi-k2.6

4. 保存设置后，在模型下拉框中即可看到自定义模型

环境变量说明

变量名	说明	必填
OPENAI_API_KEY	玄州API Key（sk- 开头）	是
BASE_URL	玄州API 地址	是
CODE	访问密码，保护你的服务不被他人使用	强烈推荐
DEFAULT_MODEL	默认模型	否

多功能配置

启用搜索、推理等功能（需要模型支持）：

docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx \
  -e BASE_URL=https://xuanzhouapi.top \
  -e CODE=your-password \
  -e DEFAULT_MODEL=gpt-5.5 \
  -e CUSTOM_MODELS="gpt-5.5,claude-sonnet-4-6,deepseek-v4-pro" \
  yidadaa/chatgpt-next-web

常见问题

1. 无法获取模型列表 / 404 错误

• NextChat 默认调用 /v1/models 获取模型列表
• 如果获取失败，请在「自定义模型」中手动输入模型名称
• 确认 BASE_URL 格式正确，常见写法：https://xuanzhouapi.top，如果报 404 则加上 /v1 后缀：https://xuanzhouapi.top/v1

2. 请求报错

• 检查 API Key 前缀 sk- 是否完整
• 确认账户余额充足
• 在控制台日志中查看具体错误信息

3. 部署后无法访问

• Docker 部署：确认端口映射正确 -p 3000:3000
• Vercel 部署：确认环境变量已正确设置
• 确认防火墙/安全组未拦截