[笔记] 构建你的知识库：MrDoc觅思文档Windows服务器部署，填坑!!!

标签：py 配置文件 Windows manage 觅思 python 填坑 文档 MrDoc

文章目录

• 一. 环境准备
• 二. 本地初始化
• • 1. 拉取源码
  • 2. 进入项目目录
  • 2. 安装所需的第三方库
  • 3. 初始化数据库
  • 4. 创建管理员账户
  • 5. 测试运行 MrDoc
• 三. 部署到Windows服务器上
• • 1. 将编译好的源码上传到服务器
  • 2. 启动项目
  • 3. Nginx 反向代理
  • 4. (!!!) 添加 CSRF 可信赖来源配置
  • 5. 重新启动项目
  • 6. 访问

---

在当今数字化的世界中，文档管理与知识分享变得尤为重要。无论是企业内部的知识传递，还是个人学习和成长过程中的资料整理，一个高效、易用的文档管理系统都是不可或缺的。MrDoc觅思文档应运而生，它不仅提供了强大的文档管理和协作功能，还支持多种格式的文档编辑和展示，满足了用户多样化的使用需求。本文将详细介绍如何在不同的操作系统环境下搭建MrDoc，从环境准备到项目部署，帮助读者快速上手并充分利用这一工具提升工作效率。

MrDoc 官网 : MrDoc 觅思文档
MrDoc 安装手册 : 安装手册

---

一. 环境准备

操作系统：

• Windows
• Linux
• macOS

安装 Python 环境：

• Python 3.7~3.9

---

二. 本地初始化

1. 拉取源码

[笔记] Windows 上 Git 安装详细教程：从零开始，附带每个选项解析

如果你的计算机上安装有 Git 工具，那么使用 git clone 命令可以直接将 MrDoc 的源码克隆到本地计算机上，其命令为：

git clone https://gitee.com/zmister/MrDoc

2. 进入项目目录

cd MrDoc

2. 安装所需的第三方库

MrDoc 安装所需的所有第三方库均通过 requirements 文件进行了描述，打开命令行界面，在/Mrdoc/目录下，运行如下 pip 命令，即可安装所有 MrDoc 所需的第三方库：

pip install -r requirements.txt

3. 初始化数据库

在安装完所需的第三方库并配置好数据库信息之后，我们需要对数据库进行初始化。

觅思文档默认使用 sqlite 数据库进行数据存储

## 生成迁移文件
python manage.py makemigrations

## 应用迁移
python manage.py migrate

4. 创建管理员账户

python manage.py createsuperuser

输入的密码不会显示在终端，输入完成后回车即可。

5. 测试运行 MrDoc

## 不指定端口
python manage.py runserver

## 指定端口 
python manage.py runserver 8888

运行上述命令，访问本机的 IP 地址，如果出现如下图所示的页面，表示 MrDoc 已经安装成功

三. 部署到Windows服务器上

1. 将编译好的源码上传到服务器

2. 启动项目

python manage.py runserver 8888

3. Nginx 反向代理

通常情况下，你会使用同一端口（常见的 80 端口）在单个服务器上为多个 Web 应用程序提供服务，或者需要别的电脑也能访问到你的电脑上运行的 Web 应用。主流的解决方案是使用 Nginx。

编辑 nginx.conf 配置文件:

因为我是分布式配置 , 所以直接在 project_conf 文件下直接写一个 conf 就可以

server {
        listen       8899;
        server_name localhost;

        location / {
            proxy_pass http://localhost:8888/;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }

!!! proxy_pass 中的端口 一定要是你启动的端口

## 检查 nginx 配置文件是否正确
nginx -t

## 重新加载配置文件
nginx -s reload

此刻就已经可以访问了.

4. (!!!) 添加 CSRF 可信赖来源配置

修改配置文件 , 配置文件在 MrDoc\config\config.ini
!!! 不可以在服务器上用文本文档直接修改配置文件!!!

[csrf_origin]
allow = 主机名

5. 重新启动项目

python manage.py runserver 8888

6. 访问

只要配置了 CSRF 可信来源 , 就不会包403了

---

标签：py,配置文件,Windows,manage,觅思,python,填坑,文档,MrDoc
From： https://blog.csdn.net/LuChangQiu/article/details/145471523