华为云 ECS 部署静态活动页：一份可复用的上线与排错清单

为什么静态页也需要完整的上线流程

静态活动页看起来只是几个 HTML、CSS 和图片文件，但真正决定它能否稳定对外服务的，往往是网络边界、文件权限、Web 服务器配置和发布方式。下面以华为云 ECS 上部署一个静态活动页为例，整理一套可复用的流程，并给出常见故障的定位顺序。

一、先确认资源与网络边界

ECS 实例的操作系统、内网地址和绑定 EIP 的地址要分别记录，排错时先确认访问的是正确入口。
安全组只放行业务需要的端口。公网静态站点通常开放 80 和 443；SSH 端口只允许可信来源地址，不建议对全网开放。
如果后续绑定域名，应提前规划 DNS 解析和受信任的 TLS 证书。公网站点不建议长期使用自签名证书。

二、目录和权限保持可预测

不要直接在唯一的生产目录里覆盖文件，可以按版本发布并使用一个稳定的软链接：

/srv/site/
  releases/
    20261023-01/
      index.html
      assets/
  current -> /srv/site/releases/20261023-01

这样发布新版本时只需切换 current，回滚也不必重新上传文件。目录权限建议设为 755，普通文件设为 644。站点文件归属者与 Nginx 工作进程分离，例如由发布用户负责写入，把组设置为 Nginx 读取组。前端代码中不要放入 AK/SK、访问令牌或内部接口地址。

三、Nginx 配置要短而明确

静态站点的基础配置可以保持简单：

server {
    listen 80;
    server_name _;
    root /srv/site/current;
    index index.html;

    location = /healthz {
        default_type text/plain;
        return 200 "ok\n";
    }

    location / {
        try_files $uri $uri/ /index.html;
    }

    location ~* \.(css|js|png|jpg|jpeg|gif|svg|webp|woff2)$ {
        expires 7d;
        add_header Cache-Control "public, max-age=604800";
    }

    add_header X-Content-Type-Options nosniff always;
}

如果页面是单页应用，try_files 的最后一项指向 index.html；如果是多页站点，可以根据实际路由调整。修改配置后先执行 nginx -t，确认语法正确，再平滑 reload，避免直接重启造成不必要的中断。

四、发布和验证分开做

推荐按以下顺序执行：
1. 把文件上传到新的 releases 目录，核对索引文件、资源路径和文件权限。
2. 执行 Nginx 配置检查，然后 reload。
3. 先在 ECS 内部用 curl 检查本机响应，确认监听地址、状态码和内容类型。
4. 再从公网网络访问 EIP 或域名，检查 HTTP 状态码、页面资源和缓存响应头。
5. 最后切换 current 软链接；如果验证失败，立即切回上一个版本。

nginx -t
nginx -s reload
curl -I http://127.0.0.1/
curl -I http://<ECS_EIP>/
ss -lntp | grep -E ':80|:443'

发布完成后至少检查首页、关键静态资源、移动端宽度和浏览器控制台。只看首页是否返回 200 还不够，样式文件、图片和字体资源是否 404 也需要一并确认。

五、按现象缩小排错范围

连接超时：优先检查 EIP 是否绑定、安全组入方向规则和路由；如果本机 curl 正常、公网不通，问题通常不在 Nginx。
Connection refused：检查 Nginx 是否运行、监听地址是否为本机或全部地址，以及端口是否被其他进程占用。
403：检查目录执行权限、index 文件读取权限和 Nginx 工作进程用户。若启用了额外的访问控制，也要检查规则是否拦截了正常请求。
404：检查 root、location 和 try_files 的组合，尤其要注意软链接目标是否有效。
502：静态站点本身不会产生 502；如果前面还有反向代理或网关，应检查上游地址、健康检查和超时设置。
页面仍是旧版本：检查浏览器缓存、CDN 缓存和 current 软链接是否已经切换。静态资源文件名带内容哈希时，可以设置更长缓存；HTML 入口则应使用较短缓存。

六、把观测和回滚纳入日常

最小可用的监控至少应覆盖：HTTP 状态码、首页响应时间、TLS 证书到期时间、磁盘空间和 Nginx 错误日志。日志中不要记录令牌、Cookie 或请求正文中的敏感字段。每次发布保留版本目录和变更记录，出问题时先回滚，再离线分析原因，避免在生产环境反复试错。

结语

静态活动页的部署并不复杂，难点往往在于边界检查和操作顺序。把网络、权限、配置、验证、回滚拆成独立步骤，既能减少上线事故，也让后续维护有据可查。对个人开发者而言，这种可重复的流程比一次性“能打开”更有价值。