【免费下载链接】helix-foundryYour companys data, connected into one ontology, on your own computer. A local-first data workspace built on HelixDB and DuckDB.项目地址https://gitcode.com/gh_mirrors/he/helix-foundry点击查看免费下载Helix Foundry 是一个运行在你自己电脑上的本地优先local-first数据工作空间基于 HelixDB 与 DuckDB 构建把公司数据连接成统一的本体ontology。正因为它没有账号体系、不经过云端它的安全模型就显得格外重要。本文带你快速看懂它的三道核心防线本地回环防护、凭证加密存储和API 令牌机制以及日常使用中的安全实践清单。️ 本地回环防护为什么它只监听 127.0.0.1Helix Foundry 没有登录页面——安装它的那个人就是这台电脑的唯一主人。正因为没有签名它必须确保只有这台电脑自己能访问 API否则任何能连到端口的人都直接拥有全部权限。启动即检查只允许回环地址服务启动时会检查HOST配置默认监听127.0.0.1如果配置成非回环地址且没有显式设置ALLOW_NETWORK_ACCESStrue进程会直接拒绝启动并给出明确提示见 server.ts 与 config.ts。Compose 部署也只在127.0.0.1上发布端口内部的 HelixDB、executor 和 Ollama 端口一律不对外。请求级双重校验Host 头与 Origin 头即使端口只在本地API 还会在每一个请求上做两层检查app.ts检查项规则防的是什么Host头必须是回环名localhost、127.0.0.1、::1 等或APP_ORIGIN主机名否则返回 403DNS rebinding恶意域名绑定到本机 IP 后读取数据Origin头浏览器发起的写请求非 GET/HEAD/OPTIONS必须来自配置的 Web 应用源CSRF网页诱导浏览器向本地 API 发送修改请求此外API 还启用了按 IP 的速率限制默认 240 次/分钟可用RATE_LIMIT_MAX调整防止本地端口被滥用刷请求。内部通信也要验明正身API 调用本地 executor 执行 DuckDB 任务时会带上x-internal-key请求头executor 侧用时间安全的比较timingSafeEqual校验INTERNAL_KEYexecutor/src/server.ts防止绕过正常入口直接下发查询任务。 凭证加密AES-256-GCM 守护你的数据库密码你在Data → Add data里填写的数据库账号密码、REST 接口 Token、S3 密钥以及在Settings → AI models里填的 OpenAI/Claude API key全部不会以明文落盘加密算法aes-256-gcm带认证标签的对称加密每次加密使用随机 12 字节 IV输出为iv.认证标签.密文三段 base64security.ts密钥来源.env中的ENCRYPTION_KEY由 scripts/setup.sh 通过openssl rand -hex 32生成且要求至少 32 字符启动时强制校验config.ts应用范围数据源连接配置用seal()加密后存入secret字段routes/data.tsAI 供应商密钥同样加密保存。加密之外还有两道防泄漏细节API 永不回传密钥GET /provider只返回hasKey: true/falseapiKey字段永远为 undefinedroutes/workspace.ts日志脱敏服务端日志自动 redactauthorization、cookie、password等字段错误信息在返回给用户或送入 AI 前会用 redact() 把postgres://...这类连接串和passwordxxx、tokenxxx替换成[redacted]。⚠️ 重要提醒备份不包含ENCRYPTION_KEY丢失该密钥意味着所有已存凭证无法解密需要重新填写。请单独把.env存入密码管理器且不要通过反向代理、内网穿透或端口转发把 Foundry 暴露到网络上docs/OPERATIONS.md。 API 令牌机制给脚本和 SDK 的门禁卡浏览器里不需要令牌本地会话即主人身份但当你要用脚本、SDK 或 CI 自动化调用 API 时需要在Settings → Developer tools中创建令牌POST /workspaces/:workspaceId/tokens传入{ name, readOnly }。令牌设计要点特性说明随机性令牌由 32 字节密码学随机数生成base64url不可猜测只存摘要数据库中只保存令牌的 SHA-256 摘要原始令牌只在创建时显示一次请立即复制保存工作空间隔离令牌绑定单个工作空间无法跨空间访问更不能创建工作空间只读模式readOnly: true的令牌只能读和提问无法发布定义或修改记录可吊销通过DELETE /tokens/:id一键吊销列表里只展示不透明的 UUID 句柄不回显任何密钥材料令牌的路由实现见 routes/workspace.ts完整接口约定见 docs/API.md。认证规则一览无Authorization头→ 视为本机主人仅限本地回环来源带了令牌→ 按令牌身份校验工作空间不对或令牌被吊销则直接 401绝不降级为主人身份非 Bearer 格式的 Authorization 头→ 同样拒绝管理令牌创建/列表/吊销本身要求owner 权限 可写凭据或本地浏览器只读令牌做不了这件事。配合 SDK 使用时只需三行配置docs/API.mdbaseUrl指向本机、填入workspaceId和token即可安全地跑自动化任务。✅ 安全实践清单保持默认回环监听除非有可信前置代理不要设置ALLOW_NETWORK_ACCESStrue妥善保管.envENCRYPTION_KEY和INTERNAL_KEY是唯一解密密钥单独备份可用backup.sh --include-key生成经 PBKDF2 派生密钥加密的env.enc令牌最小权限自动化场景优先创建只读令牌不再使用时及时吊销用pnpm doctor体检启动诊断会检查数据库、executor、模型端点与本地密钥是否齐备。 延伸阅读docs/API.md —— 完整 API 与令牌规范docs/OPERATIONS.md —— 部署限制、备份恢复与升级apps/api/src/security.ts —— 加密、摘要与脱敏的核心实现apps/api/src/app.ts —— 回环 Host/Origin 校验与权限模型tests/token-management.test.ts —— 令牌生命周期测试用例赞分享【免费下载链接】helix-foundryYour companys data, connected into one ontology, on your own computer. A local-first data workspace built on HelixDB and DuckDB.项目地址https://gitcode.com/gh_mirrors/he/helix-foundry点击查看免费下载相关推荐OAuth令牌、MFA与文件型密钥garmin_mcp安全防护完整清单OAuth令牌、MFA与文件型密钥garmin_mcp安全防护完整清单 garmin_mcp 是一个让你用 AI 助手直接查询 Garmin 健康数据的 MC终极指南从API密钥到安全令牌的Better Auth客户端凭证全解析终极指南从API密钥到安全令牌的Better Auth客户端凭证全解析 Better Auth是TypeScript生态中最全面的身份验证框架提供了从API认证鉴权后端身份认证claude-mem Server 安全机制解析API 密钥认证、local-dev 回环旁路与密钥存储模型claude mem Server 安全机制解析API 密钥认证、local dev 回环旁路与密钥存储模型 Claude Mem 的 server 运行时默人工智能Agent 记忆RAGMCP 服务知识图谱AI 插件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考