本地部署文档管理平台 BookStack 并实现外部访问（ Windows 版本）

BookStack 是一款专注于书籍、文档管理的开源平台，它界面设计直观简洁，功能强大且易于使用，允许用户创建、组织和分享文档资料，特别适合用于构建内部文档系统、知识库或公开的文档站点。本文将详细介绍如何在 Windows 系统本地部署 BookStack 并结合路由侠实现外网访问本地部署的 BookStack 。

第一步，本地部署安装 BookStack

1，本教程操作环境为 Windows11 系统，首先访问 PHP 官网下载安装 PHP 8.4.x ，点此下载。

下载解压完成配置环境变量，确保 php -v 能在命令行中运行。

修改 php.ini 文件，找到并取消注释（去掉 ; ）以下扩展。

extension=openssl
extension=fileinfo
extension=pdo_sqlite

2，访问 Composer 官网下载安装 Composer ，点此下载，下载完成运行安装程序。

3，访问 GitHub 页面点击“ Code ” → “ Download ZIP ”下载 BookStack 源码，点此下载，下载后解压到本地目录（如 D:\Software\BookStack ）。

4，打开命令行工具，进入项目根目录并安装依赖。

cd D:\Software\BookStack

composer install

5，配置 .env 文件。

copy .env.example .env

用文本编辑器打开 .env ，修改为 SQLite 配置。

DB_CONNECTION=sqlite
DB_DATABASE=C:\BookStack\database\database.sqlite

6，在命令行输入以下命令生成密钥。

php artisan key:generate

初始化数据库。

php artisan migrate

如果前端资源不完整可以输入以下命令编译前端资源。

npm run dev

7，进入 public 目录，启动开发服务器。

cd public

php -S localhost:8000

8，打开浏览器访问地址 http://localhost:8000 ，就能看到你部署的 BookStack 登录界面了。

第二步，外网访问本地 BookStack

在内网的电脑上安装路由侠，点此下载

1，下载安装完成后，打开路由侠界面，点击【内网映射】。

2，点击【添加映射】。

3，选择【原生端口】。

4，在内网端口填写 BookStack 端口 8000 后点击【创建】按钮，如下图。

5，创建好后，就可以看到一条映射的公网地址，鼠标右键点击【复制地址】。

6，用文本编辑器打开 .env 文件将 APP_URL 修改成从路由侠生成的外网地址。

APP_URL=http://lyxbook.f1.luyouxia.net:19818

7，在外网电脑上，打开浏览器，在地址栏输入从路由侠生成的外网地址，就可以看到内网部署的 BookStack 登录界面了。