部署静态资源(HTML/CSS/JS)到云服务器,本质上就是把文件放到一个能对外提供 HTTP 服务的目录里。这活儿看起来简单,但里面有不少“坑”和最佳实践,直接上干货。
根据你手头的服务器类型和技术栈,主要有三种主流方案,按推荐程度排序:
方案一:Nginx + 原生 Linux 服务器(最经典、最可控)
这是大多数后端开发或运维人员的首选,因为 Nginx 处理静态文件的性能极高,且配置灵活。
1. 准备工作
- 一台装有 Linux 系统(CentOS 7+, Ubuntu 18.04+)的云服务器。
- 确保防火墙开放了 80 (HTTP) 和 443 (HTTPS) 端口。如果是阿里云/腾讯云,记得在控制台的安全组里放行这两个端口。
2. 安装 Nginx
以 Ubuntu 为例:
sudo apt update
sudo apt install nginx -y
CentOS 则用 yum install nginx。
3. 上传文件
通常默认的网站根目录是 /var/www/html。你可以直接用 SCP、SFTP(FileZilla)或者 Git 拉取代码到这个目录。
# 假设你把项目文件夹叫 my-site
sudo cp -r ./my-site/* /var/www/html/
sudo chown -R www-data:www-data /var/www/html # 修正权限,防止报错
4. 配置 Nginx
编辑配置文件,通常在 /etc/nginx/sites-available/default 或 /etc/nginx/conf.d/default.conf。
核心配置如下:
server {
listen 80;
server_name your_domain.com; # 换成你的域名或 IP
root /var/www/html;
index index.html;
# 关键:如果找不到文件,返回 404 而不是跳转错误页
location / {
try_files $uri $uri/ =404;
}
# 可选:设置缓存,提速静态资源加载
location ~* .(js|css|png|jpg|jpeg|gif|ico|svg)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
}
保存后重启 Nginx:sudo systemctl restart nginx。
5. 搞定域名解析
去你的域名服务商那里,把 A 记录指向你的服务器公网 IP。这时候访问域名就能看到页面了。
方案二:对象存储 + CDN(国内云厂商标配,成本最低)
如果你用的是阿里云 OSS、腾讯云 COS 或华为云 OBS,这是目前最省心、成本最低的方案。注意:静态网站托管功能通常需要开启。
1. 创建 Bucket
在云控制台创建一个对象存储 Bucket,设置为“公共读”。
2. 开启静态网站托管
在 Bucket 设置里找到“静态页面”或“静态网站托管”,将 index.html 设为主页文档。
3. 上传文件
使用云厂商提供的客户端工具(如 ossutil, coscmd)或者第三方工具(如 Cyberduck, WinSCP)把 HTML/CSS/JS 上传上去。
4. 绑定自定义域名(可选但推荐)
直接访问 OSS 的域名速度极慢且不稳定。你需要:
- 在对象存储控制台绑定一个你自己的域名(如
static.example.com)。 - 必须备案:在国内使用自定义域名访问 OSS,域名必须经过 ICP 备案。
- 配置 CNAME 解析到你的 OSS 域名。
5. 接入 CDN
为了加快全国用户的访问速度,强烈建议在 OSS 前面加一层 CDN。这样用户就近访问边缘节点,速度飞快,还能节省带宽费用。
方案三:Docker 容器化部署(适合微服务架构或 CI/CD)
如果你已经在用 Docker,或者希望环境隔离、一键部署,这是最优雅的方式。
1. 编写 Dockerfile
在项目根目录创建一个 Dockerfile:
FROM nginx:alpine
COPY . /usr/share/nginx/html
# 如果有自定义配置,可以覆盖默认配置
# COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
2. 构建镜像
docker build -t my-static-site .
3. 运行容器
docker run -d -p 8080:80 --name static-web my-static-site
现在通过 http://服务器IP:8080 就能访问了。如果要暴露到网络 80 端口,需要改 -p 80:80,并确保没有冲突。
避坑指南 & 常见问题
-
403 Forbidden?
- 检查文件权限。Linux 下 Nginx 用户通常是
www-data或nginx。确保这些用户对文件有读取权限。 - 检查 SELinux(CentOS 默认开启),如果开了,可能需要执行
setsebool -P httpd_can_network_connect 1或者调整上下文。
- 检查文件权限。Linux 下 Nginx 用户通常是
-
SPA 应用(Vue/React)刷新 404?
- 如果你的前端是单页应用,路由是由 JS 控制的。当用户直接访问
/user/profile时,服务器找不到这个物理文件。 - 解决:在 Nginx 配置中加入 fallback 规则:
location / { try_files $uri $uri/ /index.html; }这样所有不存在的请求都会回退到
index.html,由前端路由接管。
- 如果你的前端是单页应用,路由是由 JS 控制的。当用户直接访问
-
HTTPS 证书怎么办?
- 现在浏览器对 HTTP 不友好(标记为“不安全”)。建议申请免费 SSL 证书(Let’s Encrypt 或云厂商免费证书)。
- 如果使用 Nginx,配置
listen 443 ssl并指定证书路径即可。 - 如果用了 CDN 或云厂商的对象存储,通常它们提供一键开启 HTTPS 的功能,更省事。
-
为什么不用 Apache?
- 对于纯静态文件,Nginx 的性能远超 Apache,内存占用更低。除非你有特殊的
.htaccess依赖,否则首选 Nginx。
- 对于纯静态文件,Nginx 的性能远超 Apache,内存占用更低。除非你有特殊的
总结建议
- 学习/测试/小项目:直接用 Nginx,装好就能用,方便调试。
- 生产环境/高并发/低成本:用 OSS/COS + CDN,几乎零运维成本,按量付费,带宽便宜。
- 已有 Docker 体系:用 Docker + Nginx 镜像,保持技术栈统一。
选哪种取决于你的团队技术栈和对运维成本的容忍度。不管选哪种,务必做好域名备案,否则在国内网络环境下,你的服务随时可能被阻断。
云技术博客