资讯详情

TDengine 从 Docker Hub 拉取镜像失败怎么解决

📅 2026/9/15 10:29:10 | 华诺云谱 👁 阅读
TDengine 从 Docker Hub 拉取镜像失败怎么解决
TDengine 从 Docker Hub 拉取镜像失败怎么解决【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine在 Docker 环境中启动 TDengine TSDB 时第一步是从 Docker Hub 拉取镜像当网络环境无法正常访问 Docker Hub 官方仓库hub.docker.com时docker pull会超时或失败导致容器无法启动。本文基于 TDengine 官方文档给出排查拉取失败原因、离线加载镜像、使用镜像源三种解决方法以及镜像到手之后启动容器并验证服务的方法。前提条件是本机已安装 Docker且当前用户可以执行docker命令。第一步判断失败原因处理前先区分两种情况它们的处理方向不同无法访问 Docker Hub 官方仓库。docker pull表现为连接超时、连接被拒等。这是官方 FAQ「安装与部署」章节专门覆盖的问题对应下面的三种解决方法。镜像名称是旧名称。从3.3.7.0版本开始TDengine TSDB 的镜像名称做了调整社区版镜像从tdengine/tdengine重命名为tdengine/tsdb企业版镜像从tdengine/tdengine-ee重命名为tdengine/tsdb-ee如果你的docker pull命令里仍在使用旧名称应先改为上表的新名称再执行而不是去处理网络问题。第二步按原因选择解决方法先检查网络连接官方 FAQ 给出的第一条处理就是检查网络连接是否正常。如果换到可直连 Docker Hub 的网络后拉取恢复直接执行拉取即可docker pull tdengine/tsdb-ee:latest这里以企业版镜像为例社区版对应tdengine/tsdb。拉取成功后直接进入下一节启动容器。离线下载镜像并用 docker load 加载确认网络无法直连 Docker Hub 时走离线通道前往 TDengine 产品下载中心的 Docker 镜像下载页面获取 Docker 镜像下载链接并下载镜像文件。下载完成后使用docker load命令加载镜像具体用法详见下载页面的使用说明。根据页面中的离线安装提示修改镜像的名称和标签。加载并改名完成之后该镜像就等同于从 Docker Hub 拉取下来的镜像后续启动命令中引用改名后的名称和标签。尝试使用镜像源官方 FAQ 给出的另一种尝试是使用其他镜像源例如 CNIX Internal Container Registry Mirrorm.ixdev.cn。注意该镜像源与 TDengine 无关如果它失效需要自行更换为网络上的其他镜像源具体用法以各镜像源自身的使用说明为准。这条路径属于第三方渠道官方文档中没有承诺其长期可用。第三步启动容器并验证服务镜像到本机后按运维指南「Docker 部署」一节的命令启动容器docker run -d --name tdengine \ -v ~/data/taos/dnode/data:/var/lib/taos \ -v ~/data/taos/dnode/log:/var/log/taos \ -p 6041:6041 tdengine/tsdb-ee说明/var/lib/taos是 TDengine 默认数据文件目录/var/log/taos是默认日志文件目录均挂载自主机目录-p 6041:6041映射的是 HTTP 服务端口镜像启动时默认激活 HTTP 服务。如果你加载的是离线镜像把命令末尾的tdengine/tsdb-ee替换为改名后的镜像名称和标签。用docker ps查看容器状态确认STATUS字段显示Up ... (healthy)说明容器已启动并正常运行docker ps -f nametdengine再验证 HTTP 服务是否可用该命令来自「Docker 部署」文档curl -u root:taosdata -d show databases localhost:6041/rest/sql也可以进入容器用taosshell 验证docker exec -it tdengine taos进入后执行show databases;。「Docker 部署」文档给出的示例输出如下示例结果时间等数值以你的实际运行为准taos show databases; name | information_schema | performance_schema | Query OK, 2 rows in database (0.033802s)限制与后续参考第三方镜像源与 TDengine 官方无关失效后需自行更换文档只保留了「尝试其他镜像源」这一方向。离线方式必须完成「下载镜像文件 →docker load加载 → 按页面提示修改镜像名称和标签」三步缺一不可加载后未改名的镜像不能直接用于docker run。容器启动后如果涉及 root 密码变更、镜像升级或健康检查的版本差异3.3.6.6起支持TAOS_ROOT_PASSWORD3.3.8.8及以上支持TAOS_ROOT_PASSWORD_FILE3.4.1.0及以上支持taos-check以「Docker 部署」文档中「自定义密码、升级与健康检查」一节的说明为准。相关文档用 Docker 快速体验 TDengine TSDBDocker 部署常见问题及反馈1.3 节【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。