ubuntu中js部署有哪些注意事项

Ubuntu 上部署 JavaScript 项目的注意事项

一 基础环境与系统安全

• 使用Ubuntu 22.04 LTS等稳定版本，优先通过NVM安装与管理Node.js LTS，避免多项目版本冲突；如需全局工具，使用独立用户或 npm 前缀，减少系统污染。
• 创建非 root部署用户并授予sudo，禁用 root 的 SSH 登录；采用SSH 密钥认证，必要时限制来源 IP。
• 云服务器需配置安全组/防火墙：开放22（SSH）、80/443（HTTP/HTTPS），后端应用端口（如3000）仅在回环或内网开放；本机可使用ufw allow 22,80,443/tcp & & ufw enable。
• 安装构建依赖（如build-essential）以满足 native 模块编译需求。

二 代码获取与构建流程

• 代码传输优先用Git（便于版本回滚与审计），也可使用SCP/SFTP；服务器端统一在部署目录拉取与构建。
• 安装依赖区分环境：生产环境执行npm install --production或yarn install --production，避免将node_modules纳入版本控制。
• 前端项目（如React/Vue）需先执行npm run build生成静态产物（常见为dist），再进入部署阶段。
• 使用**.env**管理配置与密钥，生产环境优先通过系统环境变量注入，谨慎将敏感信息提交到仓库。

三 运行与进程管理

• 后端/Node.js 服务使用PM2托管：启动如pm2 start app.js --name “my-app”，通过pm2 save与pm2 startup配置开机自启，支持**零停机重启（reload）**与日志查看（pm2 logs）。
• 监听地址务必绑定127.0.0.1（而非0.0.0.0），由Nginx在本地反向代理，减少直接暴露 Node 进程。
• 前端静态站点（SPA）由Nginx直接托管，使用try_files $uri $uri/ /index.html处理前端路由回退。

四 反向代理与网络配置

• 使用Nginx作为反向代理与静态资源服务器：将**/api等前缀转发到后端（如http://127.0.0.1:3000**），同时服务前端静态文件。
• 典型 Nginx 配置要点：设置proxy_http_version 1.1、Upgrade/Connection以支持WebSocket；变更后用nginx -t校验语法并systemctl restart nginx生效。
• 全站启用HTTPS：通过Certbot申请Let’s Encrypt证书，一键配置 Nginx 的 SSL/TLS。
• 防火墙与安全组需放行80/443；如应用端口仅本地访问，无需对外暴露。

五 前端静态站点的专项要点

• 构建命令通常为npm run build，产物目录为dist；部署前确认产物完整。
• Nginx 的root指向dist，并使用try_files $uri $uri/ /index.html保证前端路由正常工作。
• 将**/api或后端接口统一反向代理到后端服务，避免CORS问题；如需gzip**压缩、缓存策略、安全头等，可在 Nginx 中一并配置。
• 注意文件权限与Nginx 运行用户对静态目录的读取权限。

六 监控维护与常见排错

• 使用PM2进行日志轮转与监控（如 pm2 monit），定期查看pm2 logs与Nginx 错误日志定位问题。
• 依赖与系统保持及时更新；Node 项目注意多版本并存与全局包冲突。
• 常见故障速查：
  • 无法访问：检查云安全组/ufw是否放行80/443，Nginx 是否运行，应用是否监听127.0.0.1。
  • 502/504：后端未启动或崩溃、端口不对、反向代理配置错误；用pm2 status与pm2 logs排查。
  • 前端路由 404：确认 Nginx 配置了try_files回退到index.html。
  • 端口占用：更换端口或释放占用进程，确保与 Nginx 配置一致。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！