如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
当前 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 Server 启动时必须提供配置文件,镜像中不包含默认配置。用户需通过以下方式提供配置:在部署的容器中添加配置文件,或挂载包含配置文件的卷到容器中。
开发环境配置文件可从 https://github.com/temporalio/temporal/tree/main/config 获取。
以下是启动容器时挂载开发配置文件的步骤:
sh$ git clone https://github.com/temporalio/temporal $ 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 |
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务