HTML项目部署本质是将文件放入Web服务器可访问目录，需确认Nginx/Apache已运行、文件放对路径（如/var/www/html）、权限正确、静态资源路径合理，并配置try_files支持前端路由，HTTPS和域名需同步处理DNS与证书续期。
HTML 项目不需要编译或运行时环境，部署本质就是把文件放到 Web 服务器能访问的目录里——但很多人卡在权限、路径、域名绑定或 HTTP 重定向上。
确认服务器有没有 Web 服务（Nginx / Apache）
很多新手以为“上传文件就完事”，结果浏览器打不开，其实是服务器根本没开 Web 服务。先 SSH 登录，检查：
-
systemctl status nginx或systemctl status apache2—— 看是否 active (running) - 如果没装，Ubuntu/Debian 用
sudo apt install nginx；CentOS 用sudo yum install nginx - 启动后记得开放端口：
sudo ufw allow 'Nginx Full'（Ubuntu）或检查firewalld
把 HTML 文件放对位置（别硬塞到 /root）
Nginx 默认网站根目录是 /var/www/html，Apache 是 /var/www/html（Ubuntu）或 /var/www（CentOS）。上传时必须放这里，或者改配置指向你自己的路径。
- 推荐做法：用
scp把本地dist/或build/目录传上去：scp -r ./dist/* user@your-server-ip:/var/www/html/
- 别用 FTP 工具乱传到
/home/user/my-site—— 没配置的话，Nginx 根本不会读那个路径 - 上传后检查权限：
sudo chown -R $USER:www-data /var/www/html（Ubuntu），否则可能 403 Forbidden
遇到 404 或 403 错误，优先查三件事
不是代码写错了，而是服务器层面拦住了请求。
立即学习“前端免费学习笔记（深入）”；
-
403 Forbidden：多半是目录没开读取权限，或
index.html不在根目录，或 Nginx 配置里漏了index index.html; -
404 Not Found：检查浏览器地址栏是不是带了多余路径（比如访问
http://ip/test/index.html但你只传了index.html到/var/www/html） -
空白页 + 控制台报错
net::ERR_ABORTED：静态资源路径写死了绝对路径（如/css/style.css），但你的站点没部署在域名根路径下——改用相对路径（css/style.css）或配 Nginx 的location前缀
需要 HTTPS 或自定义域名？别跳过证书和 DNS 步骤
Let’s Encrypt 免费证书很方便，但容易忽略两件事：自动续期和 DNS 解析生效时间。
- 用
certbot --nginx -d your-domain.com一键配好 HTTPS，但必须确保your-domain.com的 A 记录已指向服务器 IP（DNS 可能缓存 24 小时） - 证书默认 90 天，加个 cron 自动续期：
0 12 * * 1 /usr/bin/certbot renew --quiet --post-hook "/usr/bin/systemctl reload nginx"
- 如果只是本地测试或内网访问，别折腾域名和证书——直接用 IP + 端口，或改 Hosts 绑定临时域名更省事
最常被忽略的是：HTML 项目没有后端路由，所以前端用 history.pushState（比如 Vue Router 的 history 模式）时，Nginx 必须配 try_files $uri $uri/ /index.html;，否则刷新页面就 404。这个点不在“部署流程”里，却让很多人反复重装服务器。
