本页面为用户提供部署 MrDoc 时的服务器配置建议。

MrDoc 使用 **Django + uWSGI** 架构运行，默认开启 **4 个 uWSGI 工作进程（workers）** 并启用线程模式。服务器配置的选择将直接影响并发处理能力和整体性能。

并且根据服务器的配置自定义uWSGI的配置，详见：https://doc.mrdoc.pro/doc/45739/

---

## 1. 推荐服务器配置（按使用规模）

### ✅ **轻量级团队（10 人以内）**

适合个人或小团队、访问频率较低的场景。

| 项目      | 推荐配置      |
| ------- | --------- |
| **CPU** | 2 核       |
| **内存**  | 4GB       |
| **系统盘** | 40GB+ SSD |
| **带宽**  | ≥2 Mbps   |

说明：
在默认 4 个 uWSGI worker 的前提下，2 核 CPU 和 4GB 内存足以维持稳定运行，适合小规模协作。

---

### ✅ **中型团队（10–100 人）**

适合中等规模团队，有一定并发访问时使用。

| 项目      | 推荐配置           |
| ------- | -------------- |
| **CPU** | 4 核            |
| **内存**  | 8GB            |
| **系统盘** | 80GB–200GB SSD |
| **带宽**  | ≥5 Mbps        |

说明：
较高并发场景下，4 核 CPU 会让 uWSGI worker 有更好的吞吐能力；8GB 内存可避免文档预览、导出、附件操作时出现内存瓶颈。

---

### ✅ **大型团队或高访问场景（100+ 人）**

适用于访问密集、有大量附件、持续高并发场景。

| 项目      | 推荐配置            |
| ------- | --------------- |
| **CPU** | 8 核             |
| **内存**  | 16GB            |
| **系统盘** | 200GB–500GB SSD |
| **带宽**  | ≥10 Mbps        |

说明：
适合企业级使用，可视实际并发情况增加 uWSGI worker 数量、启用缓存或负载均衡架构。

---

## 2. 最低运行要求（可运行但不推荐）

| 项目      | 最低配置           |
| ------- | -------------- |
| **CPU** | 1 核            |
| **内存**  | 1GB            |
| **系统盘** | 20GB SSD 或 HDD |

说明：
适合个人环境，**不建议用于团队生产环境**。

---

## 3. 配置选择的参考原则

### 📌 3.1 CPU 与 uWSGI workers 的关系

MrDoc 默认：

* `workers = 4`
* `threads = 2`

一般建议：

> **CPU 核心数 ≥ uWSGI worker 数量**

若访问量较大，可适当增加 worker 数量，或在多台服务器上使用负载均衡。

---

### 📌 3.2 内存需求

每个 uWSGI worker 通常占用 **150–250MB** 左右内存，外加：

* Django 运行占用
* 数据库连接池
* 文件操作 / 内存缓存
* 系统开销

因此：

* 4GB 适合轻量使用
* 8GB 可满足中型团队
* 16GB 适合高并发场景

---

### 📌 3.3 硬盘 I/O 与附件上传

MrDoc 支持：

* 图片上传
* Office 文件
* 附件存储
* 导入 / 导出操作

因此 SSD 推荐度：⭐⭐⭐⭐⭐（强烈推荐）
如果附件较多，请预留足够磁盘空间。

---

### 📌 3.4 带宽需求

访问性能与服务器带宽直接相关：

* 少量文档：2Mbps 足够
* 若频繁上传下载：5–10Mbps 更流畅
* 部署海外机房时建议适当提升带宽

---

## 4. 常见问题（FAQ）

### Q1：用户规模和服务器该如何匹配？

可以根据以下经验公式：

> **预期同时在线人数 ÷ 3 ≈ 推荐 uWSGI worker 数 ≈ CPU 核心数**

例如：

* 预计 15 人同时在线 → 15/3 ≈ 5 → 推荐 4～6 核 CPU
* 小团队（3–5 人）→ 2 核即可稳定运行

---

### Q2：能不能使用 Docker 部署？

可以，并且我们推荐使用Docker部署。Docker 环境下配置建议不变，只需确保：

* Docker 容器内存限制 ≥ 2GB
* 数据盘做好卷挂载映射

---

### **Q3：数据库会占用很多资源吗？**

通常不会。
MrDoc 默认使用 **SQLite/**数据库，可配置使用**MySQL / MariaDB / PostgreSQL**，数据库占用取决于数据量。
如果团队较大，可以考虑把数据库独立到单独服务器。

---

## 5. 总结

| 场景       | CPU | 内存   | 硬盘              | 带宽      |
| -------- | --- | ---- | --------------- | ------- |
| **轻量团队** | 2 核 | 4GB  | 40GB SSD        | ≥2Mbps  |
| **中型团队** | 4 核 | 8GB  | 80GB–200GB SSD  | ≥5Mbps  |
| **大型团队** | 8 核 | 16GB | 200GB–500GB SSD | ≥10Mbps |

按以上规格选择服务器即可保证 MrDoc 稳定运行。

MrDoc 部署服务器配置建议