私有化部署 ChatGPT 网页版:让同事共用 API Key 而不泄露
小团队想让多人共用一枚 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 人人可见;另一种说自己试过,请求确实打到服务端。两种说法都可能对,因为同一个项目在不同版本、不同配置下行为不同。判断方法比听结论更可靠:
- 部署后打开浏览器开发者工具,切到 Network(网络)面板。
- 发一条消息,看请求地址。如果是同域的
/api/...,说明走的是服务端代理;如果直接打到外部 API 域名,Key 必然在前端。 - 在请求体、响应体和页面源码里搜索
sk-,搜不到才算过关。 - 检查环境变量命名:带
NEXT_PUBLIC_之类前缀的变量会被打包进前端,Key 绝对不能放在这类变量里。 - 关掉“用户自定义 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- 确实没有出现在浏览器里,这一步花的五分钟,比任何口头保证都可靠。