史上最全的开源项目bookstack在centos7系统编译安装教程

bookstack又名书栈网,基于MinDoc,使用Beego开发的在线文档管理系统,功能类似Gitbook和看云,配套微信小程序是BookChat,配套手机APP是BookChatApp,由于官方平台只有ubuntu下部署,所以就计划写一篇在centos上安装的实战经验,本人实测系统为centos7,理论上支持所有的centos系统。

虽然名曰书栈网,用后给个人的感觉,它不仅仅有图书功能,其强大的文档版本控制和多格式文档导出、导入功能,绝对是一款你值得研究的对象!

在此感谢原创团队的分享精神,并把程序源码开源出来,让我们不需要购买版权就能使用如此牛X的程序;如果你想二开,利用编译方式安装,可做到个性化风格。

这套程序主要使用GO语言开发,不像PHP+mysql那样直接上传根目录就行,安装bookstack是需要搭建相关运行程序的,就本人多次编译安装经验,总结一下安装方式;如果你是首次使用这套系统,这篇文章或许对你会有帮助。

centos上安装中文字符集

如果是中文版centos,可跳过这一步

 yum install glibc-common
 yum install -y langpacks-zh_CN
 vi /etc/locale.conf   # 修改这个文件
  LANG=zh_CN.utf8
 source /etc/locale.conf 

进入宝塔新建此文件夹,没有新建

cd /usr/share/fonts/chinese/
cd /usr/share/fonts/chinese/TrueType; mkfontscale; mkfontdir; fc-cache -fv

下载,安装go环境

wget -c https://golang.google.cn/dl/go1.16.3.linux-amd64.tar.gz

解压并移动到 /usr/local/目录

tar -xvzf go1.16.3.linux-amd64.tar.gz -C /usr/local/

查询目录权限

ls -al

进入修改

vim .bashrc

底部添加

export PATH=$PATH:/usr/local/go/bin

使之生效

source .bashrc

查看版本

go version

添加变量

export GOPROXY=https://goproxy.io,direct

如果能查到go版本号表示安装成功!即可进行下一步:

安装bee

1.不翻墙情况下,如果直接执行下面命令会各种报错,无法下载!

go get -u github.com/beego/bee/v2

2.我们执行下面两句命令,然后执行安装命令就可以顺利安装,溜得飞起。
执行:

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

再次安装

go get -u github.com/beego/bee/v2
echo 'export GOPATH="$HOME/go"' >> ~/.bashrc
echo 'export PATH="$GOPATH/bin:$PATH"' >> ~/.bashrc
exec $SHELL

查看是否安装成功

bee version

编译安装bookstack

下载bookstack,上传到网站根目录,打开目录命令

输入编译命令

bee run
go mod download
./BookStack-X install
bee run

如果能正常编译并打印出编译进程代码,我们需要稍等片刻,直至编译完成,这时进入网站根目录会出现编译后的文件包;到此,环境搭建完成!为了体现bookstack全部功能,我们接下来就需要安装相应插件。

更新系统源

sudo yum upgrade

安装Chromium(生成pdf格式会用到)

yum install chromium

打印网页

chromium-browser --headless --disable-gpu --dump-dom --no-sandbox https://www.baidu.com

不出错证明安装成功!

这是让root用户可以运行chrome

echo 'export QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox"' >> ~/.bashrc`
source ~/.bashrc

安装calibre

在运行安装程序之前,您必须在系统上安装 xdg-utils、wget、xz-utils 和 python ≥ 2.6。
您可以通过运行卸载 calibre sudo calibre-uninstall。或者,只需删除安装文件夹即可删除 99% 的已安装文件。
您需要 GLIBC 2.18 或更高版本以及 libstdc++.so.6.0.21(来自 gcc 5.4.0)或更高版本才能运行 calibre
如果您收到错误Could not load the Qt platform plugin xcb,则您缺少一些所需的 X11-XCB 库,例如 libxcb-xinerama0,有关详细信息,请参见此处。
您可以像这样更改从默认 (/opt) 安装到的文件夹 calibre:

安装相关依赖

yum install zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gcc make xdg-utils wget qt4 qt4-devel qt4-x11 libpcap-devel xz-devel -y

安装calibre

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

如果提示无python
安装组件
1安装EPEL

yum install epel-release

2安装python;

yum install python36 #安装python3.6

3安装pip

如果新系统尚未安装工具pip,可通过以下三步快速安装pip
1.  yum -y install epel-release
2.  yum -y install python-pip
3.  pip --version  查看pip版本
注意:由于pip和pip3属于两个版本,默认为pip如果需要用pip3需要在`.bashrc`变量中加入`alias pip=pip3`并使之生效`source ~/.bashrc`
export LD_LIBRARY_PATH=/usr/loacl/glibc2.19/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH
# yum install libstdc++.so.6 -y
--- 查看动态库版本有哪些
# strings /usr/lib64/libstdc++.so.6 | grep GLIBC
# wget http://ftp.de.debian.org/debian/pool/main/g/gcc-4.8/libstdc++6-4.8-dbg_4.8.4-1_amd64.deb
# ar -x libstdc++6-4.8-dbg_4.8.4-1_amd64.deb
# tar -xvf data.tar.xz
-- 拷贝至/usr/lib64下
# cp ./usr/lib/x86_64-linux-gnu/debug/libstdc++.so.6.0.19 /usr/lib64
-- 授权
# chmod +x /usr/lib64/libstdc++.so.6.0.19
-- 删除低版本库的软连接
# rm /usr/lib64/libstdc++.so.6
# ln -s /usr/lib64/libstdc++.so.6.0.19 /usr/lib64/libstdc++.so.6

添加变量(注意文件版本号要统一)
export LD_LIBRARY_PATH=/usr/loacl/glibc2.19/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH

# cd /usr/local
# wget http://mirrors.ustc.edu.cn/gnu/libc/glibc-2.19.tar.gz
# tar -xzvf glibc-2.19.tar.gz
# cd glibc-2.19
# mkdir build && cd build/
# ../configure --prefix=/usr --disable-profile --enable-add-ons --with-headers=/usr/include --with-binutils=/usr/bin
# make -j4
# make install
--- 解决中文乱码问题
# make localedata/install-locales
--- 检查验证
# ll /lib64/libc*
--- 查看系统glibc支持的版本
# strings /lib64/libc.so.6 |grep GLIBC
# /lib64/libc.so.6

再次执行

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

查看版本

ebook-convert --version

安装

yum install libGL
echo "Hello BookStack。你好,书栈。" > test.txt
ebook-convert test.txt text.pdf

没出错的话,即可转换成功。

安装node

wget https://npm.taobao.org/mirrors/node/v16.13.2/node-v16.13.2-linux-x64.tar.gz

依次执行下列指令

xz -d node-v16.13.2-linux-x64.tar.xz
tar -zxvf node-v16.13.2-linux-x64.tar.xz
tar -xvf  node-v16.13.2-linux-x64.tar.gz

添加变量并保存:

export NODE_HOME=/root/node
export PATH=$NODE_HOME/bin:$PATH
source ~/.bashrc

安装dnf命令

yum install dnf

验证是否成功

node -v
npm -v

安装nrm

npm i -g cnpm

请求被拒绝:fetchMetadata: WARN deprecated request@2.88.2: request has been deprecated,先切换到淘宝镜像源:

npm config set registry https://registry.npm.taobao.org

进入根目录

cd /www/wwwroot/BookStack-X

再次安装

npm i -g cnpm

安装puppeteer(安装谷歌浏览器后这个可不安装)

初次安装命令:

npm install puppeteer

如果安装之后,又新建项目时,需要重新为新建项目安装puppeteer:
在新建的项目文件目录的终端,运行:

npm -v
npm i puppeteer 
cnpm i puppeteer
cd /root/

安装git

sudo dnf install git
或
yum -y install git 

配置数据库

app.conf.example命名为app.conf,并根据提示,修改配置。这里主要修改MySQL数据库的配置以及生成下载文档的配置。其他项能不改就不改。


server
{
listen 80;
server_name demo.bookstack.cn;
index index.php index.html index.htm default.php default.htm default.html;
root /www/wwwroot/demo.bookstack.cn;
location / 
{
proxy_pass http://localhost:8181;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header REMOTE-HOST $remote_addr;
#缓存相关配置
#proxy_cache cache_one;
#proxy_cache_key $host$request_uri$is_args$args;
#proxy_cache_valid 200 304 301 302 1h;
#持久化连接相关配置
#proxy_connect_timeout 30s;
#proxy_read_timeout 86400s;
#proxy_send_timeout 30s;
#proxy_http_version 1.1;
#proxy_set_header Upgrade $http_upgrade;
#proxy_set_header Connection "upgrade";
}
location ~ .*\.(php|jsp|cgi|asp|aspx|flv|swf|xml)?$
{
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header REMOTE-HOST $remote_addr;
proxy_pass http://localhost:8181;
}
#PROXY-END
include enable-php-54.conf;
#PHP-INFO-END
#REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
include /www/server/panel/vhost/rewrite/demo.bookstack.cn.conf;
#REWRITE-END
#禁止访问的文件或目录
location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md)
{
return 404;
}
access_log off;
}

最后我们检测变量环境添加是否正确

export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$PATH
export QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox"
alias pip=pip3
export LD_LIBRARY_PATH=/usr/loacl/glibc2.19/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH
export NODE_HOME=/root/node
export PATH=$NODE_HOME/bin:$PATH

最后执行生效

source .bashrc

至此,运行环境及插件就全部安装完毕,接下来我们需要设置开机自动启动及伪静态

我们先在网站配置文件里配置nginx伪静态,规则如下(根据情况更改参数)

 server
{
    listen 80;
    server_name demo.cn;
    index index.php index.html index.htm default.php default.htm default.html;
    root /www/wwwroot/demo.cn;
    location / 
    {
        proxy_pass http://localhost:8181;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        #缓存相关配置
        #proxy_cache cache_one;
        #proxy_cache_key $host$request_uri$is_args$args;
        #proxy_cache_valid 200 304 301 302 1h;
        #持久化连接相关配置
        #proxy_connect_timeout 30s;
        #proxy_read_timeout 86400s;
        #proxy_send_timeout 30s;
        #proxy_http_version 1.1;
        #proxy_set_header Upgrade $http_upgrade;
        #proxy_set_header Connection "upgrade";
    }
    location ~ .*\.(php|jsp|cgi|asp|aspx|flv|swf|xml)?$
    {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_pass http://localhost:8181;
    }
    #PROXY-END
    include enable-php-54.conf;
    #PHP-INFO-END
    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/demo.bookstack.cn.conf;
    #REWRITE-END
    #禁止访问的文件或目录
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md)
    {
        return 404;
    }
    access_log  off;
}

设置开机自启

方案一:通过指令ssh添加

进入

cd /etc/rc.d/rc.local

添加

/root/BookStack.sh

进入下列目录》》新建文件

/root/BookStack.sh

在文档内添加

sleep 10s
su - root
export QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox"
cd /home/wwwroot/BookStack-X
nohup ./BookStack-X >> /home/wwwroot/BookStack-X/bookstack.log 2>&1 &
exit

添加权限

ls -l /etc/rc.d/rc.local
cat /etc/rc.d/rc.local
chmod +x /etc/rc.d/rc.local
chmod +x BookStack.sh

方案二:通过宝塔添加自启守护

进入网站根目录添加如图文件,并输入如下内容

进入宝塔软件商店现在系统启动项

添加启动项

填入启动项名字与.sh文件的位置

我建议用宝塔面板来管理自启项,有图形界面,操作起来更直观,最后重启服务器,如果环境搭建没问题,程序便能正常运行。

如果实在嫌麻烦,想直接用现成的,那完全可以联系客服,通过我们的专业工程师搭建;如果你没有服务器,也不计划在公网运行,通过建虚拟机在局域网运行也是不错的选择!

隐藏内容

此处内容需要权限查看

  • 用户特权:299RMB
  • VIP用户特权:263.12RMB8.8折