MrDoc 支持在 Windows 系统中进行部署，适用于个人电脑、内网服务器以及 Windows Server 等环境。

目前提供以下两种部署方式：

* **Waitress 部署**：直接使用 Python + Waitress 运行 MrDoc，配置简单，适合个人用户和一般内网环境。
* **Windows 部署面板**：通过 Windows 面板完成 Python 环境、Web 服务等配置，适合习惯使用可视化管理面板的用户。

## 选择合适的部署方式

| 部署方式             | 推荐场景             | 难度 | 特点           |
| ---------------- | ---------------- | -- | ------------ |
| **Waitress 部署**  | 个人电脑、内网服务器、轻量级部署 | ⭐⭐ | 配置简单、依赖较少    |
| **Windows 部署面板** | 希望使用可视化面板管理服务器   | ⭐⭐ | 图形化管理，操作更加直观 |

如果你熟悉 Windows 命令行和 Python，**推荐优先使用 Waitress 部署**。

如果你希望通过图形化界面管理 Python 项目、网站和服务，可以选择 **Windows 部署面板**。

## 部署前准备

在开始部署之前，请确认服务器满足以下基本条件：

* Windows 10 / Windows 11 或 Windows Server 等 Windows 系统
* 建议使用 64 位系统
* 具备管理员权限
* 已准备好 MrDoc 安装包
* 确保 MrDoc 使用的端口未被其他程序占用

如果需要让其他电脑访问 MrDoc，还需要根据实际网络环境开放对应端口。

> 如果仅在本机使用，可以直接通过 `127.0.0.1` 访问；如果需要局域网内其他设备访问，则需要使用服务器的局域网 IP 地址。

## 部署方式

### 使用 Waitress 部署

Waitress 是一个适用于 Windows 的 Python WSGI 服务器，可以直接运行 MrDoc。

这种方式不需要额外安装 Linux 环境或 Docker，适合希望以较少组件运行 MrDoc 的用户。

👉 **[使用 Waitress 部署](/d/waitress-deploy/)**

### 使用 Windows 部署面板

如果你更习惯使用图形化管理工具，可以使用 Windows 部署面板完成 MrDoc 的部署。

👉 **[Windows 部署面板](/d/windows-deploy-panel/)**

## 部署完成后

MrDoc 成功启动后，可以通过浏览器访问：

```text
http://服务器IP:端口/
```

例如：

```text
http://127.0.0.1:10086/
```

首次访问后，可以根据页面提示完成管理员账号等初始化配置。

如果需要让其他设备访问，请将 `127.0.0.1` 替换为服务器实际 IP 地址，例如：

```text
http://192.168.1.100:10086/
```

## 数据与配置

MrDoc 部署后，请注意保存好以下内容：

* MrDoc 配置文件
* 数据库
* `media` 目录
* 其他由实际部署方式产生的数据目录

其中 `media` 目录通常用于保存用户上传的图片、附件等文件。

**升级 MrDoc 或迁移服务器之前，请务必先进行数据备份。**

> 不建议直接删除旧版本目录后重新部署，否则可能导致数据库、上传文件或自定义配置丢失。

## MrDoc 升级

MrDoc 更新版本后，可以根据当前使用的部署方式进行升级。

升级前建议：

1. 备份数据库。
2. 备份 `media` 目录。
3. 备份自定义配置。
4. 停止正在运行的 MrDoc 服务。
5. 使用新版本程序替换旧版本程序。
6. 根据新版本说明执行必要的升级操作。
7. 重新启动 MrDoc。
8. 检查网站、登录、文档和附件是否正常。

不同部署方式的具体升级步骤，请参考对应的部署文档。

## 常见问题

### 浏览器无法访问 MrDoc

请依次检查：

1. MrDoc 服务是否正常运行。
2. 访问地址和端口是否正确。
3. Windows 防火墙是否允许该端口访问。
4. 如果从其他电脑访问，请确认服务器 IP 地址正确。
5. 检查端口是否已经被其他程序占用。

### 本机可以访问，其他电脑无法访问

如果本机可以通过：

```text
http://127.0.0.1:端口/
```

访问，而其他电脑无法访问，通常需要检查：

* MrDoc 是否监听了正确的网络地址；
* Windows 防火墙是否放行对应端口；
* 客户端和服务器是否处于可以互相访问的网络中。

### 修改配置后没有生效

修改 MrDoc 配置后，通常需要重新启动 MrDoc 服务才能使配置生效。

如果使用面板部署，请通过面板重新启动对应服务；如果使用 Waitress，则重新启动运行 MrDoc 的进程或服务。

## 进一步阅读

* [Waitress 部署](/d/waitress-deploy/)
* [Windows 部署面板](/d/windows-deploy-panel/)
* [MrDoc 配置说明](/d/configuration/)
* [MrDoc 升级指南](/d/opensource-upgrade-guide/)
* [数据备份与恢复](/d/data-security/)

Windows 部署 MrDoc