Linux下安装部署DocHub文库系统

要求：64位系统，硬件配置要高

Putty远程控制Linux系统

1.安装命令如下：
sudo apt-get install openssh-server
2.启动ssh-server服务，默认情况下安装结束后就自动启动了，可以用下列命令进行确认：
ps -e |grep ssh
如果看到截图中的sshd说明ssh-server启动成功了
启动sshserver命令：service ssh start 或者sudo /etc/init.d/ssh start
关闭sshserver命令：service ssh stop
重启sshserver命令：service ssh restart
3.ssh-server配置文件位于/etc/ssh/sshd_config，在这里可以定义SSH的服务端口，默认端口是22，你可以自己定义成其他端口号，如333。
设置成功后重启SSH服务：
sudo /etc/init.d/ssh sto
sudo /etc/init.d/ssh start
或者：service ssh restart
4.开通root远程登录权限
vi /etc/ssh/sshd_config
将PermitRootLogin without-password 修改为PermitRootLogin yes
执行命令service ssh restart，重启ssh-server
5.Window系统中用putty连接VirtualBox中的linux虚拟机时，网卡选择“桥接”。

安装MySQL服务

1.安装
ubuntu上安装mysql非常简单只需要几条命令就可以完成。

sudo apt-get install mysql-server
sudo apt-get install mysql-client
sudo apt-get install libmysqlclient-dev

使用如下命令来检查是否安装成功：
sudo netstat -tap | grep mysql
通过上述命令检查之后，如果看到有mysql 的socket处于 listen 状态则表示安装成功。
2.操作MySQL数据库

• sudo mysql –u root进入MySQL,默认root用户没有密码（加上-p即为输入密码，后期改密码为123456）
• show databases; 查看当前的数据库
• use mysql;选择mysql数据库
• show tables;显示当前数据库的表单
• create database dochub character set utf8 collate utf8_general_ci;新建文库用数据库
• 更改root用户密码(登陆时查看MySQL版本号，再搜索更改密码方法)：

mysql> system clear
mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456'; 
ALTER USER 'root'@'localhost' IDENTIFIED BY '123456' PASSWORD EXPIRE NEVER;
mysql> flush privileges；

将根管理帐户的身份验证方式更改为mysql_native_password

# vim /etc/mysql/mysql.conf.d/mysqld.cnf
default_authentication_plugin=mysql_native_password

• 创建用户

use mysql;
create user dochub identified by '123456';
//允许所有ip连接（用通配符%表示）
create user '新用户名'@'%' identified by '密码';
# 刷新系统权限表
flush privileges;
#登陆系统测试添加用户是否成功？
exit;
mysql -u dochub -p
输入密码
mysql>  
登录成功

• 授权用户

//授权dochub用户拥有dochub数据库的所有权限。
>grant all privileges on dochub.* to dochub;

• 修改MySQL允许远程访问
  修改mysql库的user表，将host项，从localhost改为%。%这里表示的是允许任意host访问，如果只允许某一个ip访问，则可改为相应的ip，比如可以将localhost改为192.168.1.123，这表示只允许局域网的192.168.1.123这个ip远程访问mysql

mysql> use mysql; 
mysql> update user set host = '%' where user = 'dochub'; 
mysql> select host, user from user; 
mysql> flush privileges;

• 打开远程访问3306权限

vi /etc/mysql/mysql.conf.d/mysqld.cnf
#注释掉 bind-address = 127.0.0.1
bind-address = 192.168.1.8
#增加一条端口配置，在`log-error=/var/log/mysql/error.log`后面
port = 3306

• 退出MySQL数据库：exit;

安装MinIo本地云存储系统

wget   http://dl.minio.org.cn/server/minio/release/linux-amd64/minio
chmod +x minio
sudo mkdir /mnt/data
sudo ./minio server /mnt/data

需要的相关程序

• LIbreoffice (https://www.libreoffice.org/)
• Calibre (https://calibre-ebook.com/download/)
• pdf2svg(https://github.com/TruthHun/pdf2svg-windows/releases)
• ImageMagick(https://www.imagemagick.org/script/download.php)
• Minio (可选，https://github.com/minio/minio/releases)
• DocHub (https://gitee.com/truthun/DocHub/releases)
• MySQL 数据库

安装和配置依赖

快速安装命令参考如下:

# update
sudo apt update
sudo apt install -y fonts-wqy-zenhei fonts-wqy-microhei libreoffice imagemagick pdf2svg poppler-utils
# calibre
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()"

Libreoffice

对office文档进行转换处理，主要用它来将office文档转成PDF.

sudo apt install libreoffice

在终端执行如下命令，查看版本号，能查到版本号，即表示安装成功。

soffice --version

Calibre

Calibre是一款电子书工具，用来将mobi、epub、tex等格式的电子书转成PDF文档，以及在Windows下缺少pdftotext的工具时，从PDF文档中提取txt内容。

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

官网有安装代码，国内的安装速度非常非常慢…请耐心等待…
在系统终端执行如下命令查看版本号，能查询到程序版本，即表示安装成功：
ebook-convert --version

pdf2svg

用来将PDF转成svg文件，以供文档浏览。

sudo apt install pdf2svg

是否安装成功?显示版本号即可。

pdf2svg

ImageMagick

将文档转化的首个svg图片转成jpg图片，用于作为文档的封面。
安装

sudo apt install imagemagick

是否安装成功?显示版本号即可。

convert --version

MySQL

DocHub 程序依赖的数据库是MySQL数据库，自行通过搜索引擎查找安装教程进行安装。程序只支持utf8和utf8mb4两种数据库字符编码，所以，您创建的数据库，必需是两种字符编码中的一种。
使用 SQL 创建数据库的时候，务必指定数据库字符编码。以下是创建程序数据库的两个参考SQL语句:
UTF8MB4
CREATE DATABASE dochub CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
UTF8
CREATE DATABASE dochub CHARACTER SET utf8 COLLATE utf8_general_ci;

Minio

Minio 是一个开源的云存储方案.

• 更换密码，Windows环境下编辑runminio.bat文件，内容如下：

set MINIO_ACCESS_KEY=admin  
set MINIO_SECRET_KEY=12345678  
minio.exe server D:\minio\cloudstorage

• 连接主机：

mc config host add minio http://127.0.0.1:9000 admin 12345678
mc config host add docminio http://3973753s8f.qicp.vip admin 12345678

• 查看文件：
  mc ls minio
• 设置永久访问链接（dochub文库才能正常显示文章图片）
  ./mc policy set download minio/yourbucket（dochub-public） //设置需要开放下载的bucket, 注意需要带minio
  或者：
  ./mc policy set public minio/mybucket(这个是你自己的桶名字)
  或者：直接在网络片中设置“Policy为Read Only”
• 数据迁移
  mc mirror docminio/dochub-private minio 特定目录对拷
  mc mirror docminio minio docminio→minio 对拷

部署和启动 DocHub 程序

1.下载 Linux 版 DocHub 程序：(https://gitee.com/truthhun/DocHub/releases)，解压到您的程序目录，通过以下命令启动程序：

./DocHub

• ftp下载文件命令：

get DocHub.V2.4_linux_amd64.zip

• ftp上传文件命令：

put DocHub.V2.4_linux_amd64.zip

• ftp退出命令：

bye

• Linux解压zip文件命令：

unzip DocHub.V2.4_linux_amd64.zip

ftp默认使用ASCII传输方式进行文件传输，但是如果在该方式下传输二进制文件，那么文件在传输过程中会自动转译，也会损坏数据，要解决这种问题，要把传输模式设置为二进制传输。
在服务器上登录ftp，然后输入bin，进入二进制传输模式，最后，使用put命令把压缩文件上传，本地下载后打开，成功。
2.浏览器访问 (http://localhost:8090) , 如果程序未安装，会进入安装界面，根据提示，输入 MySQL 数据库的配置进行安装。
3.程序安装成功之后，通过访问(http://localhost:8090/admin) 链接登录管理后台，初始账号密码等如下：

账号：admin
默认密码：admin
现密码：hcbj**42****51
验证码：芝麻开门

4.配置依赖

PDF2SVG→pdf2svg
Soffice→soffice
Soffice转化超时时间（秒）→1800
Calibre→ebook-convert
ImageMagick→magick
其余留空即可

5.云存储配置→Minio（本地存储），配置

AccessKey→用户名
SecretKey→密码
Endpoint→127.0.0.1:9000
公共读Bucket→dochub-public
公共读Bucket域名→http://127.0.0.1:9000
私有Bucket→dochub-private
私有Bucket域名→http://127.0.0.1:9000

配置完云存储配置项后，再选择：系统设置→网站设置→请选择存储类型，选择“Minio(本地云存储)”

花生壳内网穿透For Ubuntu Server

1.官网(https://hsk.oray.com/download/)下载花生壳软件；
2.安装软件：
sudo dpkg -i phddns_5_1_amd64.deb
3.执行花生壳软件
sudo phddns start
4.使用花生壳
浏览器输入远程管理地址b.oray.com进入花生壳远程管理页面
输入安装花生壳时生成的SN码及默认密码admin进入；
SN码使用命令sudo phddns status查看结果为"orayf2749a21ff3d" 密码默认admin

本地文库启动步骤

• 登陆Linux系统
  用户名：minio
  密码：toor
• 静默启动minio,启动脚本vim ./runminio.sh：

#!/bin/bash
export MINIO_ACCESS_KEY=admin
export MINIO_SECRET_KEY=12345678
# 静默启动，采用后不必再另打开终端
nohup ./minio server /mnt/data > ./minio.log 2>&1&

• 静默启动DocHub服务vim ./rundochub.sh

#!/bin/bash
nohup ./DocHub >dochub.log 2>&1&

• 切换终端
  Ubuntu Server打开多个终端快捷键Ctrl+Alt+F1...F6分别打开、切换共6个终端。因为采用静默启动，不再另打开终端了。
• 进入图形界面的命令是startX，敲击后会有安装xinit的提示。

sudo apt-get install xinit
#安装桌面环境GNOME
sudo apt-get install --no-install-recommends ubuntu-gnome-desktop
#卸载详细请百度，不赘述
apt-get --purge remove  software_name #卸载软件及其配置
apt-get autoremove software_name #卸载软件及其依赖的安装包 
#安装火狐
sudo apt-get install firefox

文库系统备份与恢复

便于移植系统，为开拓学校文库网建设业务提供技术准备。

• 备份MinIO云存储

1.连接主机：

mc config host add minio http://127.0.0.1:9000 admin 12345678
mc config host add docminio http://3973753s8f.qicp.vip admin 12345678

2.数据迁移

mc mirror docminio/dochub-private minio   特定目录对拷
mc mirror docminio minio   docminio→minio 对拷

• 备份DocHub文档；
• 备份用户数据；