如何在IIS上发布已准备好内容的Docusaurus文档项目？
2026-6-30
将Docusaurus项目部署到IIS的步骤
1. 构建Docusaurus静态文件
在Docusaurus项目根目录打开命令行，执行：
npm run build
执行完成后，项目根目录会生成build文件夹，里面包含所有可部署的静态页面和资源。
2. 配置IIS必备组件
- 确保IIS已安装静态内容功能（默认通常已启用，若未启用可在服务器管理器的“添加角色和功能”中勾选）。
- 安装URL重写模块：这是Docusaurus单页应用路由正常工作的关键，可通过IIS管理器的“Web平台安装程序”搜索安装。
3. 在IIS中创建网站
- 打开IIS管理器，右键左侧导航栏的“网站”，选择“添加网站”。
- 填写站点信息：
- 站点名称：自定义（比如
Docusaurus-Docs） - 物理路径：选择之前生成的
build文件夹路径 - 绑定：设置IP地址（可选择“全部未分配”）、端口（比如80）、主机名（若用自定义域名则填写）
- 站点名称：自定义（比如
- 点击“确定”完成网站创建。
4. 添加URL重写规则（解决单页应用路由问题）
- 在IIS管理器中选中刚创建的网站，切换到“功能视图”，找到并打开“URL重写”。
- 点击右侧“添加规则”，选择“空白规则”，填写以下配置：
- 名称：
Docusaurus SPA Rewrite - 匹配URL：
- 模式：
^(?!.*\.(js|css|png|jpg|jpeg|svg|ico|json)$).*$ - 忽略大小写：勾选
- 模式：
- 操作：
- 操作类型：
重写 - 重写URL：
/index.html - 追加查询字符串：勾选
- 操作类型：
- 名称：
- 点击“应用”保存规则。
5. 权限与测试
- 右键
build文件夹，选择“属性”→“安全”，确保IIS应用池的用户（默认是IIS AppPool\站点名称）拥有读取权限。 - 在浏览器中输入服务器IP或绑定的域名，测试所有页面和资源是否正常加载，包括路由跳转是否能正确显示对应内容。
内容的提问来源于stack exchange，提问作者ALİ BAKIR
相关产品推荐
相关产品推荐
