外观
API 密钥安全最佳实践
API 密钥等同于账户余额的支付凭证,谁拿到就能用你的余额调用模型。基本原则:密钥只放在环境变量或服务端配置里,不写进代码、不提交到 Git、不放进前端、不截图分享;一旦怀疑泄露,立刻在控制台删除或禁用并重新创建。
1. 用环境变量,不要写死在代码里
bash
# 写入 ~/.zshrc 或 ~/.bashrc 后重新打开终端
export NICEAI_API_KEY="sk-你的密钥"powershell
# 写入当前用户的环境变量,重新打开终端后生效
[Environment]::SetEnvironmentVariable("NICEAI_API_KEY", "sk-你的密钥", "User")python
import os
api_key = os.environ["NICEAI_API_KEY"]项目里用 .env 文件时,记得把它加进 .gitignore:
text
# .gitignore
.env
.env.*
!.env.example再提交一个不含真实密钥的 .env.example,告诉协作者需要哪些变量。
2. 不要把密钥放进前端
网页、小程序、浏览器插件、桌面应用安装包里的任何字符串,用户都能看到。正确做法是在自己的服务端转发请求:前端调用你的后端,后端带上密钥去请求 NiceAI,并在后端做登录校验和频率限制。
3. 按用途分开创建密钥
在控制台「API 密钥」页面,可以为不同工具、项目分别创建密钥,例如 Claude Code 一个、Cursor 一个、线上服务一个。好处是:
- 某个密钥泄露时,只需要删除这一个,不影响其他工具。
- 在使用记录里更容易看出是哪个工具在消耗额度。
密钥是否支持设置额度、有效期等限制,以控制台的实际选项为准。
4. 这些地方最容易泄露
| 场景 | 建议 |
|---|---|
| 把含密钥的配置文件提交到 GitHub | 用环境变量;提交前检查 git diff;仓库开启密钥扫描 |
| 截图、录屏分享配置界面 | 截图前把密钥打码,录屏时避开设置页 |
| 在群聊、论坛里贴报错日志 | 日志里的请求头可能带有密钥,贴之前搜一下 sk- |
把 ~/.claude/settings.json、~/.codex 等目录整个打包发给别人 | 这些文件可能含有密钥,发之前删掉或替换 |
| 使用来路不明的“免费代理”“共享面板” | 只在可信的客户端里填写密钥 |
5. 怀疑泄露后怎么办
- 立即在控制台「API 密钥」页面删除或禁用该密钥。
- 创建新密钥,替换到各个工具和服务里。
- 在使用记录里查看异常时间段的调用情况。
- 如果密钥曾提交到 Git,仅删除文件不够,历史记录里仍然有,要以“已泄露”处理并更换密钥。
- 发现异常消耗时,记下时间和密钥名称联系客服。