已验证指南更新于 2026-05-15仅使用占位符

安全与 API Key 使用规范

API Key 是敏感凭证。公开文档、GitHub、截图、聊天记录里都不要出现真实 key。

1. 正确做法

  • 文档里只写占位符,例如 your_synterolink_key
  • 本地终端使用环境变量。
  • 团队项目使用 .env,并把 .env 加入 .gitignore
  • CI/CD 使用平台 Secrets。
  • 离职、泄漏或权限变化时立即轮换 key。

2. 本地环境变量示例

export OPENAI_API_KEY="your_synterolink_key"
export ANTHROPIC_AUTH_TOKEN="your_synterolink_key"

3. .env 示例

OPENAI_API_KEY=your_synterolink_key
ANTHROPIC_AUTH_TOKEN=your_synterolink_key

.env 文件不要提交到 Git。

4. Git 忽略配置

.env
.env.*
*.local

5. 团队管理建议

场景建议
个人测试个人 key,低权限
团队共享使用团队 key,并限制访问范围
生产服务使用专门生产 key,单独权限和限额
出现泄漏立即禁用旧 key,生成新 key

6. 公开分享前检查

grep -R "sk-" .

如果发现真实 key,先删除、轮换,再重新发布。