预览部署

为拉取请求生成唯一的预览 URL，在合并前审阅更改。

预览部署适用于 Pro 和 Enterprise 方案。

预览部署可让你在合并到生产环境之前先查看文档更改的实际效果。每次预览都会生成一个可共享的 URL，并会在你推送新更改时自动更新。

预览 URL 默认对所有人可见。将预览链接分享给任何需要审阅你更改的人。

​

创建预览部署

预览部署会在拉取请求 (PR；亦称“合并请求”/Merge Request) 中自动创建，或可从你的控制台手动创建。

​

自动预览

仅针对目标为你的部署用分支的拉取请求 (PR) ，才会自动创建预览。

当你创建拉取请求时，Mintlify 机器人会自动在拉取请求中添加一个链接，供你查看预览部署。每次你向该分支推送新的提交时，预览都会更新。

​

手动预览

你可以为任意 branch 手动创建预览。

1. 前往你的控制台。
2. 选择 Previews。
3. 选择 Create custom preview。
4. 输入要预览的 branch 名称。
5. 可选：启用 Password protection 并输入密码。访问者必须输入此密码才能查看预览。
6. 选择 Create deployment。

​

重新部署预览

当需要刷新内容，或在部署失败后重试时，可重新部署预览。

1. 在你的控制台中选择该预览。
2. 选择重新部署。

​

预览小部件

预览小部件会显示在预览部署中，帮助你浏览和审阅更新后的页面。该小部件以悬浮按钮的形式显示在预览部署页面的右下角。

1. 点击小部件，在预览中显示所有新增、修改或删除的文件。
2. 点击某个文件，在对应页面上查看更改内容。
3. 使用搜索栏筛选已更改文件列表。
4. 将鼠标悬停在文件上，点击在编辑器中打开图标，直接在网页编辑器中编辑该文件。

该小部件只会显示在预览部署中，不会显示在已上线站点或本地预览中。

​

限制预览部署的访问权限

默认情况下，任何持有 URL 的人都可以访问预览部署。有两种方式可以限制访问：

​

组织认证

要求所有预览查看者必须是你 Mintlify 组织中的已认证成员。

1. 在控制台的 附加组件 页面，进入 Previews 部分。
2. 点击 Preview authentication 开关以启用或禁用预览认证。

​

密码保护

为单个手动预览设置密码以限制访问。启用后，访问者必须输入密码才能查看预览内容。你可以在创建手动预览时设置密码。

​

预览部署故障排查

如果预览部署失败，可以尝试以下故障排查步骤。

• 查看构建日志：在你的控制台中进入 Previews，并点击失败的预览。部署日志会显示导致失败的错误。
• 检查配置：
  • docs.json 语法无效
  • 在导航中引用的文件路径缺失或不正确
  • MDX 文件中的 frontmatter 无效
  • 图片链接失效或缺少图片文件
• 在本地验证：在本地运行 mint dev，在推送到存储库之前先发现构建错误。
• 检查最近的更改：查看当前分支中最近的提交，以确认哪些更改导致构建失败。