如何在 Debian 上安装 BookStack 12

BookStack 是一个功能强大的开源平台，旨在组织和存储信息、笔记和文档。如果您希望使用命令行界面 （CLI） 在 Debian 12 服务器上设置 BookStack，那么您来对地方了。

在 Debian 上安装 BookStack 12 Bookworm

步骤 1。首先更新系统的软件包列表，并将已安装的软件包升级到最新版本。使用以下命令：

sudo apt update
sudo apt upgrade

此命令更新软件包列表，并将已安装的软件包升级到最新版本。

第2步。安装 LAMP 堆栈。

在安装 BookStack 之前，您需要在 Debian 服务器上设置一个 LAMP（Linux、Apache、MariaDB、PHP）堆栈。

第 3 步。配置 MariaDB。

在下一步中，您将使用该实用程序配置 MariaDB 服务器安装，该实用程序允许您为 MariaDB 设置基本安全性：mariadb-secure-installation

sudo mysql_secure_installation

按照屏幕上的提示设置 root 密码、删除匿名用户、禁止远程 root 登录以及删除测试数据库。

通过运行以下命令为 BookStack 创建专用数据库和用户：

mysql -u root -p

输入您的 root 密码，然后执行以下 SQL 命令：

CREATE DATABASE bookstack;
CREATE USER 'bookstack'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON bookstack.* TO 'bookstack'@'localhost';
FLUSH PRIVILEGES;
EXIT;

第 4 步。安装 Composer。

Composer 是 PHP 的依赖管理工具，我们将使用它来安装和管理 BookStack。使用以下命令安装 Composer：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

第 5 步。在 Debian 12 上安装 BookStack。

现在从 GitHub 克隆 BookStack 存储库：

cd /var/www/html
sudo git clone https://github.com/BookStackApp/BookStack.git

移动到 BookStack 目录并配置环境：

cd BookStack
cp .env.example .env

使用您喜欢的文本编辑器编辑文件：.env

sudo nano .env

使用您的 MariaDB 凭据更新以下设置：

DB_DATABASE=bookstack
DB_USERNAME=bookstack
DB_PASSWORD=your_strong_password

保存并退出文本编辑器，然后使用 Composer 安装所需的依赖项：

composer install

生成应用程序密钥并迁移数据库：

php artisan key:generate
php artisan migrate

通过运行以下命令初始化 BookStack：

php artisan bookstack:install

按照提示配置您的 BookStack 实例，包括设置管理员帐户和指定您的首选电子邮件设置。

第 6 步。配置 Apache 虚拟主机。

为 BookStack 创建一个新的 Apache 虚拟主机配置文件：

sudo nano /etc/apache2/sites-available/bookstack.conf

添加以下内容，根据需要调整路径：

<VirtualHost *:80>
ServerName your_domain_or_IP
DocumentRoot /var/www/html/BookStack/public
<Directory /var/www/html/BookStack/public>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>

保存并退出文本编辑器，然后启用新的虚拟主机并重新启动 Apache：

sudo a2ensite bookstack.conf
sudo systemctl restart apache2

第 7 步。设置 Let’s Encrypt for SSL。

要使用 SSL 保护您的 BookStack 实例，我们建议使用 Let’s Encrypt。安装 Certbot 并获取 SSL 证书：

sudo apt install certbot python3-certbot-apache
sudo certbot --apache

第 8 步。设置 cron 作业。

BookStack 需要定期任务来保持最佳性能。创建一个 cron 作业以自动执行这些任务：

sudo crontab -u www-data -e

将以下行添加到 crontab 文件中：

* * * * * php /var/www/html/BookStack/artisan schedule:run >> /dev/null 2>&1

保存并退出文本编辑器。

第 9 步。访问 BookStack Web 界面。

打开 Web 浏览器并导航到 BookStack 站点 （）。您应该会看到 BookStack 登录页面。使用您在安装过程中创建的管理员帐户登录。https://your_domain_or_IP

感谢您使用本教程在 Debian 12 Bookworm 上安装最新版本的 BookStack。如需更多帮助或有用信息，我们建议您查看 BookStack 官方网站。