You need to enable JavaScript to run this app. 如何将React应用部署到自有服务器?解决域名空白及构建上传问题
优惠活动
大模型
产品
解决方案
定价
更多

如何将React应用部署到自有服务器?解决域名空白及构建上传问题

生产环境部署操作指南

核心操作步骤

1. 构建产物存放路径

本地执行npm run build生成的build文件夹,完整上传到服务器上现有react-recipes项目的根目录下,无需移动到其他系统路径存放。

2. Express服务端逻辑调整

项目本身集成Express服务层,无需额外搭建静态文件服务,直接在现有服务入口文件完成以下配置:

  • 挂载静态资源托管逻辑:引入path模块后,在所有API路由之前添加静态文件挂载代码:
    app.use(express.static(path.join(__dirname, 'build')))
    
  • 兼容前端路由:项目使用react-router-dom实现单页应用路由,需在所有后端接口、GraphQL路由配置完成后,添加兜底路由规则,所有非接口请求统一返回build目录下的index.html,防止前端路由刷新触发404:
    app.get('*', (req, res) => res.sendFile(path.join(__dirname, 'build', 'index.html')))
    
  • 修正服务监听绑定地址:将服务监听的绑定地址从默认127.0.0.1修改为0.0.0.0,确保外部网络请求可接入服务,而非仅支持服务器本机回环访问。

3. 域名访问链路配置

  • 配置Nginx反向代理:将已绑定域名的80/443端口请求,代理到Node服务实际运行的本地端口,不直接对外暴露Node服务端口。
  • 核对防火墙与安全组规则:放行域名对应的80(HTTP)、443(HTTPS)端口入站规则,避免请求被拦截。

4. 白屏问题针对性排查

  • 检查package.json中的homepage字段:应用部署在域名根路径时,将字段值设置为".",防止构建后的静态资源引用路径错误触发白屏。
  • 调整CORS配置:将正式域名加入服务端CORS允许列表,替换仅允许localhost的本地开发配置,避免Apollo Client请求接口被拦截。
  • 使用进程守护工具托管服务:通过pm2启动Node服务,避免SSH会话断开后服务进程终止,可通过pm2 logs查看服务运行日志定位启动报错。

内容的提问来源于stack exchange,提问作者shayan khalighi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 16:15:04