常见问题
Tokenhush 常见问题
简短、可独立阅读的回答:如何安装网关、面向哪些平台、它如何处理你的密钥与流量,以及那两个可以关闭的厂商请求。
01如何安装 Tokenhush?
macOS:brew install --cask fregie/tap/tokenhush。Linux:curl -fsSL https://raw.githubusercontent.com/fregie/tokenhush/main/install.sh | bash。Windows:irm https://raw.githubusercontent.com/fregie/tokenhush/main/install.ps1 | iex。Linux 与 Windows 安装脚本会先按发布版 checksums.txt 校验压缩包的 sha256 再安装,无需管理员权限,也支持固定版本。若要从源码构建,需要 Go 1.25 或更新版本:go build -o tokenhush ./cmd/tokenhush。
02macOS、Linux 与 Windows,每个平台都有 arm64 与 amd64 目标。二进制是以 CGO_ENABLED=0 构建的纯 Go 程序,交叉编译干净,不需要 C 工具链。用 tokenhush run 启动。它没有内置的服务命令:若要在登录与重启后保持运行,请用操作系统自带的工具包装 tokenhush run——macOS 用 launchd agent、Linux 用 systemd user unit、Windows 用任务计划程序。TOKENHUSH_HOME 可把配置与数据移到同一个根目录。
03Tokenhush 会看到我的密钥吗?
会——在进程内、在内存中:它必须读取每个请求体才能找到并替换机密。但它从不持久化这些内容:请求与响应正文、检测到的机密、占位符到机密的映射都不会写入磁盘。脱敏日志经过掩码处理,只输出到 stderr。
04它会把机密写入磁盘吗?
不会。它只写入元数据文件:run.json(pid、port、addrs、started_at)、权限为 0600 的控制令牌、校验过的规则缓存,以及更新防回滚标记。正文与占位符映射都留在内存中。数据目录下的会话文件会在正常退出时删除。
05会让我的请求变慢吗?
它运行在本机回环的请求路径上,遍历请求体之后转发给提供商。它不终止 TLS,也不会在你的工具本就发起的那一跳之外增加网络跳数。实测开销尚未公布,因此任何数字都请视为未经证实。
06会破坏我工具的函数调用吗?
默认开启的五个检测器是保守集合。entropy 默认关闭,正是因为它在长工具名与会话 id 上的误报在测试中破坏了函数调用;除非你的负载不含图片、data URL 或长随机标识符,否则请保持关闭。占位符在会话内保持稳定,并会在响应路径上还原,因此工具仍会收到它发出的那些值。
07离线环境能用吗?
网关绑定回环地址,并转发给你配置的提供商,因此它需要与你工具相同的网络可达性。它自身面向厂商的请求恰好有两个,都由命令触发且可关闭:更新检查只在运行 tokenhush update 时发生,规则同步只在运行 tokenhush rules sync 时发生。除这两个之外,网关不自行发起其他出站请求。
08在公司 HTTP 代理环境下能用吗?
Tokenhush 不会自带代理,严格的配置 schema 里也没有代理键。网关会向你配置的提供商源站发起正常的出站 HTTPS 连接,因此它需要与你工具相同的出站可达性。如果你的环境通过公司代理访问外部,请把网关当作机器上的其他 CLI 一样对待。
09两个面向厂商的请求发往哪里?可以关掉吗?
两者都发往 updates.tokenhush.com,且都由命令触发:更新检查只在运行 tokenhush update 时发生,规则同步只在运行 tokenhush rules sync 时发生;设置对应开关后,各自会在任何网络调用之前短路。两者的保留期均为 30 天。可用 TOKENHUSH_NO_UPDATE_CHECK=1 与 TOKENHUSH_NO_RULE_SYNC=1 关闭。tokenhush privacy 会打印完整披露。
公开来源
本页所有回答都改写自开源核心中已公开的材料。本页引用的文档:
开源
先把一个工具接进来
安装二进制,把一个工具指向本机回环网关,观察一个请求如何通过。接入指南为每个受支持的客户端提供可直接粘贴的配置片段。