tunr：客户本地数据访问桥接工具

21次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 tunr

30秒速读

tunr 是面向 AI Agent 的客户本地数据访问桥接工具，解决一个很具体的难题：AI 厂商想让自家 Agent 读客户内网的数据库、ERP 或账本，客户却不愿意为此开放入站端口、交出数据库账号。它的做法是反过来的，Connector 装在客户网络内，只向外拨号；每一次访问都要按 Agent、资源、模式和时间窗口单独审批，数据库访问默认只读，全程留审计记录。如果你要评估的正是这类受控访问场景，tunr 值得先做一次概念验证；如果你要的是通用 VPN、数据同步平台或可写数据库代理，它并不是那个东西。

软件信息表

项目	内容
名称	tunr
定位	面向 AI Agent 的客户本地数据访问桥接工具
运行方式	Go 编写的命令行与 Connector，单个静态二进制，无运行时依赖
支持系统	macOS、Linux、Windows，覆盖 amd64 与 arm64
核心机制	出站连接、按资源与时间窗口审批、数据库只读控制、审计导出
Agent 接入	MCP 工具：列出资源、申请访问、开启访问
许可证	CLI 为 Apache-2.0，Relay 为 PolyForm Shield，分发前需分别核对
获取方式	GitHub 开源仓库，见文末直链

上手指南

先在 GitHub 仓库读 README 与在线文档，确认你要接的数据源在命名资源与只读数据库的覆盖范围内，再动手部署。
在客户网络内安装 Connector 并作为长期服务运行，确认它只向外发起连接，不需要在客户防火墙上开放入站端口。
用 tunr doctor 做安装验证，确认 Connector、CLI 与连接链路都正常，再进入授权配置。
以命名资源的方式登记要开放的数据源，为每个 Agent 单独设定可访问的资源、模式与时间窗口，审批时写清楚可读的申请理由。
先用只读查询跑通一次完整流程：申请、审批、访问、审计导出，确认查询摘要与撤销流程都符合客户要求，再扩大资源范围。

装完先改这几处

把默认的访问窗口收紧：不要一上来就给长期授权，先按单次任务设定最短时间窗口，到期自动失效，续期必须重新审批。
把数据库访问钉死在只读上：确认只读角色、只读会话与语句分类器三层都生效，写入操作应当直接失败，而不是靠口头约定不写。
把审计导出变成例行动作：每次授权、会话与查询摘要都要能导出为 CSV，定期交给客户 IT 复核，不要等出问题才去翻日志。
把撤销路径先演练一遍：单个授权撤销要能立即关闭活动连接，站点级停止开关要能一键撤销全部访问，演练通过再正式上线。

真实使用场景推演

假设一家 AI 厂商要为客户做月度经营分析，Agent 需要读客户本地 ERP 里的订单与账本数据，但客户 IT 明确表示不能开入站端口、不能给数据库账号。用 tunr 的流程是这样的：客户内网先装好 Connector，只向外拨号；厂商的 Agent 通过 MCP 工具列出已登记的命名资源，提交一份带理由的访问申请，写明只读、只读订单表、本周内有效；客户审批通过后，访问窗口才开启，Agent 在窗口内跑只读查询，查询摘要自动记入审计；窗口一到，访问自动失效，客户可以随时撤销，事后还能导出 CSV 核对 Agent 到底查了什么。这个流程里最值钱的不是连接本身，而是每一步都有审批、有时限、有记录，客户敢放行。

横向对比与避坑清单

和直接开 VPN 相比，tunr 的优势是客户不用改防火墙入站规则，风险面小得多；代价是它只解决受控访问这一层，不提供 VPN 那种全网段连通能力。和数据库直连账号相比，它的优势是按 Agent 与资源做细粒度审批、可随时撤销；代价是接入前要先把资源逐一登记命名，不适合临时随手查一次的场景。避坑清单有三条：第一，读写访问需要两名不同审批者，不要默认自己能单人批写权限；第二，托管 Agent 标注为 early access，上线前必须先确认运行边界与可用区域；第三，Relay 与 CLI 许可证不同，企业分发前务必分别核对条款，不要按一个许可证理解全项目。

注意事项与常见问题

问：tunr 能替代 VPN 吗？答：不能。它是受控连接与授权层，不是全网段 VPN，也不是数据同步平台，跨网段的通用连通需求要另选方案。
问：数据库真的只能读吗？答：按项目设计，数据库访问有只读角色、只读会话与语句分类器三层约束，写入操作会失败；上线前仍建议自己实测一次写入被拒的流程。
问：访问到期后怎么办？答：按时间窗口审批的访问到期即失效，需要重新申请与审批；不要用长期授权绕过这个机制，否则审批与审计的意义就没了。
问：出问题怎么快速止血？答：撤销单个授权可关闭活动连接，站点级停止开关可撤销全部访问；建议上线前就把这两条撤销路径演练通过。

适合谁，不适合谁

适合：需要让 AI Agent 受控访问客户本地 ERP、账本、文件服务器或数据库的 AI 厂商与平台开发者，以及要为这种访问做审批与审计的客户 IT 团队；也适合熟悉 Go 与命令行部署、能把 Connector 作为长期服务维护的团队。不适合：需要通用 VPN 连通、完整数据同步、成熟读写事务语义或标准化企业身份与托管平台能力的项目；也不适合只想临时查一次数据、不愿做资源登记与审批流程的场景，硬上只会觉得处处受限。