# 定制开发者门户 (/zh/deploy/custom-portal)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1866 · updated: 2026-07-30 -->

<Info>
  定制门户需要 [Enterprise 套餐](https://mintlify.com/pricing?ref=custom-portal)以及[自托管部署](/zh/deploy/self-host)。请联系你的客户团队来规划部署范围。
</Info>

对某些平台而言，文档只是一个更大产品的一个表层——一个 API 市场、一个合作伙伴门户，或是一个内建了登录、凭据和支持的开发者体验。Mintlify 支持这些用例：由我们设计、构建并持续维护一个定制的呈现层来替换你现有的门户前端，同时你的团队通过 Mintlify 编辑器或基于 Git 的工作流来创作内容。

该门户会与你现有的 API、网关和下游系统集成，这些系统仍由你的团队拥有和运营。

<div id="features">
  ## 功能 [#功能]
</div>

| 功能      | 交付内容                                                        | 支撑方                 |
| ------- | ----------------------------------------------------------- | ------------------- |
| 定制呈现层   | 采用你的设计体系的完整前端应用，部署在你的环境中                                    | Mintlify，与自托管平台一同交付 |
| 产品与目录页面 | 市场、产品发现和文档界面                                                | 内容维护在 Mintlify 上    |
| 登录      | 门户内的认证会话                                                    | 你的身份提供方             |
| 应用与凭据   | 应用注册和凭据管理                                                   | 你的后端 API            |
| 订阅      | 产品与套餐订阅                                                     | 你的后端 API            |
| 个人资料与通知 | 用户资料与通知中心                                                   | 你的后端 API            |
| 支持      | 支持工单的创建和跟踪                                                  | 你的后端 API            |
| 搜索      | 感知登录状态、限定在用户可访问范围内的搜索                                       | Mintlify 平台         |
| 个性化内容   | 在渲染时基于权限和分组在服务器端进行过滤，用户只会看到他们有权访问的产品和页面                     | Mintlify 平台和你的身份提供方 |
| 持续发布    | 带升级指南的版本化发布，与任意[自托管部署](/zh/deploy/self-host#updates)相同的运营模式 | Mintlify            |

<div id="authoring-flow">
  ## 创作流程 [#创作流程]
</div>

定制前端不会影响内容的创作方式。你可以通过编辑器或本地基于 Git 的工作流来维护内容。每次变更都会经过你仓库的评审流程，具备完整的审计记录；发布会触发构建自动更新门户。内容变更不需要重新部署前端。

<div id="architecture">
  ## 架构 [#架构]
</div>

定制呈现层与自托管的 Mintlify 平台集成以获取内容、搜索和个性化能力；与你的 API 网关集成以处理应用、订阅和支持；并与你的身份提供方集成以完成认证。

```mermaid
flowchart TD
  U[Users] --> CDN[CDN and WAF]
  CDN --> PORTAL[Custom presentation layer]
  PORTAL --> PLAT[Mintlify platform<br/>content, search, personalization]
  PORTAL --> GW[Your API gateway]
  GW --> BE[Your backend services<br/>applications, subscriptions, support]
  PORTAL --> IDP[Your identity provider]
  W[Writers] --> ED[Editor and Git workflow]
  ED --> PLAT
```

定制呈现层与 Mintlify 平台都运行在你的网络边界内，使用你的集群、数据存储和可观测性技术栈，没有任何向第三方的外发流量。你的下游记录系统保持不变；门户通过你现有的 API 访问它们。

<div id="how-the-engagement-runs">
  ## 项目如何推进 [#项目如何推进]
</div>

<Steps>
  <Step title="确定范围与设计">
    你的客户团队会梳理门户的各个界面、你的设计体系以及门户所调用的后端 API，并与你的平台团队约定集成契约。
  </Step>

  <Step title="优先交付公开界面">
    项目通常会先落地你的设计体系和公开的内容界面，让你在切换前可以对照现有门户来验证体验。
  </Step>

  <Step title="认证后的界面">
    随后交付登录、凭据管理、订阅以及其他需要登录的体验，并与你的身份提供方和后端 API 集成。
  </Step>

  <Step title="搜索、个性化与 AI">
    感知登录状态的搜索和服务器端个性化能力完善核心体验。可选的 AI 功能会保持禁用，直到你的安全或 AI 治理团队批准。
  </Step>
</Steps>

在整个过程中，你的团队会在非生产环境中评审各次发布，并掌控每一次的切换。

<div id="next-steps">
  ## 后续步骤 [#后续步骤]
</div>

<Columns cols="2">
  <Card title="联系你的客户团队" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M7.5 12H13.5M7.5 8H10.5&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M8.5 20C9.55038 20.8697 10.8145 21.4238 12.2635 21.5188C13.4052 21.5937 14.5971 21.5936 15.7365 21.5188C16.1288 21.4931 16.5565 21.4007 16.9248 21.251C17.3345 21.0845 17.5395 21.0012 17.6437 21.0138C17.7478 21.0264 17.8989 21.1364 18.2011 21.3563C18.7339 21.744 19.4051 22.0225 20.4005 21.9986C20.9038 21.9865 21.1555 21.9804 21.2681 21.7909C21.3808 21.6013 21.2405 21.3389 20.9598 20.8141C20.5706 20.0862 20.324 19.2529 20.6977 18.5852C21.3413 17.6315 21.8879 16.5021 21.9678 15.2823C22.0107 14.6269 22.0107 13.9481 21.9678 13.2927C21.9146 12.4799 21.7173 11.7073 21.4012 11&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12.345 17.4868C15.9006 17.2526 18.7328 14.4069 18.9658 10.8344C19.0114 10.1353 19.0114 9.41131 18.9658 8.71219C18.7328 5.13969 15.9006 2.29401 12.345 2.05985C11.132 1.97997 9.86553 1.98013 8.65499 2.05985C5.09943 2.29401 2.26725 5.13969 2.0342 8.71219C1.9886 9.41131 1.9886 10.1353 2.0342 10.8344C2.11908 12.1356 2.69992 13.3403 3.38372 14.3576C3.78076 15.0697 3.51873 15.9586 3.10518 16.735C2.807 17.2948 2.65791 17.5747 2.77762 17.7769C2.89732 17.9791 3.16472 17.9856 3.69951 17.9985C4.75712 18.024 5.47028 17.7269 6.03638 17.3134C6.35744 17.0788 6.51798 16.9615 6.62862 16.9481C6.73926 16.9346 6.957 17.0234 7.39241 17.2011C7.78374 17.3608 8.23812 17.4593 8.65499 17.4868C9.86553 17.5665 11.132 17.5666 12.345 17.4868Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="https://www.mintlify.com/enterprise">
    规划定制门户项目并制定上线计划。
  </Card>

  <Card title="自托管" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M19 4H5C4.06812 4 3.60218 4 3.23463 4.15224C2.74458 4.35523 2.35523 4.74458 2.15224 5.23463C2 5.60218 2 6.06812 2 7C2 7.93188 2 8.39782 2.15224 8.76537C2.35523 9.25542 2.74458 9.64477 3.23463 9.84776C3.60218 10 4.06812 10 5 10H19C19.9319 10 20.3978 10 20.7654 9.84776C21.2554 9.64477 21.6448 9.25542 21.8478 8.76537C22 8.39782 22 7.93188 22 7C22 6.06812 22 5.60218 21.8478 5.23463C21.6448 4.74458 21.2554 4.35523 20.7654 4.15224C20.3978 4 19.9319 4 19 4Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19 14H5C4.06812 14 3.60218 14 3.23463 14.1522C2.74458 14.3552 2.35523 14.7446 2.15224 15.2346C2 15.6022 2 16.0681 2 17C2 17.9319 2 18.3978 2.15224 18.7654C2.35523 19.2554 2.74458 19.6448 3.23463 19.8478C3.60218 20 4.06812 20 5 20H19C19.9319 20 20.3978 20 20.7654 19.8478C21.2554 19.6448 21.6448 19.2554 21.8478 18.7654C22 18.3978 22 17.9319 22 17C22 16.0681 22 15.6022 21.8478 15.2346C21.6448 14.7446 21.2554 14.3552 20.7654 14.1522C20.3978 14 19.9319 14 19 14Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M6.125 7H6M6.25 7C6.25 7.13807 6.13807 7.25 6 7.25C5.86193 7.25 5.75 7.13807 5.75 7C5.75 6.86193 5.86193 6.75 6 6.75C6.13807 6.75 6.25 6.86193 6.25 7Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M10.125 7H10M10.25 7C10.25 7.13807 10.1381 7.25 10 7.25C9.86193 7.25 9.75 7.13807 9.75 7C9.75 6.86193 9.86193 6.75 10 6.75C10.1381 6.75 10.25 6.86193 10.25 7Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M6.125 17H6M6.25 17C6.25 17.1381 6.13807 17.25 6 17.25C5.86193 17.25 5.75 17.1381 5.75 17C5.75 16.8619 5.86193 16.75 6 16.75C6.13807 16.75 6.25 16.8619 6.25 17Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M10.125 17H10M10.25 17C10.25 17.1381 10.1381 17.25 10 17.25C9.86193 17.25 9.75 17.1381 9.75 17C9.75 16.8619 9.86193 16.75 10 16.75C10.1381 16.75 10.25 16.8619 10.25 17Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/deploy/self-host">
    定制门户所依赖的部署基础。
  </Card>
</Columns>
