为了让程序部署更快更简单，推荐学习一下 Docker 的使用。

Docker 系列开源书籍地址：https://www.bookstack.cn/?cid=64&tab=popular

DocHub 程序的硬件配置，建议的最低云服务器配置：

  1. CPU: 2 * core
  2. 内存：4 GB
  3. 硬盘：10 GB

1. 制作镜像

下载 Linux 版可执行程序 DocHub.V2.0_linux_amd64.zip： https://gitee.com/truthhun/DocHub/releases/v2.0

解压压缩包，里面有Dockerfile文件

执行以下命令创建镜像：

  1. [sudo] docker build -t dochub:2.0 .

2. 启动容器

  1. [sudo] docker run -d -p 8090:8090 --name dochub dochub:2.0

当前的Dockerfile，把程序放到了容器里面，您也可以参考给定的Dockerfile文件，把程序挂载到容器外。

3. [可选]部署elasticsearch

如果不部署 elasticsearch ，文档搜索的时候则使用 MySQL的 like 查询数据。

DocHub 的ElasticSearch 开发和测试的时候使用的是v6.2.4的版本，需要安装IK中文分词，其他版本暂时未测试。

  1. mkdir -p /www/elasticsearch/dochub/data && sudo chmod 0777 -R /www/elasticsearch/dochub/data
  3. sudo docker run -d -p 9300:9300 -p 9200:9200 -v /www/elasticsearch/dochub/data:/usr/share/elasticsearch/data --name dochub-search truthhun/elasticsearch:6.2.4.ik

注意：搭建elasticsearch，请注意屏蔽对外的服务端口，限定内网访问，以避免受到恶意的访问或者攻击。

4. 设置OSS

登录阿里云，创建两个bucket，如：

  • dochub-public - 公共读bucket
  • dochub-private - 私有bucket

配置图片处理规则（将下面的规则导入到dochub-public的图片处理，并把访问设置设置为/）：

  1. styleName:cover,styleBody:image/resize,m_pad,w_140,h_200,limit_0/auto-orient,0/quality,q_90
  2. styleName:avatar,styleBody:image/resize,m_fill,w_120,h_120,limit_0/auto-orient,0/quality,q_90
  3. styleName:banner,styleBody:image/resize,m_fill,w_825,h_316,limit_0/auto-orient,0/quality,q_90

具体配置，参考：https://www.bookstack.cn/read/dochub/docker#%E9%85%8D%E7%BD%AE%E9%98%BF%E9%87%8C%E4%BA%91%E7%9A%84OSS

提示：

  1. 其他云存储(腾讯云、百度云、华为云、七牛云、又拍云等云存储)，下一个版本扩展。
  2. 不支持本地化文件存储。

5. 设置配置信息

浏览器访问:

  1. http://localhost:8090

按照提示，配置MySQL数据库信息

安装成功之后，登录管理后台：

  1. http://localhost:8090/admin

默认的管理员账号、密码和验证码分别如下：

  • admin
  • admim
  • 芝麻开门

进入系统设置，配置您的email,oss,依赖,日志,全文搜索等

完成以上配置，即表示安装部署完成。

2.0 版本开始，已经没有app.conf文件，在程序安装的时候，自动在conf目录下生成app.conf文件。

附 Dockerfile 文件内容

之前Dockerfile有误，现已更正。

  1. FROM truthhun/dochub:env
  3. WORKDIR /www/dochub
  5. RUN  wget https://github.com/TruthHun/DocHub/releases/download/v2.0/DocHub.V2.0_linux_amd64.zip \
  6.     && apt install unzip -y \
  7.     && unzip DocHub.V2.0_linux_amd64.zip -d /www/dochub/ \
  8.     && rm -rf /www/dochub/__MACOSX \
  9.     && chmod 0777 -R /www/dochub
  11. CMD [ "./DocHub" ]