开发教程

私有化部署 ChatGPT 网页版:让同事共用 API Key 而不泄露

编辑部阅读约 6 分钟

小团队想让多人共用一枚 OpenAI API Key,又不愿把明文发到群里,常见做法是自建一层 Web 入口:Key 只存在服务端环境变量,成员凭密码访问。本文对比 ChatGPT-Next-Web、chatgpt-web、chatbot-ui 等方案,说明怎么验证 Key 是否真的没下发到前端,并给出认证、限额、反向代理与密钥轮换的部署清单。

拿到一枚 OpenAI API Key,想让工作室的几个人一起用,又不想把明文直接丢进群里——这是小团队很典型的一个中间状态:既没大到需要走企业采购,又不放心把凭据交给每个人自己保管。直接发 Key 的问题不只是“可能被转发”,还包括无法知道谁用超了额度、谁在什么时候泄露、以及出事之后怎么快速止损。

比较稳妥的思路是自建一层 Web 入口:所有人的浏览器只访问你自己的服务,请求由服务端带着 Key 转发给 OpenAI,前端从头到尾看不到 sk- 开头的字符串。下面把这个需求拆开讲清楚,再给出可落地的部署清单。

需求其实不是“共享 Key”,而是“共享一个入口”

把目标写成几条可验证的标准,选型时就不容易被功能列表带偏:

  • Key 不下发前端:浏览器发出的请求、返回的响应、页面源码里都不出现明文 Key。
  • 有访问门槛:至少一道口令,最好能对接已有的账号体系。
  • 能限流与限额:单人或整体有调用上限,避免一个人把额度跑光。
  • 可归因、可撤销:知道用量来自谁;Key 一旦怀疑泄露,能立刻吊销重建。
  • 会话不互相串:多人使用时,历史记录不能彼此可见。

最后一条经常被忽略。很多轻量项目默认把对话存在浏览器本地,看似安全,其实换一台设备就丢了;而开了服务端存储的版本,又要确认每个用户的数据是隔离的。

常见方案与适用场景

社区里被提到最多的几类,形态差别很大,先分清楚再动手:

方案 形态 访问控制 适合场景
ChatGPT-Next-Web 类项目 Next.js Web,可 Docker 或托管平台部署 内置访问口令,可关闭“用户自带 Key” 小团队最省事的起点
chatgpt-web 及其带存储的改款 Vue 前端 + Node 服务端 环境变量配置访问密钥 想自己改代码、加持久化
chatbot-ui 类项目 Next.js Web 默认无认证,需自己加一层 追求接近官方界面,愿意补安全层
原生客户端(如 iOS/macOS 上的第三方 App) 本地 App 无 个人使用;Key 存在每台设备上,不适合统一入口

需要特别说明:原生客户端不属于“私有化部署”。它把 Key 存在本地,等于让每个人各自持有一份凭据,和“统一管理”是相反的方向,只在人数极少、彼此完全信任时可用。

争议点:这类项目到底会不会把 Key 暴露给前端

讨论里出现过完全相反的两种说法:一种认为项目纯前端、Key 人人可见;另一种说自己试过,请求确实打到服务端。两种说法都可能对,因为同一个项目在不同版本、不同配置下行为不同。判断方法比听结论更可靠:

  1. 部署后打开浏览器开发者工具,切到 Network(网络)面板。
  2. 发一条消息,看请求地址。如果是同域的 /api/...,说明走的是服务端代理;如果直接打到外部 API 域名,Key 必然在前端。
  3. 在请求体、响应体和页面源码里搜索 sk-,搜不到才算过关。
  4. 检查环境变量命名:带 NEXT_PUBLIC_ 之类前缀的变量会被打包进前端,Key 绝对不能放在这类变量里。
  5. 关掉“用户自定义 Key”的入口。否则用户填自己的 Key 后会存在浏览器 localStorage 里,虽然不影响你的服务端 Key,但会让“谁在用什么 Key”变得混乱。

还要建立一个认知:即使 Key 安全地留在服务端,任何拿到访问口令的人仍然可以消耗你的额度。所以“隐藏 Key”只是第一层,第二层是访问控制和限额。

一套可落地的部署清单

1. 用容器跑起来

下面只是结构示意,具体镜像名和环境变量名请以项目官方 README 为准,版本之间会有调整:

services:
  chat:
    image: <项目官方镜像>
    ports:
      - "127.0.0.1:3000:3000"   # 只监听本机,由反向代理对外
    environment:
      - OPENAI_API_KEY=sk-xxxx  # 只存在于服务端
      - CODE=<足够长的访问口令>   # 访问密码
      - HIDE_USER_API_KEY=1     # 关闭用户自带 Key
    restart: unless-stopped

注意端口映射写成 127.0.0.1:3000:3000 而不是 3000:3000,否则容器会直接暴露在公网网卡上,绕过反向代理。

2. 反向代理与 HTTPS

用 Nginx 或 Caddy 做一层反代,只对外开放 443。这样你能在同一层统一加认证、限流、访问日志,而不用改应用代码。

3. 认证至少两层

  • 应用内访问口令:最省事,适合十人以内。
  • 反代层再加一道 Basic Auth 或接 OAuth 网关(如 oauth2-proxy、Cloudflare Access 之类的通用方案),让访问与公司账号绑定。

只挂应用内口令就上公网,风险在于口令一旦被转发出去就无法追责。

4. 限额与监控

  • 在 OpenAI 后台为这个 Key 设置用量上限,这是最后一道保险。
  • 按人发多枚 Key、按项目分组,出问题时能定位到具体使用者,也方便单独吊销。
  • 应用层或反代层加简单的频率限制,避免脚本刷额度。
  • 定期看用量曲线,发现异常时段立即轮换。

5. 机器放在哪里

如果只是内部几个人用,一台小云主机就够了。需要注意的是别把服务跑在自己的笔记本上:合盖休眠、网络切换、IP 变动都会让入口时断时续。如果希望入口长期在线、且对访问外部 API 的网络环境稳定性有要求,也可以考虑整台放在机房、远程连接的机器(例如按月租用的新加坡独享远程 Mac),把服务常驻在上面;本地 Docker 或云主机同样是合理选择,按预算和维护习惯决定即可。

几个高频踩坑点

  • 无口令实例直接挂公网:扫描器发现后几小时内就可能被刷爆额度,这是最常见的翻车方式。
  • 把 Key 写进前端配置或提交到 Git:一旦进了仓库历史,删文件也没用,只能吊销重建。
  • 多人共用同一份会话存储:历史对话互相可见,涉及内部资料时很尴尬。
  • 只发一枚 Key 给所有人:无法归因,一个人泄露等于全员重置。
  • 忘记设置用量上限:代码里循环重试的 bug 能在夜里烧掉一整天额度。

关于“账号被限制后 Key 还能不能用”

讨论里提到过两种情况,这个区分是有意义的:一种是访问网页时被拒绝(多为网络或地区层面的拦截),账号本身还正常;另一种是账号被停用,此时名下的 Key 通常也随之失效。想快速确认,用一条最小请求测一下即可:

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

返回 401 表示凭据无效,403 或其它错误则要看具体返回信息。不过要强调:如果限制是因为违反使用条款导致的,换 Key、换网络继续调用并不能解决问题,反而可能带来更大风险。正确做法是通过官方渠道申诉,具体政策以 OpenAI 官方最新说明为准;也不要去购买或共享他人账号与 Key,这类来源的凭据随时可能失效,且责任无法界定。

小结

这个需求的核心不是找一个“能聊天的界面”,而是搭一条凭据只在服务端、访问有门槛、用量可追溯的链路。选一个带服务端代理的开源项目,关掉用户自带 Key,套上反向代理和访问口令,再去后台设一个用量上限——这四步做完,小团队共用的安全性就已经超过大多数临时方案了。上线前记得用开发者工具确认一次 sk- 确实没有出现在浏览器里,这一步花的五分钟,比任何口头保证都可靠。

Docker 部署API Key 安全私有化部署访问控制开源 Web UI