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 官方网站。
