将前端项目部署到阿里云服务器是一个常见的需求,以下是详细的步骤指南。我们假设你的前端项目是基于 Vue、React 或 Angular 等现代框架构建的静态网站。
🧱 一、准备材料
- 阿里云 ECS 实例(Linux)
- 域名(可选但推荐)
- 前端打包后的 dist 文件夹(如
npm run build生成的文件) - FTP 工具或命令行上传方式(如:scp、rsync、ftp、sftp)
- Nginx(用于托管静态资源)
🔧 二、部署流程
步骤 1:购买并配置阿里云 ECS 服务器
- 登录 阿里云控制台
- 购买一个 ECS 实例(建议选择 Ubuntu 或 CentOS)
- 配置安全组规则:
- 开放
80端口(HTTP) - 开放
443端口(HTTPS) - 开放
22端口(SSH)
- 开放
步骤 2:连接服务器
使用 SSH 连接:
ssh root@你的公网IP
如果使用密钥登录:
ssh -i /path/to/your-key.pem root@你的公网IP
步骤 3:安装 Nginx
以 Ubuntu 为例:
sudo apt update
sudo apt install nginx -y
启动 Nginx:
sudo systemctl start nginx
sudo systemctl enable nginx
检查是否运行成功:
systemctl status nginx
访问你的公网 IP 地址,看到 Nginx 欢迎页面说明安装成功。
步骤 4:上传前端项目
方法一:本地打包 + FTP/SFTP 上传
在本地执行打包命令:
npm run build
打包完成后,使用工具上传 dist 目录到服务器,例如:
- 使用 FileZilla(SFTP)
- 使用命令行 scp:
scp -r dist/* root@你的公网IP:/var/www/html
注意:确保
/var/www/html存在,或者你也可以自定义路径。
步骤 5:配置 Nginx 托管前端项目
编辑默认站点配置:
sudo nano /etc/nginx/sites-available/default
修改内容如下:
server {
listen 80;
server_name your-domain.com www.your-domain.com;
location / {
root /var/www/html;
index index.html;
try_files $uri $uri/ =404;
}
}
保存后重启 Nginx:
sudo systemctl restart nginx
步骤 6:绑定域名(可选)
- 在阿里云控制台申请域名(或已有域名)
- 解析域名到你的 ECS 公网 IP
- 添加 A 记录指向服务器 IP
- 修改 Nginx 的
server_name为你自己的域名
步骤 7:配置 HTTPS(可选)
使用 Let’s Encrypt 免费证书:
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx
按照提示操作即可自动配置 HTTPS。
✅ 三、常见问题
| 问题 | 解决方法 |
|---|---|
| 页面打开空白 | 检查 Nginx 配置中 root 路径是否正确 |
| CSS/JS 加载失败 | 检查前端打包时是否使用相对路径(Vue/React 默认是相对路径) |
| 无法访问网站 | 检查安全组是否开放 80/443 端口 |
| 页面刷新 404 | 确保 try_files 配置正确 |
📦 四、进阶建议
- 使用 CI/CD 自动化部署(如 Jenkins、GitHub Actions)
- 使用对象存储 OSS + CDN X_X前端资源
- 前端 + 后端分离部署,用 Nginx 反向X_X API 请求
如果你能提供以下信息,我可以给你更具体的部署方案:
- 前端项目类型(Vue、React、Angular?)
- 是否有后端?
- 是否需要 HTTPS?
- 是否已经拥有域名?
需要我帮你写一份完整的 Nginx 配置模板吗?
CDNK博客