本地部署文档管理平台 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 登录界面了。

以上就是 Windows 系统在本地部署 BookStack 服务以及利用路由侠的内网穿透平台实现外网访问本地部署的 BookStack 的全部教程了,如果想要对路由侠有更多的了解,可以进官网详细了解,路由侠官网地址:www.luyouxia.com