腾讯云 Docker 部署 MrDoc (专业版) 完整更新指南

**适用场景：**

*   使用了 Docker Compose 方式部署。
    
*   使用的是 MrDoc **专业版**（需要手动替换代码包）。
    
*   操作系统为 Ubuntu/Debian 等 Linux 系统。
    
*   核心数据存放在 `/root/mrdoc` 目录下。

_注：本教程以**从 `1.5.6` 升级到 `1.6.3`** 为例。请在实际操作时，将对应数字替换为你自己真实的旧版本号和新版本号。_

* * *

### 第一阶段：防患未然 —— 备份整站数据

在进行任何升级操作前，备份是极其必要的一步，可以确保发生意外时数据不丢失。

1.  在腾讯云后台登录服务器终端。
    
2.  输入以下命令，将整个数据目录打包成一个压缩包存放在 `/root` 下：
    
    Bash
    
    ```
    tar -zcvf /root/mrdoc_backup_$(date +%Y%m%d).tar.gz /root/mrdoc
    ```
    
    _(执行完毕后，即使后面操作全部失误，使用这个备份也能瞬间还原。)_

* * *

### 第二阶段：准备新版本代码

由于 Linux 命令行下使用 `unzip` 容易出现路径不对或文件名大小写错误，强烈推荐使用\*\*腾讯云控制台自带的“网页版文件管理器”\*\*进行这一阶段的操作。

1.  **获取安装包：** 从官方渠道（QQ群/官网）下载最新专业版压缩包（如 `MrDocPro-v1.6.3.zip`）到你的个人电脑。
    
2.  **上传：** 打开腾讯云“文件管理器”网页，进入 `/root/mrdoc` 目录，将刚才下载的 `.zip` 压缩包上传到这里。
    
3.  **解压：** 在网页中右键点击该压缩包，选择**解压**。
    
4.  **重命名规范化：** 解压完成后，网页上会出现一个新的文件夹（通常叫 `MrDocPro`）。右键该文件夹选择**重命名**，将其改为直观的版本号名称，例如：**`mrdocpro_1.6.3`**。

* * *

### 第三阶段：停机与核心数据搬家

我们要将旧版本中的“数据库配置”和“媒体附件图片”原封不动地复制给新版本。

1.  **停止当前网站服务：** 回到终端命令行，进入工作目录并停止 Docker 容器（**注意：较新版本的 Docker 使用空格而不是横杠**）：
    
    Bash
    
    ```
    cd /root/mrdoc
    docker compose down
    ```
    
    _(此时你的网站将暂时无法访问。)_
    
2.  **迁移核心数据文件夹：** 依次执行下面两条复制命令，把旧文件夹（`1.5.6`）里的数据复制到新文件夹（`1.6.3`）中：
    
    Bash
    
    ```
    # 1. 复制数据库与配置文件
    cp -a /root/mrdoc/mrdocpro_1.5.6/config /root/mrdoc/mrdocpro_1.6.3/
    
    # 2. 复制文章图片与附件
    cp -a /root/mrdoc/mrdocpro_1.5.6/media /root/mrdoc/mrdocpro_1.6.3/
    ```

* * *

### 第四阶段：修改配置并重启

告诉 Docker 以后请使用新的文件夹来运行程序。

1.  **修改配置文件：** 回到网页版**文件管理器**，双击打开 `/root/mrdoc/compose.yaml` 文件。
    
2.  找到最下方 `volumes` 挂载参数所在的位置，将旧版本号修改为新版本号。
    
    *   修改前：`- ./mrdocpro_1.5.6:/app/MrDoc`
        
    *   **修改后：`- ./mrdocpro_1.6.3:/app/MrDoc`**
        
3.  点击页面上的**保存**并关闭文件。
    
4.  **正式启动新版本：** 回到终端命令行，输入启动命令：
    
    Bash
    
    ```
    docker compose up -d
    ```
    
    等待屏幕输出绿色的 `Started` 或 `Running`，即表示启动成功！