这里先编辑Bookstack网站目录下的.env文件，
添加CF CDN回源IP的列表：

APP_PROXIES="173.245.48.0/20, 103.21.244.0/22, 103.22.200.0/22, 103.31.4.0/22, 141.101.64.0/18, 108.162.192.0/18, 190.93.240.0/20, 188.114.96.0/20, 197.234.240.0/22, 198.41.128.0/17, 162.158.0.0/15, 104.16.0.0/13, 104.24.0.0/14, 172.64.0.0/13, 131.0.72.0/22, 2400:cb00::/32, 2606:4700::/32, 2803:f800::/32, 2405:b500::/32, 2405:8100::/32, 2a06:98c0::/29, 2c0f:f248::/32"

随后，在Nginx目录中存储的网站域名的conf，
Webinoly找#WebinolyCustom区域，
寻找在location部分添加proxy_set_header的相关穿透属性：

location / {
	try_files $uri $uri/ /index.php?$query_string;
	proxy_set_header Host $host;
	proxy_set_header X-Real-IP $remote_addr;
	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	proxy_set_header X-Forwarded-Proto $scheme;
	}

然后想办法让Nginx配置文件的http部分引用标头相关的列表，这里可以作为全局模板存储在conf.d目录内。

set_real_ip_from 173.245.48.0/20;
set_real_ip_from 103.21.244.0/22;
set_real_ip_from 103.22.200.0/22;
set_real_ip_from 103.31.4.0/22;
set_real_ip_from 141.101.64.0/18;
set_real_ip_from 108.162.192.0/18;
set_real_ip_from 190.93.240.0/20;
set_real_ip_from 188.114.96.0/20;
set_real_ip_from 197.234.240.0/22;
set_real_ip_from 198.41.128.0/17;
set_real_ip_from 162.158.0.0/15;
set_real_ip_from 104.16.0.0/13;
set_real_ip_from 104.24.0.0/14;
set_real_ip_from 172.64.0.0/13;
set_real_ip_from 131.0.72.0/22;
set_real_ip_from 2400:cb00::/32;
set_real_ip_from 2606:4700::/32;
set_real_ip_from 2803:f800::/32;
set_real_ip_from 2405:b500::/32;
set_real_ip_from 2405:8100::/32;
set_real_ip_from 2a06:98c0::/29;
set_real_ip_from 2c0f:f248::/32;
real_ip_header X-Forwarded-For;

最后重启Nginx，这个时候再去看审计后台就是穿透后的IP信息了，搞定。

来源

本文以Webinoly提供的LNMP环境，记录安装BookStack的过程。

目前，安装BookStack要求的配置是：

• 命令行访问权限 并安装 gnupg git unzip curl 软件包
• PHP 版本>= 8.2
  • 需要在命令行执行php命令的权限
  • 要求开启的PHP扩展：gd, dom, iconv, mbstring, mysqlnd, openssl, pdo, pdo_mysql, tokenizer, xml, zip
  • 可选扩展：ldap （用于 LDAP 身份验证），exif （用于图像处理）
  • 对于PHP MySQL数据库驱动，首选 nd (Native Driver) 扩展，否则使用默认 mysql 驱动扩展。
• MySQL 版本>= 8.0 或MariaDB 版本>= 10.6
  • 用于存储 BookStack 内容和数据
  • 建议单独创建拥有所有权限的单个数据库
• Git 用于下载与更新
• Composer 版本>= v2.2.0 用于安装和管理依赖项
• 兼容 PHP 的 Web 服务器 例如 Nginx

创建网站

先通过Webinoly的site命令创建PHP网站、及其对应目录与数据库。顺带配置SSL证书：

site domain.ltd -php -mysql
site domain.ltd -ssl=on 
# 可选：自定义证书参数 -ssl-crt=[证书位置] -ssl-key=[证书私钥位置]

手动安装

前往 /var/www/domain.ltd/ 目录，克隆BookStack的Git存储库：

cd /var/www/domain.ltd/ 
git clone https://source.bookstackapp.com/bookstack.git --branch release --single-branch bookstack

进入bookstack目录，执行Composer安装：

cd ./bookstack
composer install --no-dev

基本配置

基于.env.example 模板复制，创建 .env 配置文件，填入网址和数据库信息：

# Application URL
APP_URL=https://example.com

# Database details
DB_HOST=localhost
DB_DATABASE=database_database
DB_USERNAME=database_username
DB_PASSWORD=database_user_password

后续可通过命令 php artisan bookstack:update-url 更新应用网址也就是APP_URL：

随后在终端执行生成应用密钥的命令：

php artisan key:generate

配置Nginx

下文的Nginx配置，以book.lan域名并以HTTP（仅80端口）访问为例：

# WebinolyNginxServerStart
server {
	listen 80;
	listen [::]:80;

	server_name book.lan;

	access_log /var/log/nginx/book.lan.access.log we_log;
	error_log /var/log/nginx/book.lan.error.log;

	root /var/www/book.lan/bookstack/public;

	index index.php index.html index.htm;

	include common/auth.conf;

	# WebinolyCustom
	  location / {
	    try_files $uri $uri/ /index.php?$query_string;
	  }
  
	  location ~ \.php$ {
	    include fastcgi_params;
	    fastcgi_pass unix:/run/php/php-fpm.sock;
	  }
	# WebinolyCustomEnd

	#include common/phpx.conf;
	include common/locations.conf;
	include common/header.conf;
	include /var/www/book.lan/*-nginx.conf;
	include /etc/nginx/conf.d/*.conf.srv;
}

分析：

Webinoly默认的php配置 include common/phpx.conf;
不适用Bookstack要求的query_string，需要将其注释而不调用。

官方文档位于 location ~ \.php$ { 部分的配置行： include snippets/fastcgi-php.conf;
也不适用于目前Webinoly安装的配置（没有这个目录与文件）， 不然会无法调用PHP FastCGI导致白屏。

取而代之的是：include fastcgi_params;
后者文件实际位置位于nginx目录根。

使用

此时打开浏览器即可使用 Bookstack ，创建并登入账号……

来源