开源文库系统moredoc

news2025/1/21 1:03:37

在这里插入图片描述

什么是 moredoc ？

moredoc 中文名 魔豆文库，是基于 golang 开发的类似百度文库、新浪爱问文库的开源文库系统，支持 TXT、PDF、EPUB、MOBI、Office 等格式文档的在线预览与管理，为 dochub 文库(github, gitee ）的重构版本。

如果不想自己搭建，可以去官方搭建的演示站点体验

网址：https://moredoc.mnt.ltd
账号：admin
密码：mnt.ltd

建数据库

老苏用了群晖自带的 MariaDB 10 数据库。

在这里插入图片描述

在 phpMyAdmin 中创建名为 moredoc 的空数据库。

为便于说明，假设数据库密码为 123456

在这里插入图片描述

所以根据上面的设置，最后得到的数据库相关的参数如下：

数据库主机：192.168.0.197，与群晖主机 IP 一致；
数据库端口：3307
数据库用户：moredoc
数据库密码：123456
数据库库名：moredoc，因为勾选了与用户同名；

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 moredoc ，选择第一个 bluezealot/moredoc，版本选择 latest。

老苏折腾时，latest 对应版本为 Linux_ce_v1.3.0 ，本文发布时，已经是 Linux_ce_v1.4.0

在这里插入图片描述

镜像比较大

在这里插入图片描述

卷

在 docker 文件夹中，创建一个新文件夹 moredoc，并在其中建三个子文件夹 cache、document 和 uploads

在这里插入图片描述

要修改目录的所有者，否则上传文件时，会出现类似下面👇的报错

《音视频会议直播解决方案.pptx》open cache/uploads/2023/06/29/97e5b4e5-5c14-4b55-88d1-f7cf95cfbaf5.pptx: no such file or directory

但是这个用户 moredoc 和分组 moredoc 在群晖中并不存在，所以老苏用 SSH 客户端命令行登录到群晖，执行

# 进入 moredoc 目录
cd /volume1/docker/moredoc

# 设置目录权限
chown 1001:1001 {cache,document,uploads}

在这里插入图片描述

文件夹	装载路径	说明
`docker/moredoc/cache`	`/home/moredoc/workspace/cache`	缓存
`docker/moredoc/document`	`/home/moredoc/workspace/documents`	文档
`docker/moredoc/uploads`	`/home/moredoc/workspace/uploads`	上传

在这里插入图片描述

端口

本地端口不冲突就行，不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号

本地端口	容器端口
`18880`	`8880`

在这里插入图片描述

环境

可变	值
`MYSQL_CONNECTION`	数据库链接地址，默认值为 `dummy`

在这里插入图片描述

其中数据库链接地址的说明👇如下：

MYSQL_CONNECTION="db_user:db_password@tcp(db_host:db_port)/db_name?charset=utf8mb4&loc=Local&parseTime=true"

db_user：数据库用户，这里是 moredoc
db_password：数据库密码，这里是 123456
db_host：数据库主机，这里是 192.168.0.197，也就是群晖主机 IP
db_port：数据库端口，这里是 3307
db_name：数据库库名，这里是 moredoc

所以最终的数据库链接地址为

MYSQL_CONNECTION="moredoc:123456@tcp(192.168.0.197:3307)/moredoc?charset=utf8mb4&loc=Local&parseTime=true"

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 moredoc 和 子目录
mkdir -p /volume1/docker/moredoc/{cache,document,uploads}

# 进入 moredoc 目录
cd /volume1/docker/moredoc

# 设置目录权限
chown 1001:1001 {cache,document,uploads}

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name moredoc \
   -p 18880:8880 \
   -v $(pwd)/cache:/home/moredoc/workspace/cache \
   -v $(pwd)/document:/home/moredoc/workspace/documents \
   -v $(pwd)/uploads:/home/moredoc/workspace/uploads \
   -e MYSQL_CONNECTION="moredoc:123456@tcp(192.168.0.197:3307)/moredoc?charset=utf8mb4&loc=Local&parseTime=true" \
   bluezealot/moredoc:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  moredoc:
    image: bluezealot/moredoc
    container_name: moredoc
    restart: unless-stopped
    ports:
      - 18880:8880
    volumes:
      - ./cache:/home/moredoc/workspace/cache
      - ./document:/home/moredoc/workspace/documents
      - ./uploads:/home/moredoc/workspace/uploads
    environment:
      - MYSQL_CONNECTION=moredoc:123456@tcp(192.168.0.197:3307)/moredoc?charset=utf8mb4&loc=Local&parseTime=true

然后执行下面的命令

# 新建文件夹 moredoc 和 子目录
mkdir -p /volume1/docker/moredoc/{cache,document,uploads}

# 进入 moredoc 目录
cd /volume1/docker/moredoc

# 设置目录权限
chown 1001:1001 {cache,document,uploads}

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d