ghcr.io/telepresenceio/tel2

ghcr.io/telepresenceio/tel2:2.20.0

ghcr.iolinux/amd642.20.0大小: 45.61 MB更新于 2026年11月8日

Telepresence:面向 Kubernetes 的快速本地开发工具

Telepresence 是 CNCF 旗下项目,可将您的工作站接入 Kubernetes 集群。您可以使用自有 IDE、调试器与热重载功能在本地对服务进行编码和调试,同时该服务能够接收集群内的真实流量,全程无需执行容器构建/推送/部署流程。

核心特性

  • 集群访问能力 - 您的工作站可直接访问集群中的 Service 与 Pod,如同身处集群内部:原生支持集群 DNS、集群 IP,无需配置端口转发。
  • 四种接入模式 - 支持替换远程容器、拦截服务端口、窃听流量副本,或是仅同步环境变量与卷挂载。
  • 流量过滤功能 - 可通过 HTTP 请求头或路径筛选仅属于您的请求进行拦截,让整个团队共用同一集群时不会产生冲突。
  • Sidecar 或节点代理部署模式 - traffic-agent 默认以 Sidecar 方式注入,也可作为托管在节点上的 Pod 运行,直接关联目标工作负载,无需修改工作负载配置,也无需重启 Pod。
  • 远程环境,本地运行 - 运行时可获取远程容器的环境变量与卷挂载,令本地代码的运行行为与在集群中完全一致。

快速上手

  • 快速入门指南 - 数分钟内完成配置并开始使用
  • 安装指引 - 安装 Telepresence 客户端
  • 完整文档 - 查看全部官方文档

工作原理

Telepresence 建立连接后,会在您的工作站上创建虚拟网络接口,并通过部署在集群内的 traffic-manager 路由集群流量。当您关联某一工作负载时,系统会为其添加 traffic-agent(Sidecar 或节点代理模式),负责将该工作负载的流量、环境变量与卷挂载转发至您的本地机器。完整架构说明请参考架构概览文档。

社区

  • GitHub 讨论区 - 提问、分享想法、共同参与路线规划
  • CNCF Slack - 加入 #telepresence-oss 频道
  • 故障排查 - 常见问题与解决方案

赞助

Telepresence 是完全免费的开源项目,该特性由赞助商持续保障。赞助资金将用于保障快速响应 Issue、及时推送安全修复、开发新功能。如果您的团队依赖 Telepresence,欢迎考虑为本项目提供赞助,或联系我们了解企业级赞助方案。

感谢我们过往的赞助商:

  • OpenAI

贡献

请查看 AGENTS.md 文件获取构建说明、架构概览与开发规范。

代码签名策略

Windows 平台的二进制文件与安装包采用 Authenticode 签名,由 Telepresence 开源项目核心维护者创立的瑞典公司 Tada AB 通过 Azure Artifact Signing 服务分发。

  • 提交者与审核人员:telepresence-maintainers 团队(@thallgren、@bgruszka、@njayp、@breland-openai)
  • 审批人员:管理员(@khussey、@thallgren)
  • 隐私政策:PRIVACY.md

许可证

Telepresence 采用 Apache License 2.0 许可证开源。


项目仓库 README(补充)

https://telepresence.io - 从此处开始使用!

[!NOTE] Telepresence 1 已被体验更优异的 https://github.com/telepresenceio/telepresence/tree/release/v2 取代。请优先试用 Telepresence 2 并反馈所有问题,我们计划在 2021 年第二季度将其设为默认版本。

演示

Telepresence:面向 Kubernetes 微服务的高效快速本地开发工具

Telepresence 为开发者提供可无限扩容的 Kubernetes 开发环境。使用 Telepresence 您可以:

  • 运行单个本地服务,使用您偏好的 IDE 与各类开发工具
  • 将应用其余部分运行于云端,享有无限的内存与计算资源支持

这为开发者带来以下优势:

  • 快速的本地开发闭环,无需等待容器构建/推送/部署流程
  • 可以使用您熟悉的各类本地工具(IDE、调试器等)
  • 能够运行原本无法在本地部署的大规模应用

快速开始

  1. 通过 Homebrew、apt 或 dnf https://www.telepresence.io/reference/install。
  2. 执行 telepresence 命令。
  3. 此时您将进入可代理 Kubernetes 连接的专属 Shell 环境。

如需了解 Telepresence 的更多信息与各类配置选项,请https://www.telepresence.io/discussion/overview。

使用数据上报

Telepresence 会收集部分基础用户信息,用于发送重要客户端通知,例如新版本发布提示、安全公告。我们也会将该信息聚合为***的基础使用分析数据。如需关闭该功能,请设置环境变量 SCOUT_DISABLE:

export SCOUT_DISABLE=1

如需了解详情,请查看https://www.telepresence.io/reference/usage_reporting。

参与社区

  • 在 *** 关注 @telepresenceio
  • 加入 Telepresence Slack 社区

关于 Telepresence

专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告