当前 Temporal Server Docker 镜像由 Canonical 提供,基于 Ubuntu 构建,接收安全更新并会滚动更新至新版本的 Temporal Server 或 Ubuntu 发行版。此仓库可免费使用,不受每用户速率限制影响。
Temporal 是一个持久化执行平台,使开发者能够构建可扩展的应用程序,而无需牺牲生产力或可靠性。Temporal Server 以弹性方式执行称为“工作流”的应用逻辑单元,可自动处理间歇性故障并重试失败的操作。
!LTS LTS 渠道提供长达 5 年的免费安全维护。
!ESM 通过 Canonical 的受限仓库,可获得长达 10 年的客户安全维护(了解更多)。
| 渠道标签 | 关联标签 | 支持期限 | 当前版本 | 架构 |
|---|---|---|---|---|
1.23.1-24.04_edge | 1-24.04_edge, 1.23-24.04_edge | 08/2025 | Temporal Server 1.23.1 基于 Ubuntu 24.04 LTS | amd64 |
track_risk |
渠道标签按稳定性排序:stable(稳定版)、candidate(候选版)、beta(测试版)、edge(边缘版)。风险较高的渠道始终隐含可用,例如若列出 beta,则也可拉取 edge;若列出 candidate,则可拉取 beta 和 edge;若列出 stable,则四个渠道均可用。镜像会按 edge → beta → candidate → stable 的顺序推进。
若您的使用场景包括商业再分发,或需要 ESM 及未列出的渠道/版本,请联系 Canonical 团队(获取联系方式 或发送邮件至 ***)。
shdocker run -d --name temporal-server-container -e TZ=UTC -p 7233:7233 -e SQL_HOST=1.2.3.4 -v /path/to/temporal/config.yaml:/etc/temporal/config/config.yaml ubuntu/temporal-server:1.23.1-24.04_edge
pebble请注意,此仓库中镜像的入口点为 Pebble(轻量级服务管理器)。pebble 进程负责启动并监控 temporal-server 进程。
Temporal Server 启动时必须提供配置文件,镜像中不包含默认配置。用户需通过以下方式提供配置:在部署的容器中添加配置文件,或挂载包含配置文件的卷到容器中。
开发环境配置文件可从 Temporal 仓库 获取。
以下是启动容器时挂载开发配置文件的步骤:
sh$ git clone [***] $ docker run -d --name temporal-server-container -e TZ=UTC -p 7233:7233 -v ./temporal/config:/etc/temporal/config -e TEMPORAL_ENVIRONMENT=development-sqlite ubuntu/temporal-server:1.23.1-24.04_edge
| 参数 | 描述 |
|---|---|
-e TEMPORAL_ROOT=/etc/temporal | Temporal 执行环境的根目录 |
-e TEMPORAL_CONFIG_DIR=config | 相对于 Temporal 根目录的配置目录路径 |
-e TEMPORAL_ENVIRONMENT=development | Temporal 运行时环境 |
-e TEMPORAL_AVAILABILITY_ZONE=some-zone | Temporal 的可用区 |
-e TEMPORAL_ALLOW_NO_AUTH=false | 是否允许无授权器(布尔值) |
-p 6933:6933 | 暴露 Temporal 前端服务成员端点 |
-p 6934:6934 | 暴露 Temporal 历史服务成员端点 |
-p 6935:6935 | 暴露 Temporal 匹配服务成员端点 |
-p 6939:6939 | 暴露 Temporal 工作器服务成员端点 |
-p 7233:7233 | 暴露 Temporal 前端服务 GRPC 端点 |
-p 7243:7243 | 暴露 Temporal 前端服务 HTTP 端点 |
-p 7234:7234 | 暴露 Temporal 历史服务 GRPC 端点 |
-p 7235:7235 | 暴露 Temporal 匹配服务 GRPC 端点 |
-p 7239:7239 | 暴露 Temporal 工作器服务 GRPC 端点 |
-v /path/to/temporal/config.yaml:/etc/temporal/config/config.yaml | Temporal Server 的本地配置文件 |
-e SQL_HOST=1.2.3.4 | temporal-sql-tool 连接的 SQL 主机名或 IP 地址 |
-e SQL_PORT=3306 | temporal-sql-tool 连接的 SQL 主机端口 |
-e SQL_USER=mysql | temporal-sql-tool 连接 SQL 主机时使用的认证用户名 |
-e SQL_PASSWORD=supersecretpassword | temporal-sql-tool 连接 SQL 主机时使用的认证密码 |
-e SQL_DATABASE=temporal | temporal-sql-tool 使用的 SQL 数据库名称 |
-e SQL_PLUGIN=mysql | temporal-sql-tool 的 SQL 插件名称 |
-e SQL_CONNECT_ATTRIBUTES | temporal-sql-tool 的 SQL 连接属性 |
-e SQL_TLS=true | 启用 temporal-sql-tool 的 SQL 连接 TLS |
-e SQL_TLS_CERT_FILE=/path/to/client.crt | temporal-sql-tool 的 SQL TLS 客户端证书路径 |
-e SQL_TLS_KEY_FILE=/path/to/client.key | temporal-sql-tool 的 SQL TLS 客户端密钥路径 |
-e SQL_TLS_CA_FILE=/path/to/client-ca.crt | temporal-sql-tool 的 SQL TLS 客户端 CA 文件 |
-e SQL_TLS_SERVER_NAME=test-server-name | temporal-sql-tool 的目标服务器名称覆盖 |
-e SQL_TLS_DISABLE_HOST_VERIFICATION=true | 禁用 temporal-sql-tool 的 TLS 主机名验证(需启用 TLS) |
-e TEMPORAL_CLI_ADDRESS=1.2.3.4:5555 | tdbg 使用的 Temporal 前端服务主机:端口 |
-e TEMPORAL_CLI_NAMESPACE=testnamespace | tdbg 使用的 Temporal 工作流命名空间 |
-e TEMPORAL_CONTEXT_TIMEOUT=10 | tdbg 的 RPC 调用上下文可选超时时间(秒) |
-e TEMPORAL_CLI_TLS_CERT=/path/to/tls.cert | tdbg 使用的 x509 证书路径 |
-e TEMPORAL_CLI_TLS_KEY=/path/to/tls.key | tdbg 使用的私钥路径 |
-e TEMPORAL_CLI_TLS_CA=/path/to/server-ca.crt | tdbg 使用的服务器 CA 证书路径 |
-e TEMPORAL_CLI_TLS_DISABLE_HOST_VERFICATION=true | 禁用 tdbg 的 TLS 主机名验证(需启用 TLS) |
调试容器:
shdocker logs -f temporal-server-container
获取交互式 shell:
shdocker exec -it temporal-server-container /bin/bash
如发现镜像缺陷或需请求特定功能,请在此提交缺陷报告:
[***]
请将缺陷标题格式化为 “temporal-server: <问题摘要>”。确保包含所使用镜像的摘要,可通过以下命令获取:
shdocker images --no-trunc --quiet ubuntu/temporal-server:<tag>
以下渠道(标签)不再更新。请升级至较新渠道,如无法升级,请联系我们。
| 跟踪 | 版本 | 生命周期结束 | 升级路径 |
|---|---|---|---|
track |

来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429