Skip to content

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. 怀疑泄露后怎么办 ​

  1. 立即在控制台「API 密钥」页面删除或禁用该密钥。
  2. 创建新密钥,替换到各个工具和服务里。
  3. 在使用记录里查看异常时间段的调用情况。
  4. 如果密钥曾提交到 Git,仅删除文件不够,历史记录里仍然有,要以“已泄露”处理并更换密钥。
  5. 发现异常消耗时,记下时间和密钥名称联系客服。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站