最简静态页部署是将index.html放入Nginx的/usr/share/nginx/html/或Apache的/var/www/html/目录;需注意权限、文件名、缓存及SPA路由配置(Nginx用try_files,Apache用.htaccess+mod_rewrite)。

直接把 index.html 放进 Nginx 的 /usr/share/nginx/html/ 就能访问
只要 Nginx 服务在运行,且没改过默认配置,把 HTML 文件丢进这个目录就是最简部署方式。Apache 类似,对应路径通常是 /var/www/html/。别折腾构建工具或服务器配置——纯静态页面不需要后端、不依赖 Node.js、也不用打包。
常见错误现象:403 Forbidden(权限不对)、404 Not Found(路径放错)、浏览器缓存旧版本(Ctrl+F5 强刷)。
- 确认文件名是
index.html,否则要手动加路径访问,比如http://your-ip/test.html - Linux 下检查权限:
ls -l /usr/share/nginx/html/,确保 Nginx 进程用户(通常是nginx或www-data)有读取权 - 上传后执行
sudo nginx -t验证配置,再sudo systemctl reload nginx生效(不是 restart)
用 scp 或 rsync 上传 HTML 到远程服务器
本地写好 index.html,想传到云服务器?命令行比 FTP 工具更稳、可复现、适合后续自动化。
使用场景:你有 SSH 权限,服务器已装好 Nginx/Apache,只是缺文件。
-
scp index.html user@server:/usr/share/nginx/html/—— 最简单,适合单文件 -
rsync -avz --delete ./dist/ user@server:/usr/share/nginx/html/—— 适合整个静态目录(如构建后的dist),--delete会清理目标端多余文件 - 注意路径结尾的
/:html/表示“放进该目录”,html(无斜杠)表示“重命名为 html”
Apache 要注意 .htaccess 和 mod_rewrite 是否启用
如果你的 HTML 里用了前端路由(比如 Vue Router 的 history 模式),直接扔进 Apache 可能点二级链接就 404——这不是文件丢了,是 Apache 没把请求 fallback 到 index.html。
解决点很窄:只影响带路由跳转的单页应用(SPA),纯静态页面完全不用管。
- 确认
mod_rewrite已启用:a2enmod rewrite+systemctl restart apache2 - 在网站根目录放
.htaccess,内容只需三行:RewriteEngine On<br>RewriteBase /<br>RewriteRule ^index\.html$ - [L]<br>RewriteCond %{REQUEST_FILENAME} !-f<br>RewriteCond %{REQUEST_FILENAME} !-d<br>RewriteRule . /index.html [L] - 还要确保虚拟主机配置里允许覆盖:
AllowOverride All在对应块中
Nginx 的 try_files 是 SPA 路由的标配配置
和 Apache 的 .htaccess 对应,Nginx 用 try_files 实现同样效果。漏掉这行,Vue/React 路由刷新就 404。
性能影响几乎为零,但必须写在 location / 块里,不能只写在 server 级。
- 标准写法:
location / {<br> try_files $uri $uri/ /index.html;<br>} - 别写成
try_files $uri /index.html;(少了$uri/),否则目录访问会失败 - 如果用了子路径部署(比如
/myapp/),try_files要配/myapp/index.html,且前端路由 base 也要同步改
真正卡住人的往往不是怎么传文件,而是传完发现打不开——这时候先看浏览器地址栏是否多了一串路径、控制台有没有 404 请求、Nginx/Apache 的 error log 在哪(/var/log/nginx/error.log)、以及你到底有没有 reload 服务而不是只改了文件。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











