diff --git a/docs/release.md b/docs/release.md
index 21ab3d0ad..573ac9e85 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -1,5 +1,187 @@
 # Release
 
+## 2.3.1 - 2023-04-25 
+
+### 🚀 Features
+
+- feature: 新版 IP 选择器接入 (closed #1211)
+
+- feature: 订阅详情接口支持过滤现存范围内执行快照 (closed #1222)
+
+- feature: 支持 IPv6 单栈场景 (closed #1223)
+
+- feature: 支持双栈判断 pid 是否监听指定端口 (closed #1223)
+
+- feature: Agent 2.0 GSE 文件服务对接 (closed #1239)
+
+- feature: Agent / 插件状态支持 IPv4 / IPv6 混合搜索并提供 AgentID 信息 (closed #1249)
+
+- feature: 新增 BK_CC_HOST 环境变量用于前端跳转逻辑 (closed #1255)
+
+- feature: 适配 CMDB 主机寻址方式枚举值变更 (closed #1260)
+
+- feature: 安装动态寻址主机校验 Agent 存活校验及 AgentID 重置判定 (#1281)
+
+- feature:  Proxy Nginx 配置 v6 支持 (closed #1289)
+
+- feature: P-Agent 安装 IPv6 场景适配 (closed #1290)
+
+- feature:  接入点主机配置信息缺省规则 (closed #1283)
+
+- feature: 安装同时提供 IPv4 / IPv6 的填写选项 (closed #1257)
+
+- feature: 支持 upgrade_to_agent_id 升级为 AgentID 配置 (closed #1309)
+
+- feature: Agent升级功能支持 2.x -> 2.x 的升级 (close #1311)
+
+- feature:  认证信息支持递归解密 (closed #1305)
+
+- feature: Agent 升级功能问题修复（Windows 压缩工具下发，Linux 脚本 CPU 架构校验等）(close #1328)
+
+- feature:  安装 Agent 后下发主机身份 (closed #963)
+
+- feature: P-Agent 安装时更新 Agent 2.0 安装包到 Proxy (close #1315)
+
+- feature:  重启/重载/升级 Agent 后增加功能检测步骤 (closed #1338)
+
+- feature: 提供 2.0 Agent & Proxy 安装包制作能力 (closed #1176)
+
+- feature:  国际化-文本翻译补充 (closed #1332)
+
+- feature: 调用链路国际化打通 (closed #1333)
+
+- feature: 支持单次执行进程的插件导入及部署 (closed #1428)
+
+- feature: /cloud/ 接口 proxies 新增 IPv6 及 AgentID 字段 (closed #1448)
+
+- feature: 支持 IPv6 后的复制交互优化（closed #1438)
+
+- feature: 支持 ESB / APIGW 双公钥 (closed #1369)
+
+- feature: 交互规范 - 文本溢出、表格空状态 (closed #1445)
+
+- feature: 配置模板支持主机动态渲染 (closed #1466)
+
+- feature: 英文翻译校正(closed #1484)
+
+- feature:  插件调试支持按服务实例维度进行调试 (closed #1344)
+
+- feature:  插件配置公共常量支持 (closed #1500)
+
+- feature:  Agent 2.0 额外配置目录 & 传输相关配置渲染 (closed #1497)
+
+- feature:  提供导入导出工具及指引 (closed #1487)
+
+
+### ✨ Optimizations
+
+- optimization:  2.0 Agent 健康检查动作顺序调整 (closed #1226)
+
+- optimization: Excel模板动态导出(closed #1228)
+
+- optimization: Helm Charts InitContainers 容器名称去除 revision 后缀 (closed #1253)
+
+- optimization: 插件操作前置下发更新依赖脚本 (closed #471)
+
+- optimization:  插件操作前置下发更新依赖脚本 (closed #471)
+
+- optimization: IPv6 交互体验全面优化(closed #1248)
+
+- optimization: 作业平台文件源别名规范调整 (closed #1269)
+
+- optimization:  对动态寻址的相同IP主机安装Agent时的处理逻辑优化  (closed #1281)
+
+- optimization: 安装动态寻址主机校验 Agent 存活实时校验
+
+- optimization: AgentID 绑定前通过快照存储避免被同步任务刷新
+
+- optimization: 主机更新场景下同步逻辑处理优化 (closed #1282)
+
+- optimization: IPv4 / IPv6 选项必填提示优化 (closed 1308)
+
+- optimization: Windows 卸载成功状态判断逻辑优化 (closed #1345)
+
+- optimization: IPv6 场景下通过 HostID 获取作业平台主机失败详情 (closed #1366)
+
+- optimization:  云区域权限审批人调整为实例创建者 (closed #1259)
+
+- optimization: Agent、插件列表分页统一(closed #1164)
+
+- optimization: 通过安装通道/云区域非法值筛选返回全量场景优化 (closed #1508)
+
+- optimization:  主机寻址方式旧值迁移 (closed #1517)
+
+- optimization: k8s api 模块启动优化 (closed #1521)
+
+
+### 🐛 Bugfixes
+
+- bugfix:  2.0 Agent 注册及健康检查上报错误信息缺失 (closed #1180)
+
+- bugfix:  ZK 加密工具多操作系统路径判断错误 (closed #1214)
+
+- bugfix: 修复同步不到纯 IPv6 主机的问题 (fixed #1220)
+
+- bugfix: 部分场景下 IPv6 地址校验不通过 (closed #1219)
+
+- bugfix: Proxy 安装信息留空确认后样式异常 (closed #1238)
+
+- bugfix: 修复 k8s v6 单栈部署 saas-api v6 地址无监听的问题 (fixed #970)
+
+- bugfix: 资源配额 业务与模板ID相同时选中不正确 (closed #1246)
+
+- bugfix: Windows 通过 IPv6 远程执行命令报错：Can't find a valid stringBinding to connect (fixed #1251)
+
+- bugfix: 修复 2.0 Proxy 重装灰度判断错误的问题 (fixed #1272)
+
+- bugfix: 修复接入点更新后端口配置被重置 (fixed #1271)
+
+- bugfix: 调试插件时，延后渲染配置模板的文件名称 (close #1299)
+
+- bugfix:  查询主机相关订阅信息接口报错 (closed #1224)
+
+- bugfix:  升级脚本操作系统匹配规则错误 (closed #1264)
+
+- bugfix: 修复 Windows 2.0 Agent 无法卸载的问题 (fixed #1317)
+
+- bugfix: 开启 DHCP 适配时指定 Agent 2.0 安装及 AgentID 切换 (closed #1316 fixed #1269)
+
+- bugfix:  Agent 重启步骤成功但进程未启动 (closed #1334)
+
+- bugfix: 2.0 Proxy data file endpoint 渲染值有误 (fixed #1340)
+
+- bugfix: 资源配额 - 初始化一直loading (closed #1377)
+
+- bugfix: 安装表格 - 只读属性被批量修改 (closed #1372)
+
+- bugfix: 远程采集场景下报错主机不存在 (closed #830)
+
+- bugfix: 修复订阅更新接口 steps 更新不符合预期的问题 (fixed #1002)
+
+- bugfix: 修复云区域变更为直连区域后节点类型错误的问题 (fixed #1417)
+
+- bugfix: 页面权限问题修复(fixed #1413)
+
+- bugfix: 手动安装指引 - 任务历史场景覆盖(closed #1421)
+
+- bugfix: 安装通道主机状态展示异常(closed TencentBlueKing#1351)
+
+- bugfix: 修复版本标签更新指向版本无效的问题 (closed #1476)
+
+- bugfix: 复制超时增加重试操作 (closed #1482)
+
+
+### ✏️ Docs
+
+- docs:  容器化场景下新增接入点说明文档 (closed #1304)
+
+- docs:  安装通道针对 IPv6 场景配置文档更新及验证 (closed #1347)
+
+
+
+**Full Changelog**: https://github.com/TencentBlueKing/bk-nodeman/compare/v2.3.0...v2.3.1
+
+
 ## 2.3.0 - 2022-12-22 
 
 - no changes
diff --git a/release/V2.3.1_20230425.md b/release/V2.3.1_20230425.md
new file mode 100644
index 000000000..1546015fc
--- /dev/null
+++ b/release/V2.3.1_20230425.md
@@ -0,0 +1,182 @@
+
+## 2.3.1 - 2023-04-25 
+
+### 🚀 Features
+
+- feature: 新版 IP 选择器接入 (closed #1211)
+
+- feature: 订阅详情接口支持过滤现存范围内执行快照 (closed #1222)
+
+- feature: 支持 IPv6 单栈场景 (closed #1223)
+
+- feature: 支持双栈判断 pid 是否监听指定端口 (closed #1223)
+
+- feature: Agent 2.0 GSE 文件服务对接 (closed #1239)
+
+- feature: Agent / 插件状态支持 IPv4 / IPv6 混合搜索并提供 AgentID 信息 (closed #1249)
+
+- feature: 新增 BK_CC_HOST 环境变量用于前端跳转逻辑 (closed #1255)
+
+- feature: 适配 CMDB 主机寻址方式枚举值变更 (closed #1260)
+
+- feature: 安装动态寻址主机校验 Agent 存活校验及 AgentID 重置判定 (#1281)
+
+- feature:  Proxy Nginx 配置 v6 支持 (closed #1289)
+
+- feature: P-Agent 安装 IPv6 场景适配 (closed #1290)
+
+- feature:  接入点主机配置信息缺省规则 (closed #1283)
+
+- feature: 安装同时提供 IPv4 / IPv6 的填写选项 (closed #1257)
+
+- feature: 支持 upgrade_to_agent_id 升级为 AgentID 配置 (closed #1309)
+
+- feature: Agent升级功能支持 2.x -> 2.x 的升级 (close #1311)
+
+- feature:  认证信息支持递归解密 (closed #1305)
+
+- feature: Agent 升级功能问题修复（Windows 压缩工具下发，Linux 脚本 CPU 架构校验等）(close #1328)
+
+- feature:  安装 Agent 后下发主机身份 (closed #963)
+
+- feature: P-Agent 安装时更新 Agent 2.0 安装包到 Proxy (close #1315)
+
+- feature:  重启/重载/升级 Agent 后增加功能检测步骤 (closed #1338)
+
+- feature: 提供 2.0 Agent & Proxy 安装包制作能力 (closed #1176)
+
+- feature:  国际化-文本翻译补充 (closed #1332)
+
+- feature: 调用链路国际化打通 (closed #1333)
+
+- feature: 支持单次执行进程的插件导入及部署 (closed #1428)
+
+- feature: /cloud/ 接口 proxies 新增 IPv6 及 AgentID 字段 (closed #1448)
+
+- feature: 支持 IPv6 后的复制交互优化（closed #1438)
+
+- feature: 支持 ESB / APIGW 双公钥 (closed #1369)
+
+- feature: 交互规范 - 文本溢出、表格空状态 (closed #1445)
+
+- feature: 配置模板支持主机动态渲染 (closed #1466)
+
+- feature: 英文翻译校正(closed #1484)
+
+- feature:  插件调试支持按服务实例维度进行调试 (closed #1344)
+
+- feature:  插件配置公共常量支持 (closed #1500)
+
+- feature:  Agent 2.0 额外配置目录 & 传输相关配置渲染 (closed #1497)
+
+- feature:  提供导入导出工具及指引 (closed #1487)
+
+
+### ✨ Optimizations
+
+- optimization:  2.0 Agent 健康检查动作顺序调整 (closed #1226)
+
+- optimization: Excel模板动态导出(closed #1228)
+
+- optimization: Helm Charts InitContainers 容器名称去除 revision 后缀 (closed #1253)
+
+- optimization: 插件操作前置下发更新依赖脚本 (closed #471)
+
+- optimization:  插件操作前置下发更新依赖脚本 (closed #471)
+
+- optimization: IPv6 交互体验全面优化(closed #1248)
+
+- optimization: 作业平台文件源别名规范调整 (closed #1269)
+
+- optimization:  对动态寻址的相同IP主机安装Agent时的处理逻辑优化  (closed #1281)
+
+- optimization: 安装动态寻址主机校验 Agent 存活实时校验
+
+- optimization: AgentID 绑定前通过快照存储避免被同步任务刷新
+
+- optimization: 主机更新场景下同步逻辑处理优化 (closed #1282)
+
+- optimization: IPv4 / IPv6 选项必填提示优化 (closed 1308)
+
+- optimization: Windows 卸载成功状态判断逻辑优化 (closed #1345)
+
+- optimization: IPv6 场景下通过 HostID 获取作业平台主机失败详情 (closed #1366)
+
+- optimization:  云区域权限审批人调整为实例创建者 (closed #1259)
+
+- optimization: Agent、插件列表分页统一(closed #1164)
+
+- optimization: 通过安装通道/云区域非法值筛选返回全量场景优化 (closed #1508)
+
+- optimization:  主机寻址方式旧值迁移 (closed #1517)
+
+- optimization: k8s api 模块启动优化 (closed #1521)
+
+
+### 🐛 Bugfixes
+
+- bugfix:  2.0 Agent 注册及健康检查上报错误信息缺失 (closed #1180)
+
+- bugfix:  ZK 加密工具多操作系统路径判断错误 (closed #1214)
+
+- bugfix: 修复同步不到纯 IPv6 主机的问题 (fixed #1220)
+
+- bugfix: 部分场景下 IPv6 地址校验不通过 (closed #1219)
+
+- bugfix: Proxy 安装信息留空确认后样式异常 (closed #1238)
+
+- bugfix: 修复 k8s v6 单栈部署 saas-api v6 地址无监听的问题 (fixed #970)
+
+- bugfix: 资源配额 业务与模板ID相同时选中不正确 (closed #1246)
+
+- bugfix: Windows 通过 IPv6 远程执行命令报错：Can't find a valid stringBinding to connect (fixed #1251)
+
+- bugfix: 修复 2.0 Proxy 重装灰度判断错误的问题 (fixed #1272)
+
+- bugfix: 修复接入点更新后端口配置被重置 (fixed #1271)
+
+- bugfix: 调试插件时，延后渲染配置模板的文件名称 (close #1299)
+
+- bugfix:  查询主机相关订阅信息接口报错 (closed #1224)
+
+- bugfix:  升级脚本操作系统匹配规则错误 (closed #1264)
+
+- bugfix: 修复 Windows 2.0 Agent 无法卸载的问题 (fixed #1317)
+
+- bugfix: 开启 DHCP 适配时指定 Agent 2.0 安装及 AgentID 切换 (closed #1316 fixed #1269)
+
+- bugfix:  Agent 重启步骤成功但进程未启动 (closed #1334)
+
+- bugfix: 2.0 Proxy data file endpoint 渲染值有误 (fixed #1340)
+
+- bugfix: 资源配额 - 初始化一直loading (closed #1377)
+
+- bugfix: 安装表格 - 只读属性被批量修改 (closed #1372)
+
+- bugfix: 远程采集场景下报错主机不存在 (closed #830)
+
+- bugfix: 修复订阅更新接口 steps 更新不符合预期的问题 (fixed #1002)
+
+- bugfix: 修复云区域变更为直连区域后节点类型错误的问题 (fixed #1417)
+
+- bugfix: 页面权限问题修复(fixed #1413)
+
+- bugfix: 手动安装指引 - 任务历史场景覆盖(closed #1421)
+
+- bugfix: 安装通道主机状态展示异常(closed TencentBlueKing#1351)
+
+- bugfix: 修复版本标签更新指向版本无效的问题 (closed #1476)
+
+- bugfix: 复制超时增加重试操作 (closed #1482)
+
+
+### ✏️ Docs
+
+- docs:  容器化场景下新增接入点说明文档 (closed #1304)
+
+- docs:  安装通道针对 IPv6 场景配置文档更新及验证 (closed #1347)
+
+
+
+**Full Changelog**: https://github.com/TencentBlueKing/bk-nodeman/compare/v2.3.0...v2.3.1
+