portainer/k2d
portainer
Kubernetes到Docker的转换器镜像，用于将Kubernetes资源转换为Docker格式，支持配置适配与迁移。
下载次数: 0状态：社区镜像维护者：portainer仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
K2D 镜像技术文档
1. 镜像概述和主要用途
K2D（Kubernetes to Docker translator）是一款 Kubernetes 原语转换器，旨在解决资源受限计算设备（尤其是工业物联网场景下的设备）中使用 Kubernetes 原语的问题。它并非完整的 Kubernetes 集群，而是一个 Kubernetes 模拟器/转换器，允许用户在设备上运行 Docker 容器的同时，以管理单节点 Kubernetes 集群的方式管理这些容器，实现“无 Kubernetes 的 Kubernetes 体验”。
2. 核心功能和特性
- Kubernetes 原语支持：兼容 Kubernetes 核心原语（如 Deployment、Service 等），可直接使用 Kubernetes 配置文件进行容器管理。
- Docker 原生集成：通过 Docker 引擎运行和管理容器，无需部署完整 Kubernetes 组件（如 kubelet、etcd 等），降低资源占用。
- 单节点集群模拟：将设备模拟为单节点 Kubernetes 集群，简化边缘设备上的容器编排与管理。
- 多架构支持：适配多种硬件架构，包括
linux/amd64、linux/arm64、linux/386、linux/armv6和linux/armv7。
3. 使用场景和适用范围
适用场景
- 工业物联网（IIoT）设备：资源受限的工业传感器、边缘网关等设备，需轻量化管理容器应用。
- 边缘计算节点：边缘环境中资源有限的计算设备，需简化容器编排流程。
- 资源受限环境：无法部署完整 Kubernetes 集群，但需要使用 Kubernetes 原语进行容器管理的场景。
4. 使用方法和配置说明
4.1 部署要求
- 运行环境：支持 Docker 的 Linux 系统。
- 硬件架构：
linux/amd64、linux/arm64、linux/386、linux/armv6或linux/armv7。
4.2 部署步骤（Docker Run）
通过以下命令部署 K2D 容器：
bashdocker run -d \ --name k2d-k2d \ --network host \ --restart always \ --env K2D_ADVERTISE_ADDR=YOUR_HOST_IP \ --env K2D_SECRET=YOUR_OWN_SECRET \ --label resource.k2d.io/namespace-name=k2d \ --label workload.k2d.io/name=k2d \ --volume /var/run/docker.sock:/var/run/docker.sock \ --volume /var/lib/k2d:/var/lib/k2d \ portainer/k2d:1.0.0
5. 配置参数详解
5.1 环境变量
| 环境变量 | 说明 | 必要性 |
|---|---|---|
K2D_ADVERTISE_ADDR | 设备主机 IP 地址，用于 K2D 服务暴露和通信 | 必需 |
K2D_SECRET | 自定义密钥，用于 K2D 内部认证和数据安全 | 必需 |
5.2 卷挂载
| 卷路径 | 说明 | 必要性 |
|---|---|---|
/var/run/docker.sock:/var/run/docker.sock | Docker 守护进程 socket，用于 K2D 管理 Docker 容器 | 必需 |
/var/lib/k2d:/var/lib/k2d | K2D 数据持久化目录，存储配置、状态等数据 | 必需 |
5.3 其他配置
- 网络模式：
--network host，使用主机网络以避免端口映射复杂配置，确保 K2D 服务直接暴露在主机网络中。 - 重启策略：
--restart always，确保 K2D 容器在意外退出后自动重启，提高服务稳定性。 - 标签：
resource.k2d.io/namespace-name=k2d和workload.k2d.io/name=k2d，用于 K2D 自身的命名空间和工作负载标识。
6. 参考资料
更多部署和使用细节，请参考官方文档：docs.k2d.io
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull portainer/k2d:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"