橙心橙怡1. 项目概述
BookStack 是一款基于 Laravel 框架开发的开源文档管理系统，专为团队知识管理和文档协作而设计。作为一名长期从事企业内部知识管理的技术顾问，我发现很多中小团队都面临着文档分散、版本混乱的问题。BookStack 的树状分类结构和简洁的 Markdown 编辑器，恰好能解决这些痛点。
在 Windows 环境部署 BookStack 的优势在于：
- 对硬件要求低（2核CPU/4GB内存即可流畅运行）
- 维护成本低（相比 Linux 更易被普通员工接受）
- 与现有 AD 域控集成方便
注意：生产环境建议使用 MySQL 替代 SQLite，本文为简化演示使用 SQLite 配置
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与依赖安装
2.1 PHP 环境配置
PHP 8.4.x 是目前 BookStack 官方推荐的最新稳定版本。安装时需特别注意：
- 选择 "Thread Safe" 版本下载
- 解压路径不要包含中文或空格（推荐
C:\php8） - 环境变量配置后，需重启命令行工具才能生效
验证安装成功的正确方式：
bash复制php -v
# 应显示类似：PHP 8.4.3 (cli)...
2.2 Composer 安装细节
Composer 是 PHP 的依赖管理工具，安装时有两个关键选项需要勾选：
- "Add to PATH"（自动添加环境变量）
- "Developer mode"（启用开发工具）
安装完成后建议运行：
bash复制composer self-update
composer clear-cache
2.3 源码获取与目录权限
从 GitHub 下载源码时，建议选择 "Releases" 页面的稳定版本（而非直接下载 main 分支）。解压后需要确保：
storage/目录有写入权限bootstrap/cache/目录有写入权限
可以通过右键属性 → 安全 → 编辑，给 Users 组添加完全控制权限。
3. BookStack 详细配置
3.1 数据库配置优化
虽然教程使用 SQLite，但实际生产环境更推荐 MySQL。如需改用 MySQL，.env 应修改为：
ini复制DB_CO