群晖部署魔豆moredoc开源知识库

魔豆moredoc简介

moredoc - 魔豆文库，使用 Golang 开发的类似百度文库、新浪爱问文库的开源文库系统解决方案，支持 TXT、PDF、EPUB、MOBI、Office 等格式文档的在线预览与管理，为 dochub文库( github, gitee )的重构版本。

部署方式1

• 默认管理账号：admin 密码：mnt.ltd

1、从github下载最新包https://github.com/mnt-ltd/moredoc/releases

2、将压缩包上传到自定义目录

#新建文件夹
mkdir -p /volume1/docker/moredoc/server
#解压缩，确保当前目录在压缩包所在目录
tar -zxvf moredoc_ce_v3.1.0_linux_amd64.tar.gz -C /volume1/docker/moredoc/server
#进入moredoc文件夹，并赋权
cd /volume1/docker/moredoc
chown 1001:1001 /volume1/docker/moredoc/server/
chmod +x /volume1/docker/moredoc/server/moredoc
#修改app.toml文件
cp ./server/app.example.toml ./server/app.toml
# 下载docker-compose.yaml文件
curl -L https://raw.gitmirror.com/mnt-ltd/moredoc/master/docker/docker-compose.yml -o docker-compose.yaml
# 下载Dockerfile文件
curl -L https://raw.gitmirror.com/mnt-ltd/moredoc/master/docker/dockerfile -o Dockerfile

3、配置app.toml

• 加粗倾斜

# 数据库配置
[database]
driver = "mysql"
dsn = "moredoc:123456@tcp(192.168.168.168:33306)/moredoc?charset=utf8mb4&loc=Local&parseTime=true"
# 是否显示 SQL 语句，生产环境下请设置为false
showSQL = false
maxOpen = 10
maxIdle = 10

# JSON Web Token 配置
[jwt]
# 生成 token 的密钥，请务必修改！！！
secret = "secretKsecretKsecretK"
# token 过期时间
expireDays = 365

4、docker-compose.yaml

version: '3'
services: 
  moredoc-server:
    build: .
    container_name: moredoc-server
    ports:
      - "8880:8880"
    volumes:
      - ./server:/home/moredoc
    restart: always

5、打开container manager，选择项目，点击新建，选择路径，来源选择自带的compose。至此结束。

• 也可使用cd /volume1/docker/moredoc 启动容器docker-compose up -d

补充点

我在昨天部署的时候，出现过这样的情况：可以正常访问系统，但上传文件时提示如下报错 open cache/uploads/2024/05/10/4908ba60-0ea0-11ef-938d-0242ac1a0002.xlsx: no such file or directory

但今天部署的时候，却没有这种情况，我猜测也许大概就是权限问题。另外，在步骤2中，最好保持一致，防止权限异常。

root@QUN1HUI:/volume1/docker# ll -als |grep moredoc
0 drwxr-xr-x+ 1 root       root   142 May 11 09:38 moredoc

root@QUN1HUI:/volume1/docker# ll -als moredoc
total 17852
    0 drwxr-xr-x+ 1 root       root       142 May 11 09:38 .
    0 drwxr-xr-x+ 1 root       root       498 May 11 09:38 ..
    4 -rwxr-xr-x+ 1 caiji      users      173 May 11 09:43 docker-compose.yaml
    4 -rwxr-xr-x+ 1 caiji      users     1235 May 11 09:38 Dockerfile
17844 -rwxr-xr-x+ 1 caiji      users 18269574 May 11 09:38 moredoc_ce_v3.1.0_linux_amd64.tar.gz
    0 drwxr-xr-x+ 1       1001  1001      144 May 11 10:05 server

root@QUN1HUI:/volume1/docker# ll -als moredoc/server/
total 31280
    0 drwxr-xr-x+ 1       1001  1001      144 May 11 10:05 .
    0 drwxr-xr-x+ 1 root       root       142 May 11 09:38 ..
    4 -rw-r--r--  1        501    20      814 May  8 09:05 app.example.toml
    4 -rwxr-xr-x+ 1 caiji      users      855 May 11 09:41 app.toml
    0 drwxr-xr-x+ 1       1001  1001       10 May 11 09:48 .cache
    0 drwxr-xr-x+ 1       1001  1001       44 May 11 10:05 cache
    0 drwxr-xr-x+ 1       1001  1001       30 May 11 09:48 .config
    0 drwxr-xr-x  1        501    20       16 May  8 09:05 dictionary
    0 drwxr-xr-x  1        501    20      234 May  8 09:05 dist
    0 drwxr-xr-x+ 1       1001  1001        2 May 11 10:05 documents
31272 -rwxr-xr-x  1        501    20 32022528 May  8 09:05 moredoc

部署方式2

• 默认管理账号：admin 密码：mnt.ltd
• 不是特别推荐部署方式~~~

# 新建文件夹 moredoc 和 子目录
mkdir -p /volume1/docker/moredoc/{cache,document,uploads}
# 进入 moredoc 目录
cd /volume1/docker/moredoc
# 设置目录权限
chown 1001:1001 {cache,document,uploads}

version: '3'
services:
  moredoc:
    image: bluezealot/moredoc
    container_name: moredoc
    restart: always
    ports:
      - 8880: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.168.168:33306)/moredoc?charset=utf8mb4&loc=Local&parseTime=true

参考文献

• 开源地址
  • Github - https://github.com/mnt-ltd/moredoc
  • Gitee - https://gitee.com/mnt-ltd/moredoc
  • MNT.Ltd - https://git.mnt.ltd/mnt-ltd/moredoc
• 演示站点
  • 网址：https://moredoc.mnt.ltd
  • 账号：admin
  • 密码：mnt.ltd
• 使用手册
  • https://www.bookstack.cn/read/moredoc/README.md
• 服务官网
  • https://mnt.ltd/
• 公众号
  • 可爱的小Cherry
    • https://mp.weixin.qq.com/s/5wq1WqIKgPL6g2YLd-zxHw
  • 杨浦老苏
    • https://mp.weixin.qq.com/s/q3AAjY1p5czrUraOljiC4Q