@git-stunts/vault

中文文档
1.0.1发布于 2026/03/04Apache-2.0ES Module近 30 天下载 6928

OS-native密钥链的安全接口(macOS,Linux,Windows)用于"零秘密架构"

中文使用文档
文档目录8 节
  1. 为什么是沃特?
  2. 特征
  3. 所需资源
  4. 运行时特定适配器
  5. 基于嵌入器的测试
  6. 使用量
  7. 嵌入图像
  8. 许可证

@ git- stunts/ 跳跃

OS-native密钥链的安全接口(macOS,Linux,Windows)用于"零秘密架构"

为什么是沃特?

存储 API 密钥或加密密钥 .env 文件是一种安全风险. vault 卸下这个责任 给操作系统的本地安全存储。 你的申请从来不是"拥有"这个秘密——它只是在需要时要求它.

特征

  • 横线:支持macOS keychain,Linux特勤公司,和Windows证书管理器.
  • 零密会: 磁盘中没有纯文本密钥.
  • 交互式: 可以提示用户丢失机密并自动存储.

所需资源

  • 马科斯: 箱外工作(用途) security) (中文(简体) ).
  • 链接: 要求 libsecret (例如, sudo apt install libsecret-tools) (中文(简体) ).
  • 窗口: 要求 CredentialManager 动力壳模块.

运行时特定适配器

  • 节点( 默认)数字 : Vault 自动检测 Bun 和 Deno Globals 并在两者都不在时返回到节点适配器.
  • 阿宝: 导入 createBunKeychainAdapter (或依赖自动检测)执行命令 Bun.spawnSync 当运行在邦下.
  • 德诺: 导入 createDenoKeychainAdapter 运行通过 Deno.Command。见 deno.json 财务报告和审定财务报表 Dockerfile.deno 一个工作机构.

这个 plumbing/ 文件夹中包含每次运行时的引用 Docker 文件(Dockerfile.bun, (中文(简体) ), Dockerfile.deno等),这样就可以看到端到端的图像如何将端口连接在一起.

基于嵌入器的测试

  • npm test 运行 scripts/run-multi-runtime-tests.sh,这反过来又提出了 node-test, (中文(简体) ), bun-test,以及 deno-test 定义的容器 docker-compose.yml。 。 。 .
  • 每个容器都使用相应的多克文件(Dockerfile, (中文(简体) ), Dockerfile.bun, (中文(简体) ), Dockerfile.deno),可以在当地或CI中复制同样的设置.

使用量

import Vault from '@git-stunts/vault';

const vault = new Vault({ account: 'my-app' });

// Get a secret (returns undefined if missing)
const key = vault.getSecret({ target: 'CHUNK_ENC_KEY' });

// Ensure a secret exists (prompts user if missing)
const secret = await vault.ensureSecret({ 
  target: 'API_TOKEN', 
  promptMessage: 'Enter your API Token' 
});

// Resolve with Env Var priority
const apiKey = vault.resolveSecret({ 
  envKey: 'MY_API_KEY', 
  vaultTarget: 'api-key' 
});

嵌入图像

  • Dockerfile (节点)映射寄存器根工作流程并运行 npm test。 。 。 .
  • Dockerfile.bun 复制两个工程,安装Bun,并运行 bun run vitest test/unit。 。 。 .
  • Dockerfile.deno 依赖 deno task test 定义 deno.json,它通过共享脚本返回 npm 测试堆栈.

许可证

阿帕奇 - 2.0 版权 2026 詹姆斯·罗斯

版本与发布记录

@git-stunts/vault 共发布 2 个版本,首次发布于 2026/01/13;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.0.1latest2026/03/048 个月前
1.0.02026/01/1310 个月前

关于 @git-stunts/vault 的常见问题

@git-stunts/vault 是什么?

OS-native密钥链的安全接口(macOS,Linux,Windows)用于"零秘密架构"

如何安装 @git-stunts/vault?

在项目目录运行 npm install @git-stunts/vault,或使用 pnpm add / yarn add / bun add。

@git-stunts/vault 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/git-stunts__vault 是否存在。

@git-stunts/vault 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@git-stunts/vault 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@git-stunts/vault 可以商用吗?

@git-stunts/vault 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@git-stunts/vault 的下载量有多少?

根据 npm 官方下载统计,@git-stunts/vault 在 2026/10/17 – 2026/11/15 这 30 天内被下载 6,928 次,日均约 231 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@git-stunts/vault 还在维护吗?

最新版本 1.0.1 发布于 2026/03/04(8 个月前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/01/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。