在宝塔或aaPanel中安装BookStack APP的过程以及URL重写规则问题
本文最后更新于 264 天前,其中的信息可能已经有所发展或是发生改变。

[infobox title="前言"]
BookStack APP是类似于GitBook的自搭建式知识库框架,拥有较强的分类功能,支持Markdown或WYSIWYG。

在搭建BookStack APP框架的最后一步进入Login页面的时候出现了404问题,也就是URL重写问题,使用的是Nginx。为了简化步骤在另外一台服务器使用了aaPanel,也就是海外版宝塔。URL重写比直接创建Nginx config要简单一些,但网络上没有给出示例,因此本篇教程将完整的过一遍BookStack APP的安装过程。

- Linux CentOS 7 + aaPanel
[/infobox]

[warningbox title="警告"]
本篇教程搭建的是BookStack APP,不是BookStack.cn!请注意区分。该教程不适用于BookStack.cn! BookStack APP官方网站:https://www.bookstackapp.com/
[/warningbox]

安装过程


安装要求

安装BookStack需要以下配置:

PHP >= 8.0.2

  • PHP扩展组件: OpenSSL, PDO, MBstring, iconv, Tokenizer, GD, MySQL, SimpleXML & DOM.
  • 可选扩展组件: LDAP (如果你要用LDAP验证).

MySQL >= 5.7 或 MariaDB >= 10.2

用来存储BookStack配置和数据

Git Version Control

用来安装或从Git更新

Composer >= v2.0

用来安装PHP前置

和PHP兼容的网页服务器,Apache或Nginx


安装步骤

  1. 使用 cd 指令指定目录位置

  2. 使用 git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch 指令来克隆release分支的最新BookStack

  3. 确保当前目录是你clone下来的根目录,然后继续步骤

  4. 使用 composer install --no-dev 来执行compser的安装指令

  5. 复制一份 .env.example,然后将复制出来的文件命名为 .env, 然后填写你的数据库信息以及你的邮件服务器信息

  6. 确保 storage, bootstrap/cache & public/uploads 三个目录的文件夹权限可读写。

  7. 在当前目录下运行 php artisan key:generate 来生成一个新的key

[warningbox title="警告"]
如果你已经在这个文件夹生成过key了,就别生成了,会出大问题!
[/warningbox]

  1. 确保生成出来的key在 .env 中更新

  2. 在aaPanel或宝塔面板中的网站"URL重写"项中填写以下内容

    listen [::]:8080;
    
    server_name localhost;
    
    index index.php index.html;
    
    location / {
    try_files $uri $uri/ /index.php?$query_string;
    }

    并保存。

  3. 在aaPanel或宝塔面板中的网站目录中的运行目录更改为 /public

  4. 最后使用 php artisan migrate 来同步更新到数据库

  5. 完成!你现在可以访问你的网站,默认账户是[email protected],密码是password

  6. 不要忘记给你的站上SSL!

[infobox title="后记"]
总而言之就是很好用!
[/infobox]

除非有特殊说明,否则本博客内所有内容皆以知识共享署名-相同方式共享 4.0 国际许可协议进行许可!
暂无评论

发送评论 编辑评论


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
贴吧
滑稽
上一篇
下一篇