Docker-MrDoc(觅思文档)

[MrDoc(觅思文档)](https://www.mrdoc.pro/)，私有云笔记、云文档和知识库系统
因为有多级目录，相较于`halo博客`，更加适合写产品介绍说明书，以及各种学习汇总，对比同样支持多级目录的`为知笔记`，更加适合展示与查阅
我已经决定要把博客里的学习记录转战到觅思了
跑起来，运行内存大概占用`200MB`，比 `Halo` 和 `Wiz` 要少得多

**相关链接：**
- MrDoc：https://www.mrdoc.pro/
- 官方文档：https://doc.mrdoc.pro/
  - Docker 部署：https://doc.mrdoc.pro/doc/3958/
  - 配置文件说明：https://doc.mrdoc.pro/doc/3990/
  - Nginx 反向代理：https://doc.mrdoc.pro/doc/44910/
- GitHub：https://github.com/zmister2016/MrDoc
- Gitee：https://gitee.com/zmister/MrDoc
- Docker：https://registry.hub.docker.com/r/zmister/mrdoc

## ⭐MrDoc_Docker [官方版](https://doc.mrdoc.pro/doc/3958/)
### Docker 版
```bash
mkdir MrDoc && cd MrDoc  # 创建存放目录并进入

# 拉取最新项目(二选一)，好像不拉取也可
git clone https://gitee.com/zmister/MrDoc.git  # 克隆 MrDoc项目，Gitee
git clone https://github.com/zmister2016/MrDoc.git  # 克隆 MrDoc项目，GitHub

# 注意 mrdoc官方 是没有 latest标签 的，所以我们需要手动指定版本号
docker run -d --name MrDoc -p 10085:10086 -v $PWD/MrDoc:/app/MrDoc zmister/mrdoc:v8  # 下载并运行容器

# 第一次使用时需要创建管理员账户
docker exec -it mrdoc python manage.py createsuperuser  # 根据提示自行创建
```
登录Web：`http://[IP]:10086`

### docker-compose 版
```bash
# 拉取最新项目(二选一)，好像不拉取也可
git clone https://gitee.com/zmister/MrDoc.git  # 克隆 MrDoc项目，Gitee
git clone https://github.com/zmister2016/MrDoc.git  # 克隆 MrDoc项目，GitHub

nano docker-compose.yml
docker-compose up -d  # 拉取并部署
```
`docker-compose.yml`
```yaml
services:
  mrdoc:
    image: zmister/mrdoc:v8
    container_name: mrdoc  # 自定义容器名
    ports:
      - 10085:10086  # 对外开放端口
    volumes:
      - ./MrDoc:/app/MrDoc  # 数据持久化
    # networks:
    #   - nginxui_default  # 连接网络名称(也可仅把需要反向代理的额外加入nginx)

# # 加入nginx容器所在网络(否则无法使用nginx代理)
# networks:  # 该项和 services 同级(顶格)
#   nginxui_default:  # 连接网络名称
#     external: true  # 加入网络
#     name: nginxui_default  # 网络的名称
```

### 安装指定版本
在 v0.9.x 版本时 MarkDown 编辑器做了调整(没有未保存误关闭时弹窗提示、纯编辑还有图片、编辑时代码注释无样式)，不符合我使用习惯，故需安装旧版
```bash
# git 相关操作需要进入项目执行
git tag  # 查看所有标签(版本)
git log -1  # 验证当前版本

# 已部署，并更新，需要回退
git checkout v0.8.9  # 回退指定版本

# 新部署，拉取项目指定版本(二选一)，拉取 v0.8.x 最后一个版本
git clone --branch v0.8.9 https://gitee.com/zmister/MrDoc.git  # 拉取指定版本，Gitee
git clone --branch v0.8.9 https://github.com/zmister2016/MrDoc.gi  # 拉取指定版本，GitHub

docker pull zmister/mrdoc:v8  # 使用对应的docker镜像(使用其它版本可能有问题)
# 然后正常使用该镜像部署即可
```

### MrDoc 更新
注意：`一定要是挂载本地硬盘的，不然删除容器会丢失数据`
在 [MrDoc_Docker](https://registry.hub.docker.com/r/zmister/mrdoc) 查看最新 Tags(版本)，一会更新时会用到
```bash
docker stop MrDoc && docker rm MrDoc  # 停止并删除容器
git fetch --all && git reset --hard origin/master && git pull  # 拉取最新

# 正常重新部署即可
docker run -d --name MrDoc -p 10085:10086 -v $PWD/MrDoc:/app/MrDoc zmister/mrdoc:v8  # Docker版
docker-compose up -d  # docker-compose版
```
> 我自己这个 MrDoc容器映射到主机的是 10085端口，然后通过反向代理为10086(Https)

## ~~jonnyan404_Docker 版~~
**相关链接：**
- mrdoc-alpine:：采用 runserver 方式运行 (支持 amd64/arm64 平台)
Docker：https://hub.docker.com/r/jonnyan404/mrdoc-alpine
- mrdoc-nginx：采用 uwsgi/nginx 方式运行(受限于构建源,仅支持 amd64 平台)
Docker：https://hub.docker.com/r/jonnyan404/mrdoc-nginx

```bash
# 快速部署
docker run -d --name mrdoc -p 10086:10086 -v /volume1/docker/MrDoc/:/app/MrDoc/config -v /volume1/docker/MrDoc/media/:/app/MrDoc/media jonnyan404/mrdoc-nginx

docker logs mrdoc 2>&1|grep pwd  # 查找默认用户和密码
docker exec -it mrdoc  python manage.py createsuperuser  # 重置密码，根据提示输入 账号/邮箱/密码 即可
```

### 手动更新
```bash
# 1. 数据备份(仅未挂载需要)
docker cp mrdoc:/app/MrDoc/config /tmp/config  # 备份配置
docker cp mrdoc:/app/MrDoc/media /tmp/media  # 备份数据

# 2. 升级版本
docker pull jonnyan404/mrdoc-alpine  # 注意使用的是 mrdoc-alpine 版 还是 mrdoc-nginx 版
docker stop mrdoc  && docker rm mrdoc  # 停止并删除容器
# 运行之前部署使用命令即可

# 3. 恢复数据(仅未挂载需要)
docker cp /tmp/config mrdoc:/app/MrDoc  # 还原配置
docker cp /tmp/media mrdoc:/app/MrDoc  # 还原数据
docker restart mrdoc  # 还原后要重启
```

## Nginx 反向代理
官方给到的 [Nginx 配置](https://doc.mrdoc.pro/doc/44910/) 是有点问题的，会导致进入文集页面一直转圈且无法操作，这个是从群晖里扒出来的配置示例修改版(群晖反向代理没毛病)
```bash
server {
  # 遇到 HTTP 请求发到 HTTPS 时会产生的内部错误代码 497
  listen 10086 ssl;  # 监听指定端口(IPv4)
  listen [::]:10086 ssl;  # 监听指定端口(IPv6)
  server_name 918178.xyz nas.918178.xyz _;  # 监听多个域名(_为任意域名)
  ssl_certificate /etc/nginx/ssl/*.918178.xyz_918178.xyz/fullchain.cer;
  ssl_certificate_key /etc/nginx/ssl/*.918178.xyz_918178.xyz/private.key;
  error_page 497 =307 https://$host:$server_port$request_uri;  # 返回307临时重定向(客户端应保持请求方法不变向新的地址发出请求)
  location / {  # MrDoc访问路径
    proxy_pass http://mrdoc:10086/;  # 调用容器内服务,故端口也要是容器内对应端口
    # proxy_set_header Host $host;  # 确保MrDoc能看到客户端请求域名(官方,会造成文集页面一直转圈且无法操作)
    proxy_set_header Host $http_host;  # 确保MrDoc能看到客户端请求域名(修复,MrDoc必须如此)
    proxy_set_header X-Real-IP $remote_addr;  # 把客户端的真实 IP 传递给 MrDoc
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 记录客户端通过代理的 IP 列表
    proxy_set_header REMOTE-HOST $remote_addr;  # 把客户端的真实 IP 传递给 MrDoc
    proxy_set_header X-Forwarded-Proto $scheme;  # 把客户端使用的协议（HTTP 或 HTTPS）传递给 MrDoc
    # 设置Nginx缓存
    add_header Cache-Control no-cache;  # 禁止浏览器缓存
    add_header X-Cache $upstream_cache_status;  # 显示缓存状态
    proxy_ignore_headers Set-Cookie Cache-Control expires;  # 忽略后端返回指定头
    proxy_read_timeout 300;  # 代理读取超时时间
    # 流式视频处理
    proxy_set_header Range $http_range;  # 处理视频流式播放
    proxy_set_header If-Range $http_if_range;  # 处理视频流式播放
    add_header X-Accel-Buffering no;  # 禁用Nginx缓存
  }
  # location ^~ /static/ {  # 静态资源文件缓存(需能访问到MrDoc的静态资源文件)
  #   alias /MrDoc/static/;  # 挂载MrDoc静态资源文件(各种css、js文件等),减少MrDoc请求数降低负载
  #   # 可以直接挂载到该位置,如: ../mrdoc/MrDoc/static/:/MrDoc/static
  # }
}
```