3步让私有Docker镜像在Dokploy上线:从配置仓库到部署成功 📅 发布时间:2026/9/1 14:20:38 👁 浏览次数: 3步让私有Docker镜像在Dokploy上线从配置仓库到部署成功【免费下载链接】dokployOpen Source Alternative to Vercel, Netlify and Heroku.项目地址: https://gitcode.com/GitHub_Trending/do/dokploy准备发布新版本时你点下部署结果卡在了拉镜像那一步镜像存在公司私有仓库里Dokploy 要么提示凭据无效要么直接报 No registry found。常见误区是填了镜像名就应该能拉实际情况是Dokploy 需要先知道哪个仓库、用什么凭据才会先执行 docker login再拉取镜像。这篇指南带你从空白配置做到部署成功每一步都能对照日志确认结果。 动手前检查4 个前置条件开工前把这 4 样备齐后面每一步都会用到Dokploy 已部署并且已连接至少一台服务器服务器上 Docker 正在运行私有镜像仓库的地址、用户名、密码Docker Hub 私有仓库的密码可在其账户安全页生成访问令牌完整镜像地址格式为仓库地址/命名空间/镜像名:标签你在 Dokploy 当前组织内有新建资源和添加 Registry 的权限先在部署服务器的终端里确认凭据真的能登录成功这条命令和 Dokploy 稍后自动执行的是同一套逻辑echo 你的密码 | docker login registry.example.com -u 你的用户名 --password-stdin看到Login Succeeded就可以放心继续它对应的就是系统内部封装的登录命令 safeDockerLoginCommand。在 Dokploy 中完成私有仓库配置后部署私有镜像只需登录、拉取、启动三步 分步实操3 步完成私有镜像部署第 1 步在设置页创建私有 Registry进入 Dokploy 控制台左侧的 Settings打开 Registry 设置页对应 registry.tsx点击添加填入仓库名称、地址、用户名、密码然后保存做对了的样子保存后没有弹出任何报错新仓库出现在 Registry 列表里。此时系统已经在服务器上替你跑过一次 docker login见 createRegistry相当于测试连接和保存一步完成。两个容易踩的坑地址栏只写主机名[:端口]不要带https://校验规则见 registry 表结构用户名保留原始大小写例如 AWS ECR 的用户名必须是大写AWS注释说明第 2 步创建 Docker Image 应用并关联仓库进入 Projects点 New Application部署方式选 Docker Image填入完整镜像地址例如registry.example.com/namespace/myapp:v1在应用的 Registry 区域选中第 1 步创建的那个仓库做对了的样子应用保存后部署进入队列打开部署详情日志里先出现 docker login 的结果、紧接着开始出现镜像下载进度。拉取侧的登录命令拼接见 docker.ts。如果日志停在 login 一行且带失败信息说明凭据或地址有问题直接跳去下面的排错表。第 3 步验证部署在部署的 Logs 页确认登录通过、镜像拉取完成回到应用列表查看状态再访问服务地址做对了的样子服务状态显示为运行中部署历史里多出一条成功记录访问服务 URL 能正常返回内容。️ 排错速查拉不到镜像怎么办现象可能原因处理方法报 No registry found应用没有关联任何仓库检查逻辑见 upload.ts先完成第 1 步创建 Registry再回应用里选中它登录报 invalid credentials密码错误或地址里带了https://协议头重新核对密码地址只保留主机名和端口登录成功、拉取却权限不足该账号对目标镜像没有 pull 权限找仓库管理员给账号授权或换有权限的账号自建仓库连接超时服务器到仓库网络不通或 HTTPS 证书不受信任先在服务器上验证网络连通再核对地址与端口镜像名格式报错缺命名空间或标签按地址/命名空间/镜像名:标签写全 进阶延伸部署成功后可以让 Dokploy 把镜像推回仓库开启 Build Registry 后构建结束会自动打 tag 并 push 到指定仓库逻辑见 upload.tsRollback Registry 则额外保留上一版镜像回滚逻辑适合接 CI/CD 流水线想看更完整的部署与网络玩法读官方文档 GUIDES.md下一步行动现在就打开 Dokploy 设置页把私有仓库地址和凭据填进去保存一次——只要保存时没有弹错凭据就已经验证通过了接着新建一个 Docker Image 应用做你的首次部署。【免费下载链接】dokployOpen Source Alternative to Vercel, Netlify and Heroku.项目地址: https://gitcode.com/GitHub_Trending/do/dokploy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考