MrDoc-觅道文档(本站使用该文档管理器)


本站使用的就是MrDoc觅道文档,这个文档网站应用理论上是能装在win/Mac/linux多系统应用的。

不过我就只会宝塔Linux部署,其他我也试过了网上也有相关说明,就不再复述,只重点说明一下如何宝塔安装部署。

MrDoc简介

MrDoc 是基于 Python 开发的在线文档系统,适合作为个人和小型团队的文档、知识和笔记管理工具。支持web、桌面端、浏览器扩展以及手机app。

适用场景:个人云笔记、在线产品手册、团队内部知识库、在线电子教程等私有化部署场景。

源码地址:

安装部署方式:

提供 MrDoc 开源版和专业版完整的运行环境,需要拉取 MrDoc 代码到本地之后进行挂载使用。使用容器部署是最快捷方便的,并且我只会这个……所以……写不写这东西,我就是来水文章的……哎呀。

Docker容器部署

官方提供完整的运行环境镜像,需要拉取MrDoc代码至本地后方可进行挂载运行。配置宝塔时首先安装Docker管理器

DockerHub:zmister/mrdoc

运行环境2H2G轻量或者1H2G都可,内存太低了装不上容器。

一、简单教程

mrdoc-alpine

docker run -d --name mrdoc -p 10086:10086 jonnyan404/mrdoc-alpine
### nginx版本,更换mrdoc-alpine为mrdoc-nginx即可

默认端口:10086

默认用户:admin

默认密码:请执行 docker logs mrdoc 2>&1|grep pwd 获取[自0.6.3版本开始生效]

如果获取的默认密码无法登录,请参考 https://www.mrdoc.fun/project-1/doc-242/ 这里解决!!!

打开 http://IP:10086 即可访问。

二、进阶教程

①挂载本地目录

1.创建文件夹:

mkdir -p ~/mrdoc/media

2.运行容器

docker run -d --name mrdoc -p 10086:10086 -v ~/mrdoc:/app/MrDoc/config -v ~/mrdoc/media:/app/MrDoc/media jonnyan404/mrdoc-alpine
### nginx版本,更换mrdoc-alpine为mrdoc-nginx即可

默认端口:10086

默认用户:admin

默认密码:请执行 docker logs mrdoc 2>&1|grep pwd 获取[自0.6.3版本开始生效]

如果获取的默认密码无法登录,请参考 https://www.mrdoc.fun/project-1/doc-242/ 这里解决!!!

打开 http://IP:10086 即可访问。

②自定义映射端口

提供变量 LISTEN_PORT 用来自定义容器内端口.
如有需要,自行设置即可.

 

linux一键安装

mrdoc 一键部署脚本

优先推荐 ubuntu18+ 以上系统

使用教程

在终端中运行以下命令,可重复执行.

### github 链接(二选一)
git clone https://github.com/Jonnyan404/oh-my-mrdoc.git

### gitee 链接(二选一)
git clone https://gitee.com/jonnyan404/oh-my-mrdoc.git
---开源版---
cd oh-my-mrdoc
export mrdocport=10086;bash mrdoc.sh -i
---专业版---
cd oh-my-mrdoc
export mrdocport=10085;bash mrdoc.sh -i https://test:123456@git.mrdoc.pro/MrDoc/MrDocPro.git

部署成功后,打开 http://IP:10086 即可访问,用户密码请查看脚本提示!注意:自2021年9月7日去除nginx配置,但配置文件依然保留,供参考!

管理mrdoc

更新MrDoc

开源版:mrdoc -u

专业版:mrdoc -u pro

重启MrDoc

开源版:mrdoc --restart

专业版:mrdoc --restart pro

设置开机自启

开源版:mrdoc --enable

专业版:mrdoc --enable pro

更多管理命令:

root@raspberrypi:/opt/oh-my-mrdoc# bash mrdoc.sh -h
./mrdoc.sh [-h] [-i link] [-start pro] [-stop pro] [-status pro] [-restart pro] [-u pro] [-c] [--remove pro] [-v] [--initdb pro]
  -h, --help              Show help | 展示帮助选项
  -i, --install           To install mrdoc | 安装 mrdoc
  -start, --start         Start mrdoc | 启动 mrdoc
  -stop, --stop           Stop mrdoc | 停止 mrdoc
  -status, --status       mrdoc status | 查看 mrdoc 当前运行状态
  -restart, --restart     Restart mrdoc | 重启 mrdoc
  -u, --update            Update mrdoc version | 更新 mrdoc 源码
      --remove            Remove installed mrdoc | 卸载 mrdoc
  -c, --check             Check for update | 检查mrdoc安装脚本是否可更新
  -v, --version           Look script version | 查看脚本版本号
      --changepwd         Changepassword | 修改用户密码
      --createsu          Createsuperuser | 创建新的管理员用户
      --initdb            Initialize database | 初始化数据库,更换数据库时需要执行.

FAQ

1.部署成功后访问提示 Internet error

执行命令 mrdoc --restart 进行重启。

2.升级SQLite版本后,访问提示 Internet Error,查看日志还是显示 SQLite 版本问题

执行如下命令:

mv /usr/lib64/libsqlite3.so.0 /usr/lib64/libsqlite3.so.0_old
cp /usr/local/lib/libsqlite3.so.0 /usr/lib64/libsqlite3.so.0

3.以上方式皆无法解决,请换docker部署!


MrdT Feb. 18, 2023, 3:06 p.m. 807 收藏文档