支持的运行时和 SDK 版本

运行时和 SDK 版本支持以及升级策略

简介

本主题详细介绍了 Dapr 版本的支持版本、升级策略，以及如何在所有 Dapr 仓库（运行时、CLI、SDK 等）的 1.x 及以上版本中传达弃用和重大更改。

Dapr 版本使用 MAJOR.MINOR.PATCH 版本控制。例如，1.0.0。

版本控制描述
MAJOR当运行时发生不向后兼容的更改（例如 API 更改）时更新。当发生被认为重要的功能添加/更改需要与先前版本区分时，也可能发生 MAJOR 版本发布。
MINOR作为定期发布节奏的一部分更新，包括新功能、错误和安全修复。
PATCH针对关键问题（P0）和安全热修复进行递增。

支持的版本意味着：

  • 如果版本存在关键问题（如主线中断场景或安全问题），则会发布热修复补丁。每个问题都会根据具体情况进行审查。
  • 会对支持的版本调查问题。如果版本不再受支持，您需要升级到较新的版本并确定问题是否仍然相关。

从 1.8.0 版本开始，支持三个（3）版本的 Dapr；当前版本和前两个（2）版本。通常是 MINOR 版本更新。这意味着支持的版本有一个向前移动的滚动窗口，保持与这些受支持版本的最新状态是您的运营责任。如果您使用的是较旧版本的 Dapr，您可能需要进行中间升级才能到达受支持的版本。

主要.次要版本发布之间至少有 13 周（3 个月）的时间，为用户从非支持版本升级提供至少 9 个月的滚动窗口。有关发布流程的更多详细信息，请阅读发布周期和节奏

补丁支持适用于支持的版本（当前和先前版本）。

构建变体

Dapr 的边车镜像发布到 GitHub Container Registry 和 Docker Registry。默认镜像包含所有组件。从 1.11 版本开始，Dapr 还提供了一种边车镜像变体，仅包含稳定组件。

  • 默认边车镜像：daprio/daprd:<version> 或 ghcr.io/dapr/daprd:<version>（例如 ghcr.io/dapr/daprd:1.11.1）
  • 稳定组件边车镜像：daprio/daprd:<version>-stablecomponents 或 ghcr.io/dapr/daprd:<version>-stablecomponents（例如 ghcr.io/dapr/daprd:1.11.1-stablecomponents）

在 Kubernetes 上，可以使用 dapr.io/sidecar-image 注解覆盖应用程序 Deployment 资源的边车镜像。有关 Dapr 的参数和注解 的更多信息。如果未指定，则使用默认的 ‘daprio/daprd:latest’ 镜像。

了解有关 Dapr 组件认证生命周期 的更多信息。

支持的版本

下表显示已经过一起测试并构成"打包"版本的 Dapr 版本。不支持任何其他版本组合。

发布日期运行时CLISDK仪表盘状态发布说明
2026 年 3 月 19 日1.17.2
1.17.0Java 1.17.0
Go 1.14.2
PHP 1.2.0
Python 1.17.0
.NET 1.17.5
JS 3.6.0
Rust 0.17.0		0.15.0支持（当前）v1.17.2 发布说明
2026 年 3 月 9 日1.17.1
1.17.0Java 1.17.0
Go 1.14.1
PHP 1.2.0
Python 1.17.0
.NET 1.17.3
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.17.1 发布说明
2026 年 2 月 26 日1.17.0
1.17.0Java 1.17.0
Go 1.14.0
PHP 1.2.0
Python 1.17.0
.NET 1.17.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.17.0 发布说明
2026 年 2 月 12 日1.16.9
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.9 发布说明
2026 年 1 月 26 日1.16.8
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.8 发布说明
2026 年 1 月 20 日1.16.7
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.7 发布说明
2026 年 1 月 20 日1.16.7
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.7 发布说明
2026 年 1 月 9 日1.16.6
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.6 发布说明
2025 年 12 月 19 日1.16.5
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.5 发布说明
2025 年 12 月 8 日1.16.4
1.16.5Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.4 发布说明
2025 年 11 月 21 日1.16.3
1.16.4Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.3 发布说明
2025 年 10 月 30 日1.16.2
1.16.3Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.2 发布说明
2025 年 10 月 6 日1.16.1
1.16.1Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.1 发布说明
2025 年 9 月 16 日1.16.0
1.16.0Java 1.16.0
Go 1.13.0
PHP 1.2.0
Python 1.16.0
.NET 1.16.0
JS 3.6.0
Rust 0.17.0		0.15.0支持v1.16.0 发布说明
2025 年 9 月 17 日1.15.12
1.15.0Java 1.14.2, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.12 发布说明
2025 年 8 月 28 日1.15.11
1.15.0Java 1.14.2, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.11 发布说明
2025 年 8 月 21 日1.15.10
1.15.0Java 1.14.2, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.10 发布说明
2025 年 7 月 31 日1.15.9
1.15.0Java 1.14.2, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.9 发布说明
2025 年 7 月 18 日1.15.8
1.15.0Java 1.14.2, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.8 发布说明
2025 年 7 月 16 日1.15.7
1.15.0Java 1.14.1, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.7 发布说明
2025 年 6 月 20 日1.15.6
1.15.0Java 1.14.1, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.6 发布说明
2025 年 5 月 5 日1.15.5
1.15.0Java 1.14.1, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.5 发布说明
2025 年 4 月 4 日1.15.4
1.15.0Java 1.14.0, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.4 发布说明
2025 年 3 月 5 日1.15.3
1.15.0Java 1.14.0, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.4
JS 3.5.2
Rust 0.16.1		0.15.0支持v1.15.3 发布说明
2025 年 3 月 3 日1.15.2
1.15.0Java 1.14.0, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.0
JS 3.5.0
Rust 0.16		0.15.0支持v1.15.2 发布说明
2025 年 2 月 28 日1.15.1
1.15.0Java 1.14.0, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.0
JS 3.5.0
Rust 0.16		0.15.0支持v1.15.1 发布说明
2025 年 2 月 27 日1.15.0
1.15.0Java 1.14.0, 1.15.0
Go 1.12.0
PHP 1.2.0
Python 1.15.0
.NET 1.15.0
JS 3.5.0
Rust 0.16		0.15.0支持v1.15.0 发布说明
2024 年 9 月 16 日1.14.4
1.14.1Java 1.12.0
Go 1.11.0
PHP 1.2.0
Python 1.14.0
.NET 1.14.0
JS 3.3.1		0.15.0不支持v1.14.4 发布说明
2024 年 9 月 13 日1.14.3
1.14.1Java 1.12.0
Go 1.11.0
PHP 1.2.0
Python 1.14.0
.NET 1.14.0
JS 3.3.1		0.15.0⚠️ 已召回v1.14.3 发布说明
2024 年 9 月 6 日1.14.2
1.14.1Java 1.12.0
Go 1.11.0
PHP 1.2.0
Python 1.14.0
.NET 1.14.0
JS 3.3.1		0.15.0不支持v1.14.2 发布说明
2024 年 8 月 14 日1.14.1
1.14.1Java 1.12.0
Go 1.11.0
PHP 1.2.0
Python 1.14.0
.NET 1.14.0
JS 3.3.1		0.15.0不支持v1.14.1 发布说明
2024 年 8 月 14 日1.14.0
1.14.0Java 1.12.0
Go 1.11.0
PHP 1.2.0
Python 1.14.0
.NET 1.14.0
JS 3.3.1		0.15.0不支持v1.14.0 发布说明
2024 年 5 月 29 日1.13.4
1.13.0Java 1.11.0
Go 1.10.0
PHP 1.2.0
Python 1.13.0
.NET 1.13.0
JS 3.3.0		0.14.0不支持v1.13.4 发布说明
2024 年 5 月 21 日1.13.3
1.13.0Java 1.11.0
Go 1.10.0
PHP 1.2.0
Python 1.13.0
.NET 1.13.0
JS 3.3.0		0.14.0不支持v1.13.3 发布说明
2024 年 4 月 3 日1.13.2
1.13.0Java 1.11.0
Go 1.10.0
PHP 1.2.0
Python 1.13.0
.NET 1.13.0
JS 3.3.0		0.14.0不支持v1.13.2 发布说明
2024 年 3 月 26 日1.13.1
1.13.0Java 1.11.0
Go 1.10.0
PHP 1.2.0
Python 1.13.0
.NET 1.13.0
JS 3.3.0		0.14.0不支持v1.13.1 发布说明
2024 年 3 月 6 日1.13.0
1.13.0Java 1.11.0
Go 1.10.0
PHP 1.2.0
Python 1.13.0
.NET 1.13.0
JS 3.3.0		0.14.0不支持v1.13.0 发布说明
2024 年 1 月 17 日1.12.4
1.12.0Java 1.10.0
Go 1.9.1
PHP 1.2.0
Python 1.12.0
.NET 1.12.0
JS 3.2.0		0.14.0不支持v1.12.4 发布说明
2024 年 1 月 2 日1.12.3
1.12.0Java 1.10.0
Go 1.9.1
PHP 1.2.0
Python 1.12.0
.NET 1.12.0
JS 3.2.0		0.14.0不支持v1.12.3 发布说明
2023 年 11 月 18 日1.12.2
1.12.0Java 1.10.0
Go 1.9.1
PHP 1.2.0
Python 1.12.0
.NET 1.12.0
JS 3.2.0		0.14.0不支持v1.12.2 发布说明
2023 年 11 月 16 日1.12.1
1.12.0Java 1.10.0
Go 1.9.1
PHP 1.2.0
Python 1.12.0
.NET 1.12.0
JS 3.2.0		0.14.0不支持v1.12.1 发布说明
2023 年 10 月 11 日1.12.0
1.12.0Java 1.10.0
Go 1.9.0
PHP 1.1.0
Python 1.11.0
.NET 1.12.0
JS 3.1.2		0.14.0不支持v1.12.0 发布说明
2023 年 11 月 18 日1.11.6
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.6 发布说明
2023 年 11 月 3 日1.11.5
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.5 发布说明
2023 年 10 月 5 日1.11.4
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.4 发布说明
2023 年 8 月 31 日1.11.3
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.3 发布说明
2023 年 7 月 20 日1.11.2
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.2 发布说明
2023 年 6 月 22 日1.11.1
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.1 发布说明
2023 年 6 月 12 日1.11.0
1.11.0Java 1.9.0
Go 1.8.0
PHP 1.1.0
Python 1.10.0
.NET 1.11.0
JS 3.1.0		0.13.0不支持v1.11.0 发布说明
2023 年 11 月 18 日1.10.10
1.10.0Java 1.8.0
Go 1.7.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 3.0.0		0.11.0不支持
2023 年 7 月 20 日1.10.9
1.10.0Java 1.8.0
Go 1.7.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 3.0.0		0.11.0不支持
2023 年 6 月 22 日1.10.8
1.10.0Java 1.8.0
Go 1.7.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 3.0.0		0.11.0不支持
2023 年 5 月 15 日1.10.7
1.10.0Java 1.8.0
Go 1.7.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 3.0.0		0.11.0不支持
2023 年 5 月 12 日1.10.6
1.10.0Java 1.8.0
Go 1.7.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 3.0.0		0.11.0不支持
2023 年 4 月 13 日1.10.5
1.10.0Java 1.8.0
Go 1.6.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 3.0.0		0.11.0不支持
2023 年 3 月 16 日1.10.4
1.10.0Java 1.8.0
Go 1.6.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 2.5.0		0.11.0不支持
2023 年 3 月 14 日1.10.3
1.10.0Java 1.8.0
Go 1.6.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 2.5.0		0.11.0不支持
2023 年 2 月 24 日1.10.2
1.10.0Java 1.8.0
Go 1.6.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 2.5.0		0.11.0不支持
2023 年 2 月 20 日1.10.1
1.10.0Java 1.8.0
Go 1.6.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 2.5.0		0.11.0不支持
2023 年 2 月 14 日1.10.0
1.10.0Java 1.8.0
Go 1.6.0
PHP 1.1.0
Python 1.9.0
.NET 1.10.0
JS 2.5.0		0.11.0不支持
2022 年 12 月 2 日1.9.5
1.9.1Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.3
.NET 1.9.0
JS 2.4.2		0.11.0不支持
2022 年 11 月 17 日1.9.4
1.9.1Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.3
.NET 1.9.0
JS 2.4.2		0.11.0不支持
2022 年 11 月 4 日1.9.3
1.9.1Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.3
.NET 1.9.0
JS 2.4.2		0.11.0不支持
2022 年 11 月 1 日1.9.2
1.9.1Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.1
.NET 1.9.0
JS 2.4.2		0.11.0不支持
2022 年 10 月 26 日1.9.1
1.9.1Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.1
.NET 1.9.0
JS 2.4.2		0.11.0不支持
2022 年 10 月 13 日1.9.0
1.9.1Java 1.7.0
Go 1.6.0
PHP 1.1.0
Python 1.8.3
.NET 1.9.0
JS 2.4.2		0.11.0不支持
2022 年 10 月 26 日1.8.6
1.8.1Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 10 月 13 日1.8.5
1.8.1Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 8 月 10 日1.8.4
1.8.1Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 7 月 29 日1.8.3
1.8.0Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 7 月 21 日1.8.2
1.8.0Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 7 月 20 日1.8.1
1.8.0Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 7 月 7 日1.8.0
1.8.0Java 1.6.0
Go 1.5.0
PHP 1.1.0
Python 1.7.0
.NET 1.8.0
JS 2.3.0		0.11.0不支持
2022 年 10 月 26 日1.7.5
1.7.0Java 1.5.0
Go 1.4.0
PHP 1.1.0
Python 1.6.0
.NET 1.7.0
JS 2.2.1		0.10.0不支持
2022 年 5 月 31 日1.7.4
1.7.0Java 1.5.0
Go 1.4.0
PHP 1.1.0
Python 1.6.0
.NET 1.7.0
JS 2.2.1		0.10.0不支持
2022 年 5 月 17 日1.7.3
1.7.0Java 1.5.0
Go 1.4.0
PHP 1.1.0
Python 1.6.0
.NET 1.7.0
JS 2.2.1		0.10.0不支持
2022 年 4 月 22 日1.7.2
1.7.0Java 1.5.0
Go 1.4.0
PHP 1.1.0
Python 1.6.0
.NET 1.7.0
JS 2.1.0		0.10.0不支持
2022 年 4 月 20 日1.7.1
1.7.0Java 1.5.0
Go 1.4.0
PHP 1.1.0
Python 1.6.0
.NET 1.7.0
JS 2.1.0		0.10.0不支持
2022 年 4 月 7 日1.7.0
1.7.0Java 1.5.0
Go 1.4.0
PHP 1.1.0
Python 1.6.0
.NET 1.7.0
JS 2.1.0		0.10.0不支持
2022 年 4 月 20 日1.6.2
1.6.0Java 1.4.0
Go 1.3.1
PHP 1.1.0
Python 1.5.0
.NET 1.6.0
JS 2.0.0		0.9.0不支持
2022 年 3 月 25 日1.6.1
1.6.0Java 1.4.0
Go 1.3.1
PHP 1.1.0
Python 1.5.0
.NET 1.6.0
JS 2.0.0		0.9.0不支持
2022 年 1 月 25 日1.6.0
1.6.0Java 1.4.0
Go 1.3.1
PHP 1.1.0
Python 1.5.0
.NET 1.6.0
JS 2.0.0		0.9.0不支持

SDK 兼容性

除安全问题所需的更改外，SDK 和运行时承诺不做重大更改。所有重大更改（如有）都会在发布说明中宣布。

SDK 和运行时向前兼容性
较新的 Dapr SDK 支持 Dapr 运行时的最新版本和前两个版本（N-2）。

SDK 和运行时向后兼容性
对于新的 Dapr 运行时，支持当前的 SDK 版本和前两个版本（N-2）。

升级路径

运行时 1.0 版本发布后，可能需要通过其他版本显式升级才能达到所需的目标版本。例如，从 v1.0 升级到 v1.2 可能需要通过 v1.1。

下表显示了 Dapr 运行时的已测试升级路径。任何其他升级组合均未经过测试。

有关升级的一般指南，请参阅自托管模式和 Kubernetes部署。最好查看目标版本的发布说明以获取具体指南。

当前运行时版本必须通过以下版本升级目标运行时版本
1.5.0 到 1.5.2N/A1.6.0
1.6.01.6.2
1.6.21.7.5
1.7.51.8.6
1.8.61.9.6
1.9.61.10.7
1.6.0 到 1.6.2N/A1.7.5
1.7.51.8.6
1.8.61.9.6
1.9.61.10.7
1.7.0 到 1.7.5N/A1.8.6
1.8.61.9.6
1.9.61.10.7
1.8.0 到 1.8.6N/A1.9.6
1.9.0 到 1.9.6N/A1.10.8
1.10.0 到 1.10.8N/A1.11.4
1.11.0 到 1.11.4N/A1.12.4
1.12.0 到 1.12.4N/A1.13.5
1.13.0 到 1.13.5N/A1.14.0
1.14.0 到 1.14.4N/A1.14.4
1.15.0 到 1.15.12N/A1.16.9
1.16.0 到 1.16.9N/A1.17.2

在托管平台上升级

Dapr 可以支持生产环境的多个托管平台。在 1.0 版本中，两个受支持的平台是 Kubernetes 和物理机。有关 Kubernetes 升级，请参阅 Kubernetes 上的生产指南

依赖项的受支持版本

以下是最新版本的 Dapr（v1.17.7）已测试的软件列表。

依赖项支持的版本
KubernetesDapr 对 Kubernetes 的支持与 Kubernetes 版本偏差策略 一致
Open Telemetry collector (OTEL)v0.101.0
Prometheusv2.28

相关链接