DocHub 程序是开源免费的,不存在,所以没有所谓的售后,所以凡是遇到问题,请到GitHub或者Gitee提交issues,以便问题存档以及在有空的时候查看和排查,不接受除此之外的任何答疑求助。每天上班要工作,下班要生活、休闲、学习以及对开源项目做改进和优化…请理解和见谅,谢谢。

Linux 下安装部署 DocHub 文库系统

尽管 DocHub 是使用Go语言开发的,但是部署 DocHub 程序,并不需要安装Go语言的环境,也不需要掌握Go语言,就好比你从深圳坐飞机到北京,不需要你会开飞机也不需要你会造飞机一个道理…

要求: Ubuntu 16.04 以上版本64位系统,硬件配置最低双核4G内存

既然您使用Linux,则我就默认您对Linux也比较熟悉,所以当前教程写的比较简单。

安装和配置依赖

快速安装命令参考如下

  1. # update
  2. sudo apt update
  3. sudo apt install -y fonts-wqy-zenhei fonts-wqy-microhei libreoffice imagemagick pdf2svg poppler-utils
  4. # calibre
  5. sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"

Minio的安装,请根据 Minio 安装和配置文档 进行安装,如果不使用 Minio 作为本地存储,则不需要进行安装和配置。

本教程以minio为例,Minio 的使用文档:https://www.bookstack.cn/books/MinioCookbookZH

部署和启动 DocHub 程序

下载 Linux 版 DocHub 程序:https://gitee.com/truthhun/DocHub/releases

解压到您的程序目录,通过以下命令启动程序:

  1. ./DocHub

然后访问如下地址进行安装(其中IP为您的服务器IP):

  1. http://ip:8090

Linux 下安装部署 DocHub 文库系统 - 图1

千万要注意的是,您创建的数据库,必须是 utf8 或者 utf8mb4 字符编码,否则程序安装失败。

填写了配置项,点击安装,如果全部配置项都填写正确,则安装成功,会直接在 conf 目录下,生成 app.conf 文件;否则安装失败,需要根据错误提示,修正配置项。


另外一种安装方式就是把 conf 目录下的 app.conf.example 修改成 app.conf,然后再根据 app.conf 中的配置提示修改配置项,修改好之后,再重新启动程序。

设置系统配置项

程序安装成功之后,通过访问 http://ip:8090/admin 链接登录管理后台,初始账号密码等如下:

  1. 账号: admin
  2. 密码: admin
  3. 验证码:芝麻开门

[关键] 配置依赖

系统设置 -> 依赖设置,配置项修改如下:

Linux 下安装部署 DocHub 文库系统 - 图2

如果不配置,则文档转化服务将无法正常工作!!!

[关键] 云存储配置

配置详细文档如下:

这里以本地部署的 Minio 为例,我创建的公共读和私有读 Bucket 分别为 dochub-publicdochub-private

我的 Minio 程序启动之后,给出的配置信息如下:

  1. minio server ./cloudstorage
  2. Endpoint: http://169.254.106.253:9000 http://192.168.42.91:9000 http://192.168.56.1:9000 http://127.0.0.1:9000
  3. AccessKey: C7XHAPB2ARLHM6PNWIWP
  4. SecretKey: y9GRGGDcpLusB7oasti3eXcw4gyqSYyjII1lBNG4
  5. Browser Access:
  6. http://169.254.106.253:9000 http://192.168.42.91:9000 http://192.168.56.1:9000 http://127.0.0.1:9000
  7. Command-line Access: https://docs.minio.io/docs/minio-client-quickstart-guide
  8. $ mc.exe config host add myminio http://169.254.106.253:9000 C7XHAPB2ARLHM6PNWIWP y9GRGGDcpLusB7oasti3eXcw4gyqSYyjII1lBNG4
  9. Object API (Amazon S3 compatible):
  10. Go: https://docs.minio.io/docs/golang-client-quickstart-guide
  11. Java: https://docs.minio.io/docs/java-client-quickstart-guide
  12. Python: https://docs.minio.io/docs/python-client-quickstart-guide
  13. JavaScript: https://docs.minio.io/docs/javascript-client-quickstart-guide
  14. .NET: https://docs.minio.io/docs/dotnet-client-quickstart-guide

所以,我在管理后台 云存储配置 -> Minio(本地存储) 的配置参考如下: Linux 下安装部署 DocHub 文库系统 - 图3

配置完云存储配置项之后,还要配置一下系统设置中的网站设置Linux 下安装部署 DocHub 文库系统 - 图4

我们这里选择 Minio 选项。

其他配置项

我们已经配置了云存储依赖设置, 剩下的网站设置邮箱设置日志设置全文搜索设置有些配置项还需要进行配置,认真看配置项的提示进行配置即可。

至于其他的 Nginx 或者 Apache 等反向代理和域名绑定相关的服务,以及 supervisor 守护进程的安装配置,可自行通过搜索引擎找到相关教程,或者通过以前的 DocHub v2.1 安装部署教程来查看 Nginx 和 supervisor 的安装和配置。

至此,Linux 下的部署算是完成了。