diff --git a/docs/installation/offline_upgrade.md b/docs/installation/offline_upgrade.md
index c6cd64c82..8f9bd4055 100644
--- a/docs/installation/offline_upgrade.md
+++ b/docs/installation/offline_upgrade.md
@@ -8,12 +8,15 @@ description: MeterSphere 一站式开源持续测试平台官方文档。MeterSp
 ## 1 下载并解压安装包
 !!! ms-abstract ""
     按照本文档 [离线安装](./offline_installation.md) 步骤， 下载新版本安装包并上传解压后, 重新执行安装命令进行升级。<br>
-    【注意】如果升级版本跨度较大：如 V1.x-lts 升级至 V2.x-lts 版本，由于跨多版本新增功能较多，且 v2.8.1 之后docker 使用版本升级，升级过程建议按照升级指南操作升级： [MeterSphere 企业版1.20 LTS 至2.10 LTS 升级指南](https://kb.fit2cloud.com/?p=9a46f075-5cfe-46de-81f8-ab5278699697)。如果升级版本跨度不大，则按照下面说明升级即可。
+    【注意】如果升级版本跨度较大：如 V1.x 升级至 V2.x 最新版本，由于跨多版本新增功能较多，且 v2.8.1 之后docker 使用版本升级，升级过程建议按照升级指南操作升级： [MeterSphere 企业版1.20 LTS 至2.10 LTS 升级指南](https://kb.fit2cloud.com/?p=9a46f075-5cfe-46de-81f8-ab5278699697)。如果升级版本跨度不大，则按照下面说明升级即可。
 
 ## 2 执行安装命令
 !!! ms-abstract ""
 
     ```
+    #升级前停止服务
+    msctl stop
+
     MeterSphere 安装包下载链接: https://github.com/metersphere/metersphere/releases
 
     # 下载在线安装包
@@ -21,7 +24,7 @@ description: MeterSphere 一站式开源持续测试平台官方文档。MeterSp
     
     # 解压在线安装包
     tar -zxvf metersphere-online-installer-v2.x.y.tar.gz
-    
+
     # 进入离线部署包解压缩目录
     cd metersphere-offline-installer-v2.x.y
     
diff --git a/docs/installation/online_upgrade.md b/docs/installation/online_upgrade.md
index b1b70a16c..4eaf41a59 100644
--- a/docs/installation/online_upgrade.md
+++ b/docs/installation/online_upgrade.md
@@ -10,6 +10,9 @@ description: MeterSphere 一站式开源持续测试平台官方文档。MeterSp
 ## 1 一键升级至最新版本
 !!! ms-abstract ""
     ```
+    #升级前停止服务
+    msctl stop
+
     # 升级至最新版本
     msctl upgrade
     
@@ -20,6 +23,9 @@ description: MeterSphere 一站式开源持续测试平台官方文档。MeterSp
 ## 2 一键升级至指定版本
 !!! ms-abstract ""
     ```
+    #升级前停止服务
+    msctl stop
+    
     # 升级至指定版本
     msctl upgrade v2.x.y