简体中文｜ English

SSR

A most advanced ssr framework on Earth that implemented serverless-side render specification for faas and traditional web server.

ssr 框架是为前端框架在服务端渲染的场景下所打造的开箱即用的服务端渲染框架。了解什么是服务端渲染请查看文档

此框架脱胎于 egg-react-ssr 项目和ssr v4.3版本（midway-faas + react ssr），在之前的基础上做了诸多演进，通过插件化的代码组织形式，支持任意服务端框架与任意前端框架的组合使用。开发者可以选择通过 Serverless 方式部署或是以传统 Node.js 的应用形式部署，并且我们专注于提升 Serverless 场景下服务端渲染应用的开发体验，打造了一站式的开发，发布应用服务的功能。最大程度提升开发者的开发体验，将应用的开发，部署成本降到最低。

在最新的 v5.0 版本中，同时支持 React 和 Vue2/Vue3 作为服务端渲染框架且构建工具我们同样支持了最流行的 Vite 来提升应用的启动速度和 HMR 速度，且提供一键以 Serverless 的形式发布上云的功能。我们可以非常有自信说它是地球上最先进的 ssr 框架。如果你希望获得开箱即用的体验且能够一键部署上云，请选择 ssr 框架。

阅读我们的官方文档获得更加详细的了解。事实上文档本身便是用 ssr 框架开发并通过 Serverless 部署到阿里云服务

什么情况下你应该选择 ssr 框架

需要在 Node.js 与前端框架结合的场景使用，与其他纯前端的框架不同 ssr 框架是专为服务端渲染场景或者 Node.js 与前端结合的场景打造的框架
需要一个开箱即用的服务端渲染能力，不需要手动去组合不同的前端框架与服务端框架之间的联系
需要一个配置简单逻辑清晰的框架， ssr 框架的渲染逻辑和应用构建逻辑是同类型框架中最清晰的
可能会改动技术栈，如从 Vue2 升级为 Vue3，从 Vue3 降级为 Vue2 或 React/Vue 互相切换
需要在服务端渲染场景下开箱即用使用 antd vant 等流行 ui 库
需要能够同时支持 Webpack, Vite 两种构建工具，以便同时得到快速的启动速度 HMR 速度以及稳定的生产环境代码

哪些应用在使用

正在使用这个项目的公司(应用), 如果您正在使用但名单中没有列出来的话请提 issue，欢迎推广分享，我们将随时提供技术支持

_优酷视频	_{阿里影业娱乐宝}	_{Vmate短视频}	_{火炽星原CRM}	_牛牛搭	_{希沃帮助中心}	_腾讯微卡	_微脉
_{腾讯手游助手}	_{国家现代农业科技创新中心}	_{部署于阿里云示例应用}	_{部署于腾讯云示例应用}	_国盛证券	_三易科技	_{极速二维码}	_100教育
腾讯视频

Features

🌱 极易定制：前端支持 React/Vue2/Vue3 等现代Web框架；
🚀 开箱即用：内置 10+ 脚手架配套扩展，如Antd、Vant、TS、Hooks等；
🧲 插件驱动：基于插件架构，用户更加专注于业务逻辑；
💯 Serverless优先：一键发布到各种Serverless平台，也支持传统Web Server，比如Egg、Midway、Nest等。
🛡 高可用场景，可无缝从SSR降级到CSR，最佳容灾方案。
😄 功能丰富，构建工具支持 Webpack/Vite

已实现的功能

🚀 表示已经实现的功能

里程碑	状态
支持任意服务端框架与任意前端框架的组合使用。(Serverless/Midway/Nestjs) + (React/Vue2/Vue3)	🚀
支持 vite 作为构建工具在 SSR 场景下的组合使用	🚀
最小而美的实现服务端渲染功能	🚀
针对Serverless 场景对代码包的大小的严格限制，将生产环境的代码包大小做到极致	🚀
同时支持约定式前端路由和声明式前端路由	🚀
React 场景下 All in JSX，Vue 场景 All in template，没有传统模版引擎，所有部分包括 html layout 布局皆使用 JSX/Vue 来编写生成	🚀
同时支持三种渲染模式，提供服务端渲染一键降级为客户端渲染的能力	🚀
统一不同框架服务端客户端的数据获取方式，做到高度复用	🚀
类型友好，全面拥抱 TS	🚀
支持无缝接入 antd vant 无需修改任何配置	🚀
支持使用 less 作为 css 预处理器	🚀
实现 React/Vue SSR 场景下的优秀代码分割方案首屏性能做到极致	🚀
React 场景下使用 useContext + useReducer 实现极简的数据管理方案，摒弃传统的 redux/dva 等数据管理方案	🚀
Vue3 场景提供 Provide/Inject 代替 Vuex 进行跨组件通信	🚀
支持在阿里云云平台创建使用	🚀
ssr deploy 一键部署到阿里云平台	🚀
ssr deploy --tencent 无需修改任何配置一键部署到腾讯云平台	🚀

方案对比

为什么要选择 ssr 框架以及与同类型框架的方案对比请查看文档

快速开始

我们提供了 create-ssr-app 脚手架来让用户可以迅速的创建不同类型的应用。

目前官方提供了以下类型的模版给开发者直接使用。用户可根据自己的实际技术栈选择不同的模版进行开发。

虽然技术栈不同但开发**是一致的，在任何技术栈的组合中我们的开发命令, 构建命令以及渲染原理都是完全一致的

注意: 在 Midway.js Nest.js 场景下我们都已实现了一键部署到 Serverless 平台的能力。但底层实现略有差异。更加详细的介绍可以阅读 Serverless 章节。如需要大量使用 Serverless 平台提供的能力，我们建议创建 Midway.js 类型的应用。强烈建议阅读我们的官方文档来获得更加详细的了解

开发者可根据实际技术栈需要创建不同类型的应用快速开始

创建项目

通过 npm init 命令我们可以创建上述的任意模版

$ npm init ssr-app my-ssr-project
$ cd my-ssr-project
$ npm install # 可以使用yarn 不要使用 cnpm
$ npm start
$ open http://localhost:3000 # 访问应用
$ npm run build # 资源构建，等价于 npx ssr build
$ npm run start:vite # 以 Vite 模式启动，等价于 npx ssr start --vite

线上案例

通过访问以下链接来预览该框架通过 Serverless 一键部署到阿里云/腾讯云服务的应用详情。
通过使用 queryParams csr=true 来让 SSR 服务端渲染模式一键降级为 CSR 客户端渲染模式，也可以通过 config.js 来进行配置。

http://ssr-fc.com/ 部署到阿里云的 React SSR 应用
http://ssr-fc.com?csr=true 部署到阿里云的 React SSR 应用, 以 CSR 模式访问
http://tx.ssr-fc.com 部署到腾讯云的 React SSR 应用
http://tx.ssr-fc.com?csr=true 部署到腾讯云的 React SSR 应用, 以 CSR 模式访问
http://vue.ssr-fc.com 部署到阿里云的 Vue SSR 应用
http://vue3.ssr-fc.com 部署到阿里云的 Vue3 SSR 应用
http://vue.ssr-fc.com?csr=true 部署到阿里云的 Vue SSR 应用, 以 CSR 模式访问
http://vue3.ssr-fc.com?csr=true 部署到阿里云的 Vue3 SSR 应用, 以 CSR 模式访问

生态系统

Project	Status	Description
ssr		cli for ssr framework
ssr-core-vue		core render for vue
ssr-core-react		core render for react
ssr-plugin-midway		provide start and build fetature by midway@2.0
ssr-plugin-nestjs		provide start and build feature by Nestjs
ssr-plugin-react		develop react application only be used in development
ssr-plugin-vue		develop vue2 application only be used in development
ssr-plugin-vue3		develop vue3 application only be used in development
ssr-server-utils		server utils in Node.js environment
ssr-client-utils		client utils in browser environment
ssr-hoc-react		provide hoc component for react
ssr-hoc-vue3		provide hoc component for vue3
ssr-types		provide common types
ssr-types-react		provide react scene types
ssr-webpack		start local server and build production bundle by webpack