DocHub安装详细过程
DocHub是参考百度文库,使用Beego(Golang)开发的开源文库系统。
程序源码,托管在GitHub和Gitee
GitHub: https://github.com/truthhun/DocHub
Gitee: https://gitee.com/truthhun/DocHub
官方使用教程:
https://www.bookstack.cn/books/dochub
但是官方使用教程,有一些插件和注意事项没说清楚。下面记录下安装全过程,供需要的人参考。
一、安装环境
Ubuntu18.04+宝塔+LNMP, PHP7.1,Docker管理器3.0
宝塔需要手动放行以下安全端口。
Centos 如果使用宝塔也是一样的。
建议服务器安装宝塔,宝塔能够对服务器状态有很好的监控,且提供很多组件,安装网站程序方便。
二、安装Dochub环境依赖
按照《DocHub 环境依赖》逐个安装,不要使用极速安装,svgo不需要安装。https://www.bookstack.cn/read/dochub/env.md
[必需] Libreoffice 或 Openoffice
[必需] Calibre
安装python,sudo apt install python
[必需] pdf2svg
[必需] ImageMagick
[必需] MySQL-----(宝塔已经安装)
[非必需] svgo(不安装)
[非必需,建议安装] pdftotext
[非必需,建议安装] ElasticSearch
[非必需] Minio-------(如果本地存储,必须安装)
-------Minio安装注意事项-----
安装Minio参考
https://www.jianshu.com/p/52dbc679094a
具体步骤如下:
(1) 搜索镜像
• 1 搜索镜像的命令
docker search minio
• 2 搜索镜像命令的结果信息
搜索镜像命令的结果信息
(2) 拉取镜像
• 1 拉取镜像的命令
docker pull minio/minio
• 2 拉取镜像命令的结果信息
(3) 启动与安装镜像
• 1、这种安装方式并没有指定 ACCESS_KEY 和 SECRET_KEY 进行设置,安装后可以进行 echo命令设置,
docker run -it -p 9000:9000 -d minio/minio server /data
• -it 表示运行参数,-p 表示暴露端口 ,-d 表示后台运行,data 指定目录存放文件
(4) 查看运行镜像
• 1 查看运行镜像命令
[[email protected] /]# docker ps -a
2 查看运行镜像的结果信息
(5) 查看安装 logs 信息
• 1 通过指定容器 id 查看安装 minio 的信息
docker logs ea407f6b446c
• 2 minio 安装的日志信息,其中 AccessKey 和 SecretKey 是登陆 minio 客户端的用户名和秘钥
设置Minio
参考https://www.bookstack.cn/read/dochub/cs-minio.md
通过IP+9000登录Minio,
分别创建两个Bucket:
dochub-public
dochub-private
选择 Read Only,然后添加即可。不需要设置 prefix.
三、安装DocHub
1.宝塔创建网站,网站直接使用IP,不要添加端口,将DocHub程序上传根目录解压,按照下面安装帮助安装。
https://www.bookstack.cn/read/dochub/install-linux.md
在宝塔网站根目录打开终端,切换root,命令:cd /www/wwwroot/dochub
./DocHub
通过IP+端口8090,或者域名+端口方式,就可以进行DocHub数据库设置安装了。
端口可以在/www/wwwroot/dochub/conf/app.conf 修改
后台部分配置参考上述连接。
2.注意事项:
(1)网站配置
(2)配置依赖
SVGO不要填写,默认是填写的。
(3)公共读Bucket域名和私有Bucket 注意后面添加dochub-public,dochub-private如下图(我这个minio是和DocHub安装在一个服务器上面)
提交保存即可。
前台就可以娱乐的玩耍了。
(4)重启服务器注意查看宝塔Docker中项目是否存在未启动的,未启动启动。
(5)每次重启服务器,需要启动DocHub
Cd /www/wwwroot/dochub
./DocHub