无需登录 · 本页不含 Token / 密钥明文
金縢 对接说明
加密密钥库(金縢 / jinteng)。客户端用 URL + API Token 对接;项目 / git / CI / agent 里只写密钥名,用 jinteng run 在运行时注入。
当前服务地址https://jinteng.ninja-sin.tech
本说明https://jinteng.ninja-sin.tech/ 或 https://jinteng.ninja-sin.tech/docs
Token 不会显示在本页。
在服务端读取:Docker 用
docker compose -f deploy/docker-compose.yml exec jinteng cat /data/token;
二进制部署用 cat ~/.jinteng/token(或 $JINTENG_DIR/token)。
1. 客户端环境变量
export JINTENG_URL='https://jinteng.ninja-sin.tech' export JINTENG_TOKEN='<从服务端 token 文件粘贴>' jinteng list
2. 推荐:运行时注入(不明文进仓库)
jinteng run \ -e OPENAI_API_KEY=openai/key \ -e DATABASE_URL=db/url \ -- your-dev-server
流程:CLI 调用 POST /v1/resolve → 值只进入子进程环境变量 → 磁盘项目目录不落明文。
3. HTTP API
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /healthz | 探活,无需 Token |
| GET | /v1/secrets | 列出名称(无明文) |
| GET | /v1/secrets/{name} | 取单个值 |
| PUT | /v1/secrets/{name} | 写入 {"value","note"} |
| DELETE | /v1/secrets/{name} | 删除 |
| POST | /v1/resolve | 批量解析 {"refs":["a","b"]} |
鉴权头:Authorization: Bearer <token> 或 X-Jinteng-Token: <token>
4. 安全注意
- 本服务默认 HTTP + Bearer;远程请用 VPN 或 HTTPS 反代,勿裸暴露应用端口。
- Token 泄露后在服务端 rotate,并更新各客户端。
- 切勿把
token、jinteng.bin、真实.env提交进 git。