
prefecthq/prefect-client-dev本镜像为Prefect工作流管理工具的客户端提供优化的Docker运行环境,专为开发场景设计。包含Prefect客户端的最新开发版本,集成未发布的功能特性,旨在为开发者提供高效的工作流开发、测试和调试环境。
prefect命令行工具及所有依赖组件,支持工作流定义、部署、执行与监控拉取并启动镜像,验证客户端版本:
bash# 拉取最新开发版镜像 docker pull prefecthq/prefect:dev-client # 启动容器并查看客户端版本 docker run -it --rm prefecthq/prefect:dev-client prefect --version
连接到本地或远程Prefect服务器(需提前部署Prefect Server或使用Prefect Cloud):
bashdocker run -it --rm \ -e PREFECT_API_URL="[***]" \ # 服务器API地址 -e PREFECT_API_KEY="your-api-key" \ # 若使用认证(如Prefect Cloud) prefecthq/prefect:dev-client \ prefect work-queue inspect "default" # 示例:查看默认工作队列信息
将本地开发的工作流代码挂载到容器中进行测试:
bashdocker run -it --rm \ -v $(pwd)/my_workflows:/app/workflows \ # 挂载本地工作流目录 -w /app/workflows \ # 设置工作目录 -e PREFECT_API_URL="[***]" \ # 连接本地主机的Prefect服务器 prefecthq/prefect:dev-client \ prefect deployment build ./my_flow.py:main_flow -n dev-test # 构建工作流部署配置
挂载本地Prefect配置目录,实现配置持久化:
bashdocker run -it --rm \ -v ~/.prefect:/root/.prefect \ # 挂载本地配置目录 prefecthq/prefect:dev-client \ prefect config set api_url="[***]" # 持久化设置API地址
| 环境变量 | 描述 | 默认值 |
|---|---|---|
PREFECT_API_URL | Prefect服务器API地址 | http://localhost:4200/api |
PREFECT_API_KEY | 访问Prefect服务器的API密钥 | 无(未认证模式) |
PREFECT_LOGGING_LEVEL | 日志输出级别 | INFO |
PREFECT_PROFILE | 使用的Prefect配置文件名称 | default |
docker pull获取最新版本~/.prefect目录,避免重复配置host.docker.internal(Docker Desktop)或宿主机IP地址


探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务