mirrord 让你可以在本地运行代码，效果就像它部署在远程 Kubernetes 集群中一样。 无论你是开发人员还是使用 AI 编码助手（如 Claude Code, Cursor, Codex, Copilot, Windsurf），其工作方式完全一致：代码在你的机器上运行，但 mirrord 会通过集群中的目标 Pod 对流量、文件访问和环境变量进行路由。

这涵盖了软件开发闭环的两个方面。在编写代码时，你可以读取集群的实时上下文（真实的环境变量、真实的服务响应、真实的队列内容），从而确保你的变更基于实际部署的环境。随后，你可以直接针对这些服务和数据运行代码，以确认其端到端的功能表现。

你可以在几秒钟内获得类似于部署后的反馈，且无需实际部署，也不会干扰集群中其他人的工作。 mirrord 提供 VS Code 扩展、IntelliJ 插件和 CLI 工具。了解更多信息。

采用者包括：monday.com, SurveyMonkey, Cadence, CoLab, Daylight Security, Zooplus 以及其他公司。

目录

• 目录
  • 快速入门
  • VS Code 扩展
    • 安装
    • 使用方法
  • IntelliJ 插件
    • 安装
    • 使用方法
  • CLI 工具
    • 安装
    • 使用方法
  • 工作原理
    • 其他能力
  • 将 mirrord 与 AI 编码助手结合使用
  • 常见问题 (FAQ)
  • 参与贡献
  • 帮助与社区
  • 行为准则
  • 许可协议

---

快速入门

• VS Code 扩展
• IntelliJ 插件
• CLI 工具

mirrord 使用你机器上的默认 kubeconfig 来访问 Kubernetes API。

---

VS Code 扩展

安装

在此获取扩展。

使用方法

• 点击状态栏上的 "Enable mirrord"
• 开始调试你的项目
• 选择要模拟的 Pod
• mirrord 会将调试中的进程连接到选定的 Pod

---

IntelliJ 插件

安装

在此获取插件。

使用方法

• 点击导航工具栏中的 mirrord 图标
• 开始调试你的项目
• 选择要模拟的命名空间和 Pod
• mirrord 会将调试中的进程连接到选定的 Pod

---

CLI 工具

安装

你可以使用以下方式之一：

brew install metalbear-co/mirrord/mirrord

或者：

curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash

或者使用 Nix（非官方，社区维护）：

# Using nix-env (legacy)
nix-env -iA nixpkgs.mirrord

# Using nix profile (recommended)
nix profile install nixpkgs#mirrord

或者在 Windows 上使用 Chocolatey：

choco install --pre mirrord

使用方法

mirrord exec  --target 

例如：

mirrord exec node app.js --target pod/my-pod

---

工作原理

当你选择一个要模拟的 Pod 时，mirrord 会在你选定 Pod 所在的节点上启动一个新的 Pod。 这个新的 Pod 用于连接你的本地进程和目标 Pod：它将来自目标 Pod 的传入流量镜像到你的进程，将来自你进程的传出流量路由到目标 Pod，并对文件读取、文件写入和环境变量执行相同的操作。 点击此处阅读更多关于其原理的内容。

其他能力

mirrord 启动的 Pod 中运行的容器需要额外的 Linux Capabilities：

• CAP_NET_ADMIN 和 CAP_NET_RAW - 用于修改路由表
• CAP_SYS_PTRACE - 用于读取目标 Pod 的环境变量
• CAP_SYS_ADMIN - 用于加入目标 Pod 的网络命名空间

不过，你可以在配置中禁用其中任意部分。 这可能会限制 mirrord 的功能，甚至使其无法使用。