

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amplify Hosting 部署在服务器端渲染的应用程序
<a name="server-side-rendering-amplify"></a>

您可以使用部署和托管使用 AWS Amplify 服务器端渲染 (SSR) 的 Web 应用程序。Amplify Hosting 会自动检测使用 Next.js 框架创建的应用程序，您无需在 AWS 管理控制台中执行任何手动配置。

Amplify 还支持任何基于 JavaScript 的 SSR 框架，其开源构建适配器可将应用程序的构建输出转换为 Amplify Hosting 期望的目录结构。例如，您可以通过安装可用的适配器来部署使用 Nuxt、Astro 和 SvelteKit框架创建的应用程序。

高级用户可使用部署规范来创建构建适配器或配置构建后脚本。

您只需通过最低限度的配置即可将以下框架部署到 Amplify Hosting。

**Next.js**  
+ Amplify 无需适配器即可支持 Next.js 15 个应用程序。要开始使用，请参阅[Amplify 对 Next.js 的支持](ssr-amplify-support.md)。

**Nuxt.js**  
+ Amplify 支持利用预设适配器进行 Nuxt.js 应用程序部署。要开始使用，请参阅[Amplify 对 Nuxt.js 的支持](nuxt-support.md)。

**Astro.js**  
+ Amplify 支持利用社区适配器进行 Astro.js 应用程序部署。要开始使用，请参阅[Amplify 对 Astro.js 的支持](astro-support.md)。

**SvelteKit**  
+ Amplify 支持使用社区适配器的 SvelteKit 应用程序部署。要开始使用，请参阅[Amplify 对以下各项的支持 SvelteKit](sveltekit-support.md)。

**开源适配器**  
+ **使用开源适配器** – 如需使用上述列表中未列出的适配器的说明，请参阅[为任意 SSR 框架使用开源适配器](using-framework-adapter.md)。
+  **构建框架适配器** – 如果框架作者想要集成框架提供的功能，则可使用 Amplify Hosting 部署规范来配置构建输出，使其符合 Amplify 期望的结构。有关更多信息，请参阅[使用 Amplify Hosting 部署规范配置构建输出](ssr-deployment-specification.md)。
+ **配置构建后脚本** – 您可以根据特定场景的需要，使用 Amplify Hosting 部署规范来操作构建输出。有关更多信息，请参阅[使用 Amplify Hosting 部署规范配置构建输出](ssr-deployment-specification.md)。有关示例，请参阅[使用部署清单部署 Express 服务器](deploy-express-server.md)。

**Topics**
+ [Amplify 对 Next.js 的支持](ssr-amplify-support.md)
+ [Amplify 对 Nuxt.js 的支持](nuxt-support.md)
+ [Amplify 对 Astro.js 的支持](astro-support.md)
+ [Amplify 对以下各项的支持 SvelteKit](sveltekit-support.md)
+ [将 SSR 应用程序部署到 Amplify](#deploy-ssr-framework-app)
+ [支持的 SSR 功能](ssr-supported-features.md)
+ [SSR 部署的问题排查](troubleshooting-ssr-deployment.md)
+ [高级：开源适配器](advanced-open-source-adapters.md)

## 将 SSR 应用程序部署到 Amplify
<a name="deploy-ssr-framework-app"></a>

您可以按照这些说明操作，以部署使用任何框架创建的应用程序，只要此类框架具有符合 Amplify 期望的构建输出的部署捆绑包即可。如果您正在部署 Next.js 应用程序，则不需要适配器。

如果您正在部署使用框架适配器的 SSR 应用程序，则必须首先安装和配置适配器。有关说明，请参阅[为任意 SSR 框架使用开源适配器](using-framework-adapter.md)。

**将 SSR 应用程序部署到 Amplify Hosting**

1. 登录 AWS 管理控制台 并打开 [Amplify](https://console.aws.amazon.com/amplify/) 控制台。

1. 在**所有应用程序**页面中，选择**创建新应用程序**。

1. 在**开始使用 Amplify 进行构建**页面中选择您的 Git 存储库提供商，然后选择**下一步**。

1. 在**添加存储库分支**页面上，执行以下操作：

   1. 选择需要连接的存储库的名称。

   1. 选择需要连接的存储库分支的名称。

   1. 选择**下一步**。

1. 在**应用程序设置**页面上，Amplify 会自动检测 Next.js SSR 应用程序。

   如果您要部署的 SSR 应用程序使用其他框架的适配器，则必须明确启用 Amazon CloudWatch Logs。打开**高级设置**部分，随后在**服务器端渲染（SSR）部署**部分中选择**启用 SSR 应用程序日志**。

1. 该应用程序需要一个 Amplify 代入的 IAM 服务角色来向 AWS 账户传送日志。

   添加服务角色的过程会有所不同，具体取决于您要创建新角色还是使用现有角色。
   + 若要创建新角色：

     1. 请选择**创建和使用新的服务角色**。
   + 若要使用现有角色：

     1. 选择**使用现有角色**。

     1. 在服务角色列表中选择要使用的角色。

1. 选择**下一步**。

1. 在**查看**页面上，选择**保存并部署**。