ubuntu/temporal-server当前 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 |

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务