一、前言
大家好,我是攻城狮阿程,今天给大家分享一款自托管、私有部署的在线文档管理系统和知识库 —— MrDoc觅思文档(开源版),以下简称 MrDoc。
码字不易,喜欢我的教程欢迎各位多提建议多评论,畅所欲言,涉及破解、打倒美帝走近科学和资源分享的教程容易被和谐,也欢迎各位关注我的公众号和博客,以防走丢。
公众号:攻城狮阿程
个人博客:strider1230.cn
个人淘宝店:阿程数码
1.1 软件介绍
MrDoc 可以创建各类私有化部署的文档应用。你可以使用它进行知识管理、构建团队文库、制作产品手册以及在线教程等。
1.2 软件特点
书写便捷:支持使用「Markdown」和「富文本」创建文本文档,使用「在线表格」创建在线表格记录表格数据,文档的创作简便且高效;
沉浸阅读:在双栏式阅读界面中,你可以在左边栏快速查看和选择大纲,在右方浏览文档内容,像读书一样阅读文档,带来非凡的阅读体验;
权限管控:支持多种方式对文集、文档的浏览权限(公开、私密、指定用户可见、访问码可见)、协作权限(初级协作、高级协作)以及用户的创作权限进行控制,随心所欲对权限进行管控;
导入导出:文档导入,方便你迁移保存本地文档和第三方系统的文档。文档导出,则满足在非线上环境下的文档使用需求。(第三方系统的数据导入功能开发中);
支持全平台:除了网页Web端,还支持浏览器扩展、桌面客户端(Windows、Linux、macOS)、APP端(安卓、IOS)、小程序端,基本实现全平台和多终端同步;
素材管理:支持图片和附件的管理,支持附件格式白名单配置,支持第三方OSS存储配置,支持PDF、Office和常见文本文件的附件预览;
私有化部署:应用部署在自己的计算机设备(云服务器、本地服务器、电视盒子、群晖、极空间……)和网络中(公网、内网),数据完全自己掌握,不用担心隐私和数据泄露、SaaS产品突然停止服务;
持续更新:产品在持续地迭代开发和更新,Web 端稳定保持每月发布一个新版本的节奏,其他终端根据功能开发和 Bug 修复情况不定期进行新版本发布。
1.3 软件截图
二、部署 MrDoc 容器
2.1 下载 MrDoc 官方镜像
2.1.1 通过极空间的 Docker 管理页面下载(确保镜像源的选择:Docker Hub)
第一步:打开仓库设置界面,确保镜像源选择的是 Docker Hub;
第二步:在左侧边栏选择“镜像”,然后点击“仓库”,在搜索框内输入“mrdoc”后搜索找到红框内的官方镜像下载,下载版本选择“latest”即可。
2.1.2 通过自定义拉取功能下载
点击“自定义拉取”按钮,在弹出的对话框中输入“jonnyan404/mrdoc-alpine”拉取镜像。
2.1.3 导入其他来源获取的镜像(如极空间用户之间的闪电传)
部分用户可能没有科学上网环境,导致镜像无法远程拉取,可以通过其他下载途径进行下载,或使用极空间本身提供的闪电传、文件分享功能获取链接下载。
2.2 配置 MrDoc 镜像
第一步:双击需要使用的镜像,创建容器;
第二步:配置具体参数,需要配置的参数如下表所示,各设置项配置如下图所示,设置均完成后点击“应用”按钮完成容器创建;
设置项 | 设置值 | 备注 |
---|---|---|
启用性能限制 | 不勾选 | / |
极空间开机后自动启动此容器 | 不勾选 | / |
装载路径 (容器文件建议放固态硬盘) | /app/MrDoc/config /app/MrDoc/media | 需要设置两个路径,分别用于存放配置文件和素材 |
网络模式 | bridge | / |
端口 | 1234→10086 | TCP 协议 |
三、配置 MrDoc 程序
3.1 登录 MrDoc 前端页面
使用浏览器打开你极空间的“域名/IP : MrDoc 端口号”(本文设置的本地端口为1234与容器端口不一致,容器端口默认为10086),能够看到下图所示界面说明 MrDoc 已经部署成功。
3.2 注册 MrDoc 账号并登录
点击 MrDoc 页面右上角下拉箭头注册账号,需要注意用户名一旦注册是无法更改的,首次登录的账号具有管理员权限。
3.3 配置 MrDoc 个人账号 Token
点击 MrDoc 展示页右上角下拉箭头选择“个人中心”,进入账号管理页面后点击左侧边栏的“个人管理” -“Token 管理”得到个人账号对应的 Token 值,借助 Token ,你可以无需打开网站,即可通过更加自动化的方式进行文档编写;桌面客户端、手机 APP 和浏览器扩展均需使用此 Token 实现用户认证。(注意:一旦你选择重新生成 Token 的话,那么之前的 Token 值会失效,所有通过之前 Token 进行绑定的客户端均会登录失效。
3.4 下载 MrDoc 全平台客户端
在 MrDoc 账号管理页面点击左侧边栏的“客户端下载”菜单栏,可以看到对应平台的客户端下载途径,分别有浏览器扩展,桌面客户端和移动端 APP ,MrDoc 的整体生态如下:
Web端
浏览器扩展
桌面客户端
移动APP端
微信小程序端
四、结语
通过上述步骤,我们完成了 MrDoc 的容器化部署和基本配置。
如果你看完教程还是觉得很困难,也可以扫描下方二维码进入我的淘宝小店——阿程数码,直接购买极空间的 Docker 服务,我会远程帮你有偿部署。