如何在cPanel上部署具备SSR服务端渲染能力的React应用

方案1：云服务器/VPS 部署（灵活性最高，适配自定义Express逻辑） #

• 本地执行生产构建命令（通常为npm run build），确认webpack已正确生成客户端静态产物、服务端SSR打包产物两类文件
• 将以下文件上传到服务器指定目录：Express服务入口文件、package.json、构建后的产物目录（通常为dist）、public静态资源目录
• 服务器安装对应版本Node.js，进入项目目录执行npm install --production仅安装生产依赖
• 安装进程管理工具pm2，执行pm2 start 你的服务入口文件.js --name react-ssr-app启动Node服务
• 安装Nginx配置反向代理：将80/443端口的用户请求转发到Express服务监听的本地端口（如3000），静态资源请求直接由Nginx返回，降低Node服务压力
• 配置SSL证书并完成域名解析，即可对外提供访问

方案2：Serverless 平台部署（无需运维服务器，适合轻量应用） #

• 修改Express服务入口，适配对应平台的Serverless函数规范：导出HTTP请求处理函数，移除本地端口监听逻辑
• 配置平台构建规则，指定生产构建命令、产物目录、服务入口
• 上传代码后平台自动完成构建、分发、弹性扩缩容，绑定域名后即可直接访问

部署关键注意事项 #

• 生产构建需完全剔除React开发模式相关代码和依赖，避免性能损耗和调试信息泄露
• 所有敏感信息（如API密钥、数据库地址）通过环境变量注入，禁止硬编码在代码中
• 给SSR渲染逻辑添加异常兜底，避免单条请求渲染报错导致整个服务 crash
• 静态资源建议上传到对象存储并接入CDN，大幅提升用户访问速度，降低源站负载

内容的提问来源于stack exchange，提问作者C.O.D.E.R