热门搜索:
temporalio/server
temporalio
以工作流即代码方式构建和运行弹性应用程序的Docker镜像
20 次收藏下载次数: 0状态：社区镜像维护者：temporalio仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 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 镜像文档
镜像概述和主要用途
Temporal Server 镜像是用于生产环境部署的核心组件，需连接外部数据库（支持 Cassandra、MySQL 或 PostgreSQL，默认 Cassandra）。若需部署包含预配置数据库的 Temporal，可参考 https://hub.docker.com/r/temporalio/auto-setup 镜像。此外，Temporal 可选支持 Elasticsearch 以实现可见性功能。更多 docker-compose 示例可参考 https://github.com/temporalio/docker-compose GitHub 仓库。
核心功能和特性
- 多数据库支持：兼容 Cassandra、MySQL 8、PostgreSQL 12 作为后端存储
- Elasticsearch 集成：可选配置 Elasticsearch 实现工作流可见性，支持主/ secondary 索引
- 灵活的网络配置：支持绑定 IP、广播地址设置，适配代理或多网络环境
- 安全增强：全面的 TLS 配置（证书刷新、过期检查、客户端认证），支持 JWT 权限控制
- 监控集成：支持 statsd 和 Prometheus 指标导出，便于 observability
- 动态配置：通过 YAML 文件自定义服务参数，支持运行时调整
- 多服务端口管理：独立配置前端、匹配、历史、工作器服务的网络端口
使用场景和适用范围
- 生产环境部署：适用于需要稳定运行工作流引擎的企业级应用
- 复杂工作流管理：支持长期运行、状态ful的工作流编排，如微服务协调、数据处理管道
- 多数据库环境：可适配现有 Cassandra、MySQL 或 PostgreSQL 集群
- 可见性需求：需通过 Elasticsearch 实现工作流实例搜索、过滤和监控的场景
- 高可用架构：支持多节点部署，配合外部数据库实现数据持久化和故障恢复
详细使用方法和配置说明
环境变量配置
通用环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
DB | 指定连接的数据库类型，允许值：cassandra、mysql8、postgres12 | cassandra |
Cassandra 环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
KEYSPACE | Cassandra 键空间名称 | temporal |
CASSANDRA_SEEDS | Cassandra 主机名 | 未设置 |
CASSANDRA_PORT | Cassandra 连接端口 | 9042 |
CASSANDRA_USER | Cassandra 用户名 | 未设置 |
CASSANDRA_PASSWORD | Cassandra 密码 | 未设置 |
CASSANDRA_TLS_ENABLED | 是否启用 TLS 连接 Cassandra | false |
CASSANDRA_CERT | TLS 证书文件路径（若启用 TLS） | 未设置 |
CASSANDRA_CERT_DATA | 以数据形式传入 TLS 证书（替代文件路径） | 未设置 |
CASSANDRA_CERT_KEY | TLS 证书密钥文件路径（若启用 TLS） | 未设置 |
CASSANDRA_CERT_KEY_DATA | 以数据形式传入 TLS 证书密钥（替代文件路径） | 未设置 |
CASSANDRA_CA | CA 证书文件路径（若需要） | 未设置 |
CASSANDRA_CA_DATA | 以数据形式传入 CA 证书（替代文件路径） | 未设置 |
CASSANDRA_HOST_VERIFICATION | 是否启用 Cassandra 主机验证 | false |
CASSANDRA_HOST_NAME | Cassandra 数据库主机名 | 未设置 |
CASSANDRA_ADDRESS_TRANSLATOR | 地址转换器接口，用于将 Cassandra 节点 IP 转换为本地可访问地址 | 未设置 |
CASSANDRA_ADDRESS_TRANSLATOR_OPTIONS | 地址转换器选项，参考 https://github.com/pingidentity/cassandra-spring-boot-starter/blob/master/README.md | 未设置 |
MySQL/PostgreSQL 环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
DBNAME | 主数据库名称 | temporal |
VISIBILITY_DBNAME | 可见性数据库名称（独立于主数据库） | temporal_visibility |
VISIBILITY_DB_PORT | 可见性数据库连接端口 | MySQL: 3306，PostgreSQL: 5432 |
VISIBILITY_MYSQL_SEEDS | MySQL 可见性数据库主机名 | 未设置 |
VISIBILITY_MYSQL_USER | MySQL 可见性数据库用户名 | 未设置 |
VISIBILITY_MYSQL_PWD | MySQL 可见性数据库密码 | 未设置 |
VISIBILITY_POSTGRES_SEEDS | PostgreSQL 可见性数据库主机名 | 未设置 |
VISIBILITY_POSTGRES_USER | PostgreSQL 可见性数据库用户名 | 未设置 |
VISIBILITY_POSTGRES_PWD | PostgreSQL 可见性数据库密码 | 未设置 |
DB_PORT | 主数据库连接端口 | MySQL: 3306，PostgreSQL: 5432 |
MYSQL_SEEDS | MySQL 主机名 | 未设置 |
MYSQL_USER | MySQL 用户名 | 未设置 |
MYSQL_PWD | MySQL 密码 | 未设置 |
MYSQL_TX_ISOLATION_COMPAT | 启用 MySQL 5.7.20 之前版本兼容性 | false |
SQL_VIS_MAX_CONNS | 可见性数据库最大活跃连接数 | 10 |
SQL_VIS_MAX_IDLE_CONNS | 可见性数据库最大空闲连接数 | 10 |
SQL_VIS_MAX_CONN_TIME | 可见性数据库连接最大存活时间 | 1h |
SQL_MAX_CONNS | 主数据库最大活跃连接数 | 20 |
SQL_MAX_IDLE_CONNS | 主数据库最大空闲连接数 | 20 |
SQL_MAX_CONN_TIME | 主数据库连接最大存活时间 | 1h |
SQL_TLS_ENABLED | 是否启用 SQL 数据库 TLS 连接 | false |
SQL_CA | SQL 数据库 CA 证书路径 | 未设置 |
SQL_CERT | SQL 数据库证书路径 | 未设置 |
SQL_CERT_KEY | SQL 数据库证书密钥路径 | 未设置 |
SQL_HOST_VERIFICATION | 是否启用 SQL 主机验证 | false |
SQL_HOST_NAME | TLS 连接时验证的主机名 | 未设置 |
POSTGRES_SEEDS | PostgreSQL 主机名 | 未设置 |
POSTGRES_USER | PostgreSQL 用户名 | 未设置 |
POSTGRES_PWD | PostgreSQL 密码 | 未设置 |
POSTGRES_TLS_ENABLED | 是否启用 PostgreSQL TLS 连接 | false |
POSTGRES_TLS_DISABLE_HOST_VERIFICATION | 是否跳过 PostgreSQL 主机验证（如 Amazon RDS 环境） | false |
POSTGRES_TLS_CERT_FILE | PostgreSQL TLS 证书文件路径 | 未设置 |
POSTGRES_TLS_KEY_FILE | PostgreSQL TLS 证书密钥文件路径 | 未设置 |
POSTGRES_TLS_CA_FILE | PostgreSQL TLS CA 证书文件路径 | 未设置 |
POSTGRES_TLS_SERVER_NAME | PostgreSQL TLS 服务器主机名 | 未设置 |
Elasticsearch 环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
ENABLE_ES | 是否启用 Elasticsearch | false |
ES_SCHEME | Elasticsearch 连接协议，允许值：http、https | http |
ES_SEEDS | Elasticsearch 节点列表（逗号分隔） | 未设置 |
ES_PORT | Elasticsearch 连接端口 | 9200 |
ES_USER | Elasticsearch 用户名 | 未设置 |
ES_PWD | Elasticsearch 密码 | 未设置 |
ES_VERSION | Elasticsearch 版本 | v7 |
ES_VIS_INDEX | 可见性索引名称 | temporal_visibility_v1_dev |
ES_SEC_VIS_INDEX | secondary 可见性 索引名称 | 未设置 |
服务器配置环境变量
| 名称 | 描述 | 默认值 |
|---|---|---|
BIND_ON_IP | 前端服务绑定 IP 地址 | 127.0.0.1（本地主机） |
TEMPORAL_BROADCAST_ADDRESS | 客户端连接 IP 与 BIND_ON_IP 不同时需指定（如监听 0.0.0.0 或使用代理） | 未设置 |
PPROF_PORT | 启用 https://github.com/google/pprof 调试的端口 | 0（禁用） |
TEMPORAL_TLS_REFRESH_INTERVAL | TLS 证书刷新间隔 | 0s（不刷新） |
TEMPORAL_TLS_EXPIRATION_CHECKS_CHECK_INTERVAL | TLS 证书过期检查间隔 | 0s（不检查） |
TEMPORAL_TLS_EXPIRATION_CHECKS_WARNING_WINDOW | 证书过期警告窗口时间 | 0s |
TEMPORAL_TLS_EXPIRATION_CHECKS_ERROR_WINDOW | 证书过期错误窗口时间 | 0s |
TEMPORAL_TLS_REQUIRE_CLIENT_AUTH | 是否要求客户端（Worker、CLI、SDK）通过 TLS 认证 | false |
TEMPORAL_TLS_SERVER_CERT | 服务器 TLS 证书路径 | 未设置 |
TEMPORAL_TLS_SERVER_CERT_DATA | 服务器 TLS 证书数据（替代文件路径） | 未设置 |
TEMPORAL_TLS_SERVER_KEY | 服务器 TLS 证书密钥路径 | 未设置 |
TEMPORAL_TLS_SERVER_KEY_DATA | 服务器 TLS 证书密钥数据（替代文件路径） | 未设置 |
TEMPORAL_TLS_SERVER_CA_CERT | 服务器 CA 证书路径 | 未设置 |
TEMPORAL_TLS_SERVER_CA_CERT_DATA | 服务器 CA 证书数据（替代文件路径） | 未设置 |
TEMPORAL_TLS_INTERNODE_DISABLE_HOST_VERIFICATION | 是否跳过节点间（历史/匹配服务）主机验证 | false |
TEMPORAL_TLS_INTERNODE_SERVER_NAME | 节点间 TLS 验证的主机名 | 未设置 |
TEMPORAL_TLS_FRONTEND_CERT | 前端服务 TLS 证书路径 | 未设置 |
TEMPORAL_TLS_FRONTEND_CERT_DATA | 前端服务 TLS 证书数据（替代文件路径） | 未设置 |
TEMPORAL_TLS_FRONTEND_KEY | 前端服务 TLS 证书密钥路径 | 未设置 |
TEMPORAL_TLS_FRONTEND_KEY_DATA | 前端服务 TLS 证书密钥数据（替代文件路径） | 未设置 |
TEMPORAL_TLS_FRONTEND_DISABLE_HOST_VERIFICATION | 前端服务是否跳过主机验证 | false |
TEMPORAL_TLS_FRONTEND_SERVER_NAME | 前端服务 TLS 验证的主机名 | 未设置 |
TEMPORAL_TLS_CLIENT1_CA_CERT | 前端服务向外部客户端展示的 TLS 证书 | 未设置 |
TEMPORAL_TLS_CLIENT1_CA_CERT_DATA | 客户端 TLS 证书数据（替代文件路径） | 未设置 |
TEMPORAL_TLS_CLIENT2_CA_CERT | 额外客户端 TLS 证书 | 未设置 |
TEMPORAL_TLS_CLIENT2_CA_CERT_DATA | 额外客户端 TLS 证书数据（替代文件路径） | 未设置 |
STATSD_ENDPOINT | https://github.com/statsd/statsd 监控端点 | 未设置 |
PROMETHEUS_ENDPOINT | Prometheus 指标暴露端点（用于数据采集） | 未设置 |
PROMETHEUS_TIMER_TYPE | Prometheus 计时器指标类型，参考 文档 | histogram |
TEMPORAL_AUTH_AUTHORIZER | 授权插件 配置 | 未设置 |
TEMPORAL_AUTH_CLAIM_MAPPER | ClaimMapper 插件 配置 | 未设置 |
TEMPORAL_JWT_KEY_SOURCE1 | ClaimMapper JWT 密钥源 | 未设置 |
TEMPORAL_JWT_KEY_SOURCE2 | 额外 JWT 密钥源 | 未设置 |
TEMPORAL_JWT_KEY_REFRESH | JWT 密钥刷新间隔 | 1m |
TEMPORAL_JWT_PERMISSIONS_CLAIM | JWT 权限声明属性名 | permissions |
FRONTEND_GRPC_PORT | 前端服务 GRPC 端口 | 7233 |
FRONTEND_HTTP_PORT | 前端服务 HTTP 端口 | 7243 |
FRONTEND_MEMBERSHIP_PORT | 前端服务成员端口 | 6933 |
INTERNAL_FRONTEND_GRPC_PORT | 内部前端服务 GRPC 端口 | 7236 |
INTERNAL_FRONTEND_MEMBERSHIP_PORT | 内部前端服务成员端口 | 6936 |
MATCHING_GRPC_PORT | 匹配服务 GRPC 端口 | 7235 |
MATCHING_MEMBERSHIP_PORT | 匹配服务成员端口 | 6935 |
HISTORY_GRPC_PORT | 历史服务 GRPC 端口 | 7234 |
HISTORY_MEMBERSHIP_PORT | 历史服务成员端口 | 6934 |
WORKER_GRPC_PORT | 工作器服务 GRPC 端口 | 7239 |
WORKER_MEMBERSHIP_PORT | 工作器服务成员端口 | 6939 |
USE_INTERNAL_FRONTEND | 是否部署 https://github.com/temporalio/temporal/releases/tag/v1.20.0%EF%BC%88%E9%83%A8%E5%88%86%E8%AE%A4%E8%AF%81%E9%85%8D%E7%BD%AE%E9%9C%80%E8%A6%81%EF%BC%89 | 未设置 |
PUBLIC_FRONTEND_ADDRESS | 覆盖从 BIND_ON_IP 和 FRONTEND_GRPC_PORT 推导的公网前端地址 | 未设置 |
DYNAMIC_CONFIG_FILE_PATH | 动态配置 YAML 文件路径 | /etc/temporal/config/dynamicconfig/docker.yaml |
部署示例
1. Docker Run 命令（连接 PostgreSQL）
bashdocker run -d \ --name temporal-server \ -p 7233:7233 \ -e DB=postgres12 \ -e POSTGRES_SEEDS=postgres-host \ -e POSTGRES_USER=temporal \ -e POSTGRES_PWD=temporal-password \ -e DBNAME=temporal \ -e VISIBILITY_DBNAME=temporal_visibility \ -e BIND_ON_IP=0.0.0.0 \ temporalio/server:latest
2. Docker Compose
更多相关 Docker 镜像与资源
以下是 temporalio/server 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- vaultwarden/server Docker 镜像说明（密码管理器服务器，Bitwarden 兼容）
- rancher/server Docker 镜像说明（Rancher Server，容器管理平台，支持多集群管理）
- library/nextcloud Docker 镜像说明（Nextcloud 云存储平台，私有云解决方案，支持文件同步和协作）
- linuxserver/nextcloud Docker 镜像说明
- openmetadata/server Docker 镜像说明（OpenMetadata 服务器，数据管理和元数据平台）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull temporalio/server:<标签>
更多 server 镜像推荐
rancher/server
rancher
Rancher 1.x Server容器是用于管理Docker容器集群的服务器组件，提供容器环境的部署、管理与监控功能。
607 次收藏5000万+ 次下载
6 年前更新
airbyte/server
airbyte
暂无描述
8 次收藏1000万+ 次下载
16 天前更新
vaultwarden/server
vaultwarden
Bitwarden服务器API的Rust替代实现，包含Web Vault，兼容官方客户端，适合资源受限环境的自托管部署。
1.5千 次收藏1亿+ 次下载
25 天前更新
shokoanime/server
shokoanime
Shoko是一款动画收藏管理程序，旨在自动化管理您的动画收藏。
19 次收藏100万+ 次下载
16 天前更新
syncin/server
syncin
官方Sync-in服务器 · 安全的文件存储、共享、协作与同步平台
1 次收藏10万+ 次下载
20 天前更新
hugegraph/server
hugegraph
HugeGraph Server是一个分布式图数据库服务，包含图引擎层（提供RESTful API及Gremlin/Cypher查询支持，支持OLTP/OLAP计算）和存储层（支持多种内置存储后端并允许扩展自定义后端）。
3.6千+ 次下载
18 天前更新
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"