Windows下安装部署BookStack（简版）

    这个主要用于在发布文档的时候，渲染未被渲染的markdown文档，以及强力模式下的网页采集。 安装chrome，是为了兼容以前的问题，并且自动安装puppeteer的一些chrome浏览器依赖。

    安装puppeteer、pm2

    这个主要用于在发布文档的时候，渲染未被渲染的markdown文档、渲染自定义封面、以及强力模式下的网页采集。

    需要先安装 node.js。可直接下载直接安装。

    calibre官网：

    执行下面命令，能看到版本号，表示安装成功。

    1. ebook-convert --version

    calibre主要用于将文档导出生成pdf、epub、mobi文档。

    本人已经使用Go语言对calibre导出pdf、epub、mobi文档进行了一层封装，欢迎大家给个star ==》https://github.com/TruthHun/converter

    随便创建一个txt文件

    1. echo "Hello BookStack。你好，书栈。" > test.txt
    1. ebook-convert test.txt test.pdf

    查看测试的转化效果，主要看下转化的过程中有没有报错，以及转化后的文档有没有出现中文乱码。

    安装Git

    下载地址：

    https://github.com/TruthHun/BookStack/releases

    配置文件在conf目录。

    配置数据库和文档导出项

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

    配置OSS

    1、登录你的阿里云，进入OSS，创建一个只读Bucket。 2、在本地随便创建一个txt文档，将下面两行粘贴进去：

    1. styleName:cover,styleBody:image/resize,m_fill,w_175,h_230,limit_0/auto-orient,1/quality,q_100
    2. styleName:avatar,styleBody:image/resize,m_fill,w_100,h_100,limit_0/auto-orient,1/quality,q_90

    3、在OSS的图片处理-导入样式中，将该txt文档导入 

    1. # 阿里云OSS配置
    2. [oss]
    4. # 是否是内网，如果您的阿里云服务器和OSS是同一内网，请设置为true，这样能更快地将文件移到oss上，否则设置为false。
    5. # 一般情况下，在开发阶段，设置为false
    6. IsInternal=false
    8. # 内网Endpoint,如：oss-cn-hongkong-internal.aliyuncs.com
    9. EndpointInternal=
    11. # 外网Endpoint，如：oss-cn-hongkong.aliyuncs.com
    12. EndpointOuter=
    15. # 您的阿里云AccessKeyId
    16. AccessKeyId=
    18. # 您的阿里云AccessKeySecret
    19. AccessKeySecret=
    21. # 只读状态的Bucket，不要私有的，也不要公共读写的
    22. Bucket=
    24. # oss中绑定的域名，如果您没有绑定域名，则使用阿里云oss的自带域名也行
    25. Domain=

    配置第三方登录

    将oauth.conf.example重命名成oauth.conf,并根据提示修改配置。

    1. # 第三方登录配置
    2. [oauth]
    4. ##### Gitee(码云) ####
    5. # 申请地址（需要先登录）：https://gitee.com/oauth/applications
    7. # 您的ClientId
    8. giteeClientId=
    9. # 您的ClientSecret
    12. # 回调地址，把下面的bookstack.cn的域名换成你的即可
    13. giteeCallback=http://www.bookstack.cn/login/gitee
    15. # 下面这两项不要动
    16. giteeAccesstoken=https://gitee.com/oauth/token
    17. giteeUserInfo=https://gitee.com/api/v5/user
    21. ######## GitHub ########
    22. # 申请地址(需要先登录你的GitHub)：https://github.com/settings/developers
    24. # 您的ClientId
    25. githubClientId=
    27. # 您的ClientSecret
    28. githubClientSecret=
    30. # 回调地址，把下面的bookstack.cn的域名换成你的即可
    31. githubCallback=http://www.bookstack.cn/login/github
    33. # 下面这两项不要动
    34. githubAccesstoken=https://github.com/login/oauth/access_token
    35. githubUserInfo=https://api.github.com/user
    39. #### QQ ####
    40. # 申请地址（需要先登录你的QQ）:https://connect.qq.com/manage.html
    42. #ClientId，即 APP ID
    43. qqClientId=
    45. #ClientSecret，即 APP Key
    46. qqClientSecret=
    48. # 回调地址，把下面的bookstack.cn的域名换成你的即可
    49. qqCallback=http://www.bookstack.cn/login/qq
    51. # 下面这三项不要动
    52. qqAccesstoken=https://graph.qq.com/oauth2.0/token
    53. qqOpenId=https://graph.qq.com/oauth2.0/me
    54. qqUserInfo=https://graph.qq.com/user/get_user_info
    56. ### TODO 微信和微博登录，主要是我这边忘记了以前注册的个人开发者信息，当前没开发，后续会开发出来 ####

    1、将修改和配置好了的程序压缩，上传到站点根目录下，解压。 2、执行数据库安装。程序安装一些站点配置项、SEO项等。命令：

    3、配置反向代理 宝塔面板用户，直接在站点的设置里面配置反向代理，但是需要注意的是，需要修改缓存，如把下面两句注释掉：

    1. add_header X-Cache $upstream_cache_status;
    3. expires 12h;

    Nginx反向代理配置参考(宝塔的配置)：

    1. server
    2. {
    3.     server_name demo.bookstack.cn;
    4.     index index.php index.html index.htm default.php default.htm default.html;
    8.     location / 
    9.     {
    10.         proxy_pass http://localhost:8181;
    11.         proxy_set_header Host $host;
    12.         proxy_set_header X-Real-IP $remote_addr;
    13.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    14.         proxy_set_header REMOTE-HOST $remote_addr;
    16.         #缓存相关配置
    17.         #proxy_cache cache_one;
    18.         #proxy_cache_key $host$request_uri$is_args$args;
    19.         #proxy_cache_valid 200 304 301 302 1h;
    21.         #持久化连接相关配置
    22.         #proxy_connect_timeout 30s;
    23.         #proxy_read_timeout 86400s;
    24.         #proxy_send_timeout 30s;
    25.         #proxy_http_version 1.1;
    26.         #proxy_set_header Upgrade $http_upgrade;
    27.         #proxy_set_header Connection "upgrade";
    28.     }
    30.     location ~ .*\.(php|jsp|cgi|asp|aspx|flv|swf|xml)?$
    31.     {
    32.         proxy_set_header Host $host;
    33.         proxy_set_header X-Real-IP $remote_addr;
    34.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    35.         proxy_set_header REMOTE-HOST $remote_addr;
    36.         proxy_pass http://localhost:8181;
    38.     }
    39.     #PROXY-END
    41.     include enable-php-54.conf;
    42.     #PHP-INFO-END
    44.     #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    45.     include /www/server/panel/vhost/rewrite/demo.bookstack.cn.conf;
    46.     #REWRITE-END
    48.     #禁止访问的文件或目录
    49.     location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md)
    50.     {
    51.         return 404;
    52.     }
    54.     access_log  off;
    55. }

    加入系统守护进行

    打开程序所在目录，执行：

      关于

      admin admin

      v2.0 正式版开始，默认管理员账号密码调整为：

      总结