mirrord
活跃·★ 5.4k·MIT·更新于 2026-11-17
mirrord 是由 MetalBear 打造的开源云原生开发调试利器(遵循 MIT 协议)。它从根本上重塑了微服务开发体验:允许工程师或 AI 编码智能体(Claude Code、Cursor、Windsurf 等)直接在本地运行未打包的代码,但让该进程在逻辑上完全置身于远程 Kubernetes 集群的目标 Pod 环境中。
在底层原理上,mirrord 通过在目标 Node 节点上启动一个轻量级 Agent 容器,利用 Linux Network Namespace 与 iptables 规则(依赖 CAP_NET_ADMIN 与 CAP_SYS_PTRACE 特权),实现双向网络劫持与镜像、集群内 DNS 解析代理、环境变量同步注入以及远程文件系统透明读取。这使本地进程或编码智能体无需重新编译镜像和等待 CI/CD 部署,即可在秒级获得真实集群上下文反馈。
mirrord 提供了高效的 CLI(mirrord exec)、VS Code 插件与 JetBrains IntelliJ 插件。需要关注的是多团队协作下的数据隔离:在未启用 mirrord for Teams 流量分流与数据库分支的情况下,本地进程向远程共享数据库或消息队列发起的写操作可能会影响联调环境中的其他微服务。
#智能体技能#AI 智能体#AI 编程#API#后端#Claude Code#命令行#云
01
功能特性
01通过目标 Pod 转发流量、文件和环境变量
02提供 VS Code 扩展、IntelliJ 插件和命令行工具
03可配合 Claude Code、Cursor、Codex CLI 和 Gemini CLI 使用
04对着集群测试,不影响其他人使用
02
为什么选择它
+彻底跳过容器重新构建、镜像推送与 CI 流水线部署,本地进程秒级连接远程 K8s 环境。
+全上下文透明穿透,覆盖入站流量镜像、出站请求与 DNS 集群代理、远程环境变量及文件读取。
+为 AI 编码智能体(Claude Code、Cursor 等)提供了真实的微服务验证闭环,极大提升排错效率。
+支持生态完备,同时提供 VS Code 插件、IntelliJ 插件及命令行 mirrord exec 工具。
03
权衡点
!需要较高的 Kubernetes 集群权限,包括创建临时 Pod、CAP_NET_ADMIN 与 ptrace 调试特权。
!在共享集群中未做隔离时,本地进程的写操作(如写数据库、发消息队列)可能污染测试环境真实数据。
!本地与远程云端集群之间的网络带宽与延迟,直接决定高吞吐流量调试时的响应速度。
!企业内网复杂 VPN、严格的 Service Mesh(如 Istio)以及防火墙策略可能需要针对性配置放行。
04
维护状况检查
活跃检查日期: 2026-11-12
- 最近提交
- 2026-11-11
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 30
- 最新发布
- 3.286.0 (2026-11-10)
- 未关闭 issue
- 21
- 近期 issue 至少有一条评论的比例
- —
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
05
兼容性
VS Code
扩展
已通过文档验证
IntelliJ
插件
已通过文档验证
Claude Code
支持
已通过文档验证
Cursor
支持
已通过文档验证
06
快速开始
1
$ brew install metalbear-co/mirrord/mirrord
07
使用场景
↳在本地对着真实的集群依赖调试服务
↳让编程智能体写代码时读取集群的实时上下文
↳不部署就端到端验证生成的代码
08
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧