跳转到主要内容

一、宝塔面板部署BookStack项目

1、环境要求 （操作系统Centos7.9\Rocky9.6）

  • 宝塔V10.0.2-LTS
  • PHP 8.2 ， PHP扩展：gd, dom, iconv, mbstring, mysqlnd, openssl, pdo, pdo_mysql, tokenizer, xml, zip
  • MySQL 8.0.36
  • Git（用于源码拉取 / 更新）-- (sudo yum install git -y)
  • Composer ≥ 2.2 (用于依赖管理)
  • Web 服务器 (宝塔里可用 Nginx)

2、在宝塔中新建站点 & 数据库

  • 进入宝塔 → “网站” → 新建站点 (例如域名 book.shineclub.cn:59900 或内网 IP + 端口)。
  • 在 “数据库” → 新建数据库 (例如 bookstack) + 创建用户 + 设置密码（记住数据库名 / 用户 /密码）。

3、获取 BookStack 源码

  • 进入网站根目录 (或你希望放源码的目录)
  • 执行命令：
bash git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch bookstack

国内利用梯子代理加速访问github。（单次终端有效）

export http_proxy=http://172.16.10.6:7890
export https_proxy=http://172.16.10.6:7890
  • 将bookstack目录下所有文件向上移动一层，放到网站的根目录下：
mv bookstack/* /www/wwwroot/book.shineclub.cn/

4、安装 PHP 依赖

  • 确保服务器安装了 Composer（宝塔里可手动安装：软件商店-官方应用-Composer）
  • 执行命令-安装 BookStack 所需 PHP 库：（需要启用扩展fileinfo）
composer install --no-dev
composer clear-cache
composer self-update --stable
composer install --no-dev --prefer-dist

5、配置环境文件 .env

  • 复制 .env.example.complete 为 .env
  • 编辑 .env (可用宝塔自带编辑器 / SSH / vim)：
    - APP_URL = book.shineclub.cn:59900 （你的站点 URL 如果不是443或者80口的必需加上端口号）
    - 如果非SSL建站，需要将DB_SSL=false，DB_MYSQL_ATTR_SSL_CA=null
    - 数据库配置：DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD 填写你创建的数据库信息
    - 其他保持默认，或根据需要配置邮件 / 上传等

6、设置目录权限

  • 确保以下目录对 Web 服务用户（www）可写：storage/, bootstrap/cache, public/uploads
chown -R www:www /www/wwwroot/book.shineclub.cn:59900
chmod -R 755 /www/wwwroot/book.shineclub.cn:59900

7、生成应用密钥 & 初始化数据库

  • 在网站根目录下执行：
php artisan key:generate
//建立数据库
php artisan migrate

8、配置 Web 服务器 (Nginx / Apache)

  • 将站点根 (DocumentRoot) 指向 /public 目录

9、初次访问与登录

  • 打开浏览器访问你的域名 (例如 http://book.shineclub.cn:59900)。首次登录默认账号通常是 admin@admin.com + password。首次登录后请立即修改管理员账号密码。

10、日常维护 / 更新

  • 更新 BookStack：进入根目录 
git pull origin release
omposer install
php artisan migrate
  • 修改配置.env后执行以下命令
php artisan config:cache
php artisan cache:clear
回到顶部