不少企业还在维护 AngularJS 1.x 项目,例如管理后台、业务门户和内部系统。只要前端构建产物是静态文件,通常不需要让 Node.js 长期运行;但上线时仍要处理域名、HTTPS、路由和缓存。本文以阿里云为例,介绍常见部署方式,以及上线前容易漏掉的检查项。
先确认项目怎么运行
AngularJS通常指AngularJS 1.x,和后来基于TypeScript的Angular不是同一套框架。多数项目经过构建后,会生成HTML、JavaScript、CSS和图片等文件,由Web服务器或对象存储提供访问。业务数据则通过接口从后端获取。
部署前先看清项目结构:入口文件在哪里,构建产物输出到哪个目录,页面使用什么路由模式,接口地址是否写死在代码里。执行生产构建后,检查输出目录里的文件是否齐全。如果项目依赖Node.js服务、服务器端渲染或特殊的旧式构建环境,就不能直接当作普通静态站点发布。
- 纯静态前端:构建后只有页面和资源文件,可评估使用OSS托管,按需接入CDN。
- 需要自定义路由或代理:如果要处理复杂的路由回退、接口转发或访问日志,ECS上部署Nginx会更灵活。
- 前后端同机运行:已有云服务器承载业务时,可以让Nginx提供前端文件,并将接口请求转发给后端服务。
方案一:使用OSS托管静态文件
如果AngularJS项目构建后只产生静态文件,可以将产物上传到阿里云OSS,再根据访问需求接入CDN。这样不必为前端单独维护一台常驻服务器,适合部署结构简单、运维人手有限的项目。开始配置前,先确认存储桶所在地域、访问权限、域名和证书安排。
- 在本地或构建环境运行生产构建命令,确认输出目录中包含入口页面和所需资源。
- 创建OSS存储桶,上传构建产物,并按阿里云相关指引配置静态网站访问。
- 绑定自有域名并配置DNS解析;需要HTTPS时,准备有效证书并完成配置。
- 接入CDN后设置源站、缓存规则和HTTPS选项,再测试首页、静态资源及错误页面。
- 发布新版本后,根据资源类型处理缓存,避免浏览器继续加载旧版JavaScript或CSS。
路由回退要单独验证。如果项目使用HTML5模式,用户直接打开“/orders/123”这样的深层地址时,服务器需要把页面请求回退到应用入口文件。否则首页看起来正常,刷新订单详情页却可能返回404。使用哈希路由时,路径处理方式不同,也要从实际链接进入并刷新页面测试,不能只检查首页。
方案二:在ECS上部署Nginx
项目需要接口代理、访问日志、自定义路由规则,或要和已有服务放在一起时,可以在阿里云ECS上部署Nginx。将构建产物放进站点目录,由Nginx提供静态文件;接口请求则根据路径转发到实际API服务。前端页面和接口使用同一域名时,也能减少跨域配置上的工作。
HTML5模式下,常见做法是将页面请求回退到入口文件,同时让静态资源请求返回对应文件。配置完成后,检查证书、访问控制和日志轮转,并及时安装系统补丁。数据库、管理端口和调试接口不要直接暴露到公网;安全组只开放业务需要的端口,运维入口也应设置访问限制。
案例:企业订单后台迁移
一家企业有一套AngularJS订单管理后台,前端构建后生成静态文件,订单数据由独立API提供。原先前端和接口都部署在一台服务器上,每次发布要人工复制文件,偶尔还会遇到页面加载了新旧版本资源的问题。
迁移时,团队先把接口地址改为通过环境配置管理,避免测试和生产环境共用写死的地址。随后将前端产物单独发布到OSS,并为静态资源配置CDN缓存。由于后台使用深层路由,他们专门测试了订单详情页的直接访问和刷新。发布时使用带版本号的资源文件,并调整入口页面的缓存策略;验证通过后,前端更新不再依赖API服务重启,出现问题时也可以恢复上一版文件。
这类项目要把前端文件和业务接口分开管理,并在发布流程里安排路由测试、缓存处理和回滚。团队暂时没有专职云运维人员时,可以先用ECS加Nginx满足现有需求;之后再根据访问量和运维要求,评估OSS与CDN的组合是否合适。
上线前的检查清单
- 检查构建产物:确认生产构建没有报错,页面没有引用本地开发地址或调试资源。
- 测试路由:分别打开首页和深层链接,测试刷新、浏览器前进后退,以及不存在页面时的处理。
- 核对接口:确认API地址、跨域策略或反向代理配置正确;不要把敏感凭据打包进前端代码。
- 检查缓存:区分入口文件和带版本号的静态资源,避免更新后新旧文件混用。
- 收紧访问权限:启用HTTPS,关闭不需要的公网入口,并备份配置和发布产物。
- 准备排查与回滚:留意访问日志和资源加载失败情况,明确出错后如何恢复上一版。
部署之外,还要考虑AngularJS维护风险
AngularJS 1.x官方长期支持已于2021年12月结束,框架本身不再获得常规官方维护。阿里云提供的计算、存储和网络服务不能替代应用框架的安全维护。继续运行旧系统时,应检查依赖包风险、限制管理后台的访问范围,并做好备份和漏洞响应;同时为后续升级或迁移留出计划。
阿里云 AngularJS 项目选哪种部署方式,取决于构建产物和运行需求:纯静态前端可以评估OSS,需灵活代理或控制服务器配置时,可选ECS加Nginx。无论采用哪种方案,都要把深层路由、HTTPS、缓存和接口连接纳入上线测试。部署完成后,仍需持续检查依赖和运行状态。