MrDoc觅思文档处在不断地开发迭代中，基本上每月都会有一个新的版本发布，带来诸多Bug修复、安全漏洞修复、功能优化和功能新增。

如果你正在使用的觅思文档不是最新的版本，可以按照以下方式进行升级更新。

>i 官方推荐使用 Docker 进行部署：
> - 官方 Docker 镜像部署文档：https://doc.mrdoc.pro/doc/3958/
> - 原生部署切换 Docker 部署文档：https://doc.mrdoc.pro/doc/45499/

## 前置必看！查阅版本更新说明

强烈建议在进行版本升级之前，特别是跨多个版本升级之前，==务必详细查阅各个版本的更新说明==，以此了解是否需要对系统环境/Docker 镜像进行升级。

- 开源版版本更新说明：[https://doc.mrdoc.pro/doc/4029/](https://doc.mrdoc.pro/doc/4029/ "https://doc.mrdoc.pro/doc/4029/")
- 专业版版本更新说明：[https://doc.mrdoc.pro/doc/4030/](https://doc.mrdoc.pro/doc/4030/ "https://doc.mrdoc.pro/doc/4030/")

## 内网部署必看！

如果没有通过git拉取代码（内网环境或NAS环境常见），那么更新升级操作里面获取代码的步骤为：

- 备份配置目录`/config`和媒体文件目录`/media`；
- 下载新版本代码并覆盖旧版本代码；
- 将备份的配置和媒体文件目录覆盖到新版本代码目录里面；

## 前置必备！数据备份

>d 更新升级前务必进行数据备份，避免因升级失败导致数据丢失。

详见：https://doc.mrdoc.pro/doc/45787/

## 源码部署的升级

如果你使用的是 MrDoc 的源码进行的部署（Linux、Windows ），那么可以按照以下步骤进行升级：

> d 如果使用了虚拟环境，先激活/进入虚拟环境！！！
> 如果使用了虚拟环境，先激活/进入虚拟环境！！！
> 如果使用了虚拟环境，先激活/进入虚拟环境！！！

1. MrDoc项目目录内（manage.py文件所在的目录）拉取最新代码：
```
git fetch --all && git reset --hard origin/master && git pull
```
   
2. 更新依赖库：
```
pip install -r requirements.txt
```
   
3. 生成数据库迁移：
```
python manage.py makemigrations
```
   
4. 执行数据库迁移：
```
python manage.py migrate
```

## 官方 Docker 镜像部署的升级

详见：[Docker部署](https://doc.mrdoc.pro/doc/3958/)

>d **重要提示**
>
> 请参阅版本[更新记录](#h2-查看版本更新说明)，了解是否需要升级 Docker 镜像，如果无需升级 Docker 镜像，可直接按下述进行操作；如果有 Docker 镜像的更新，务必按[Docker 镜像升级](https://doc.mrdoc.pro/doc/3958/#h2-七、升级镜像) 进行升级

1、宿主机/容器外的MrDoc项目目录内（manage.py文件所在的目录）拉取最新代码

```
git fetch --all && git reset --hard origin/master && git pull
```

2、重启Docker容器

```
docker restart mrdoc
```

## Docker Compose 部署的升级

直接运行项目目录下的`docker-update.sh`脚本即可。

## Jonnyan Docker 部署的升级

通过 Jonnyan的`Docker镜像`部署的 MrDoc 参见其部署指南 [《Docker 部署 mrdoc》](https://www.mrdoc.fun/doc/18/)文档中关于 **“升级”** 的部分。

## 宝塔面板「Python项目管理器」1.9 部署的升级

第一步，拉取最新代码：

![](/media/202107/2021-07-22_082909.png)

第二步，更新依赖库：

```
pip install -r requirements.txt
```

第三步：执行数据库迁移：

```
python manage.py makemigrations
python manage.py migrate
```

第四步，在「Python 项目管理器」中重启 MrDoc：

![](/media/202107/2021-07-22_083209.png)

## 宝塔面板「Python项目管理器」2.x 部署的升级

>d 宝塔面板「Python 项目管理器」的2.x 版本不再需要激活虚拟环境，但是命令的执行需要直接使用虚拟环境下的`pip`、`python`等，你在执行`pip`、`python`的命令时，需要输入完成的命令路径，例如`/www/wwwroot/MrDoc/asdf3s54sd235a3sd56as3d_venv/bin/pip`

进入 MrDoc 的代码目录内。

1. MrDoc项目目录内（manage.py文件所在的目录）拉取最新代码：
```
git fetch --all && git reset --hard origin/master && git pull
```
   
2. 更新依赖库：
```
/虚拟环境路径/bin/pip install -r requirements.txt
```
   
3. 生成数据库迁移：
```
/虚拟环境路径/bin/python manage.py makemigrations
```
   
4. 执行数据库迁移：
```
/虚拟环境路径/bin/python manage.py migrate
```

第三步，在「Python 项目管理器」中重启 MrDoc：

![](/media/202107/2021-07-22_083209.png)

## 一键部署脚本部署方式的升级

1、更新代码
开源版：

```
mrdoc --update
```

专业版：

```
mrdoc --update pro
```

2、重启

开源版：
```
mrdoc --restart
```

专业版：
```
mrdoc --restart pro
```

更新升级说明 - 开源版