- 社区热度
- 5.3k Stars
- GitHub 收藏
- 最近活跃
- 2026/9/11
- 近 30 天还在更新
- 授权协议
- MIT
- 宽松协议
为什么值得关注
不是看 Star 排名,而是看它解决了什么问题、实际有没有用,以及方法为什么值得关注。
解决的问题
微服务和 Kubernetes 环境里,本地代码往往缺少真实环境变量、服务响应、队列和网络上下文;为了验证一个改动反复部署到集群,反馈周期慢且容易影响共享环境。
实际价值
mirrord 让代码继续在本机运行,却把流量、文件和环境变量通过目标 Pod 接入真实集群,因此能在不先部署新版本的情况下做接近真实环境的开发和端到端验证。
创新 / 差异化
它没有再造一套本地微服务,而是把“本地进程”和“集群运行上下文”拆开再重新连接:计算留在开发机,依赖与数据上下文来自真实 Pod。
扩展潜力
它能从 CLI、VS Code、IntelliJ 进入现有开发流程,也能让 AI Coding Agent 在写代码时读取和验证真实集群上下文,因此可以成为云原生开发链路的公共调试层。
为什么是现在
云原生系统越来越难完整复制到本地,而 AI Coding Agent 又更需要真实运行上下文来避免“只在代码层猜测”,这让无部署调试的价值明显上升。
社区活跃度
近 90 天新增 8 个 Issue、482 个 PR;窗口内抽取的 Issue/PR 样本中有 8 位 Issue 发起者、16 位 PR 贡献者,并发布 至少 44 个版本。
维护者响应
窗口内 8 个 Issue 样本关闭率 88%,100 个 PR 样本合并率 81%。维护者评论样本仅覆盖该 Issue 样本的 0%,不足以可靠判断首次响应率与响应速度。
核心亮点
- 本地进程复用目标 Pod 的入站和出站网络流量
- 可读取/写入目标上下文文件并使用环境变量
- 提供 VS Code、IntelliJ 与 CLI 三种使用方式
快速开始
安装方式、上手难度、开始步骤。
装在哪
本地运行
难不难
中等,需要一点配置
- 01确认本机 kubeconfig 可以访问需要调试的 Kubernetes 集群。
- 02安装 VS Code/IntelliJ 插件,或通过 Homebrew、安装脚本、Chocolatey 安装 mirrord CLI。
- 03选择需要模拟的命名空间和 Pod;CLI 可使用
mirrord exec --target。 - 04启动本地进程,在不部署新镜像的情况下验证它与集群服务的交互。
更适合谁
- 想在本机直接跑起来试用的开发者
- 习惯用 Docker 部署的人
更多介绍
mirrord 用于把本地开发进程接到真实 Kubernetes 环境中。代码仍然运行在开发者电脑上,但可以选择一个目标 Pod,让本地进程复用该 Pod 的入站/出站流量、文件访问和环境变量,从而直接面对集群中的真实服务和数据。
它提供 VS Code 扩展、IntelliJ 插件和 CLI 三种入口。调试时选择要模拟的 Pod 后,mirrord 会在相同节点启动辅助 Pod,并把本地进程与目标环境连接起来。这样可以在不先构建和部署镜像的情况下验证本地修改。
项目还明确支持 Claude Code、Cursor、Codex CLI、Gemini CLI 等 AI 编程 Agent,让生成的代码可以在真实集群上下文中运行验证。使用前需要本机 kubeconfig 对目标 Kubernetes API 具有适当访问权限。
信息来源
每条信息都标注了状态与出处,可展开查看。
14 条 · 展开
信息来源
每条信息都标注了状态与出处,可展开查看。
capability tags
已核验testing、ai_coding
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
editor note
已核验{"en":"mirrord is for a specific development loop: change code locally, validate it against real cluster dependencies, and avoid a full build-and-deploy cycle each time. That is useful for microservice debugging and AI coding agents, but access to live pod context means permissions and target environments should be chosen carefully.","zh":"mirrord 的使用场景很具体:本地改代码,但希望拿真实集群依赖来验证,又不想每次都走构建部署。它对微服务调试和 AI 编程 Agent 都有价值,但因为会接入真实 Pod 上下文,权限和目标环境需要谨慎选择。"}
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
how to use
已核验{"steps":[{"en":"Confirm that the local kubeconfig can access the Kubernetes cluster you want to debug against.","zh":"确认本机 kubeconfig 可以访问需要调试的 Kubernetes 集群。"},{"en":"Install the VS Code or IntelliJ plugin, or install the mirrord CLI through Homebrew, the install script, or Chocolatey.","zh":"安装 VS Code/IntelliJ 插件,或通过 Homebrew、安装脚本、Chocolatey 安装 mirrord CLI。"},{"en":"Choose the namespace and pod to impersonate; with the CLI use `mirrord exec <command> --target <target>`.","zh":"选择需要模拟的命名空间和 Pod;CLI 可使用 `mirrord exec <command> --target <target>`。"},{"en":"Start the local process and verify its interaction with cluster services without deploying a new image.","zh":"启动本地进程,在不部署新镜像的情况下验证它与集群服务的交互。"}],"installAt":"local","difficulty":"medium"}
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
intro
已核验{"en":"mirrord connects a local development process to a live Kubernetes environment. The code continues running on the developer machine, but after selecting a target pod the local process can use that pod’s incoming and outgoing traffic, file access, and environment variables so it interacts with real cluster services and data.\n\nIt is available as a VS Code extension, IntelliJ plugin, and CLI. When a pod is selected, mirrord starts a helper pod on the same node and connects the local process to the target environment. This allows developers to test local changes without first building and deploying a new image.\n\nThe project also documents workflows for AI coding agents including Claude Code, Cursor, Codex CLI, and Gemini CLI, allowing generated code to be verified against real cluster services. A local kubeconfig with suitable Kubernetes API access is required.","zh":"mirrord 用于把本地开发进程接到真实 Kubernetes 环境中。代码仍然运行在开发者电脑上,但可以选择一个目标 Pod,让本地进程复用该 Pod 的入站/出站流量、文件访问和环境变量,从而直接面对集群中的真实服务和数据。\n\n它提供 VS Code 扩展、IntelliJ 插件和 CLI 三种入口。调试时选择要模拟的 Pod 后,mirrord 会在相同节点启动辅助 Pod,并把本地进程与目标环境连接起来。这样可以在不先构建和部署镜像的情况下验证本地修改。\n\n项目还明确支持 Claude Code、Cursor、Codex CLI、Gemini CLI 等 AI 编程 Agent,让生成的代码可以在真实集群上下文中运行验证。使用前需要本机 kubeconfig 对目标 Kubernetes API 具有适当访问权限。"}
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
最新版本
已核验3.256.0
来源: GitHub 官方接口 · latest_release=3.256.0 · 2026/9/11
许可证
已核验MIT
来源: GitHub 官方接口 · license.spdx_id=MIT · 2026/9/11
needs api key
已核验否
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
一句话用途
已核验{"en":"A developer tool that routes a local process through a Kubernetes pod so code can use live cluster traffic, files, and environment variables without deploying first.","zh":"让本地进程复用 Kubernetes Pod 的流量、文件和环境变量,在不部署新版本的情况下连接真实集群服务进行开发和调试。"}
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
平台
已核验windows、macos、linux
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
分类线索
根据材料推断ai-apps
来源: 项目说明文档 · hint=ai-apps · 2026/8/14
product forms
已核验cli、ide_plugin
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
role tags
已核验backend、devops
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
supports docker
已核验是
来源: 仓库文件 · dockerfile=true; compose=false · 2026/9/11
supports local
已核验是
来源: manual_curated · Manually curated from the verified project README; no AI draft. · 2026/8/17
相关项目
根据分类、能力和适用角色匹配的其他已核验项目。
adk-python
Google 开源的 Python Agent 开发框架,用于定义、编排、评估并部署单 Agent 与多 Agent 工作流。
claude-code
运行在终端中的 Agent 编程工具,可理解代码库、执行日常开发任务、解释代码并处理 Git 工作流。
spec-kit
一套遵循「规范驱动开发」流程的开源 CLI 工具包,配合 AI 编程 Agent 按照规范生成与执行代码。
llama.cpp
基于 C/C++ 实现的轻量级大语言模型推理引擎,支持多种硬件加速与模型量化。
codex
运行在本机的 OpenAI 编程 Agent,可通过终端使用,也提供 IDE 和桌面应用入口。
CLI-Anything
为现有软件生成和管理 Agent 可调用 CLI 的工具集,包含 CLI-Hub、生成流程与 SKILL/插件接入方式。