Vue3 + Node.js + MySQL 全栈项目云服务器部署实战指南
当你完成了一个Vue3前端、Node.js后端和MySQL数据库的全栈项目开发,接下来最关键的步骤就是将它部署到云服务器上,让全世界都能访问你的作品。本文将带你一步步完成从本地开发环境到线上部署的全过程,涵盖宝塔面板配置、服务器环境搭建、项目部署和运维管理等核心环节。
1. 部署前的准备工作
在开始部署之前,我们需要确保本地开发环境和云服务器都做好了充分准备。这一阶段的工作将为后续的顺利部署奠定基础。
首先,确认你的本地项目已经完成以下准备工作:
- 前端项目:使用
npm run build命令成功生成dist文件夹 - 后端项目:确保所有依赖都已安装,可以通过
npm start或自定义启动命令正常运行 - 数据库:准备好数据库导出文件或创建脚本
对于云服务器,你需要:
- 购买一台云服务器(推荐1核2G以上配置)
- 获取服务器的IP地址、用户名和密码
- 确保服务器的安全组已开放以下端口:
- 80(HTTP)
- 443(HTTPS)
- 3000或你自定义的后端端口
- 3306(MySQL,建议仅限本地访问)
提示:如果你使用的是阿里云、腾讯云等云服务商,记得在控制台的安全组设置中开放相应端口。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 服务器基础环境配置
2.1 连接服务器
使用SSH工具连接你的云服务器。Windows用户可以使用PuTTY或MobaXterm,Mac用户可以直接使用终端:
bash复制ssh root@your_server_ip
输入密码后,你就成功登录到了服务器。建议立即更新系统软件包:
bash复制apt update && apt upgrade -y # Ubuntu/Debian
yum update -y # CentOS
2.2 安装宝塔面板
宝塔面板是一款强大的服务器管理工具,可以大大简化我们的部署流程。安装命令如下:
bash复制wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh
安装完成后,你会看到面板的访问地址、用户名和密码。记下这些信息,然后在浏览器中访问面板。
首次登录后,宝塔会推荐安装一些基础软件。对于我们的项目,建议选择:
- Nginx 1.20+
- MySQL 5.7+
- PM2管理器
- PHP(可选,如果不需要可以跳过)
3. 项目部署流程
3.1 前端项目部署
首先,我们将Vue3项目部署到服务器上:
-
在本地项目目录下运行构建命令:
bash复制
npm run build这会生成一个dist文件夹,包含所有静态资源。
-
使用SFTP工具(如FileZilla)或宝塔的文件管理器,将dist文件夹上传到服务器的
/www/wwwroot目录下,建议创建一个专门的文件夹如/www/wwwroot/my-vue-app。 -
在宝塔面板中创建网站:
- 点击"网站" → "添加站点"
- 填写域名(如果没有域名,可以直接用IP地址)
- 根目录选择刚才上传的dist文件夹路径
- 其他设置保持默认
-
配置Nginx反向代理(解决跨域问题):
在宝塔面板中找到对应站点的设置,点击"配置文件",在server块中添加:nginx复制location /api { proxy_pass http://localhost:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }
3.2 后端项目部署
Node.js后端项目的部署稍微复杂一些,我们需要确保它能够持续运行:
-
将整个Node.js项目上传到服务器,建议放在
/www/server目录下,例如/www/server/my-node-app。 -
安装项目依赖:
bash复制cd /www/server/my-node-app npm install --production -
使用PM2管理Node.js进程:
bash复制pm2 start app.js --name "my-node-app"PM2常用命令:
pm2 list:查看所有进程pm2 logs:查看日志pm2 restart:重启应用pm2 delete:删除应用
-
设置PM2开机自启:
bash复制
pm2 startup pm2 save
3.3 数据库部署
MySQL数据库的部署需要特别注意安全性:
-
在宝塔面板的数据库模块中创建新数据库,记下数据库名、用户名和密码。
-
导入本地数据库:
- 将本地的SQL导出文件上传到服务器
- 在宝塔的数据库界面点击"导入",选择你的SQL文件
-
修改Node.js项目的数据库连接配置,确保与服务器上的数据库信息一致。
-
安全建议:
- 修改MySQL默认端口(非3306)
- 设置强密码
- 限制只能本地访问(在宝塔的安全设置中配置)
4. 常见问题与解决方案
在部署过程中,你可能会遇到各种问题。以下是几个常见问题及其解决方法:
4.1 端口冲突或未开放
症状:无法访问网站或API接口
解决方案:
- 检查宝塔面板的安全组和服务器提供商的安全组设置
- 确认Nginx配置正确
- 使用
netstat -tulnp查看端口占用情况
4.2 文件权限问题
症状:无法上传文件或程序无法写入日志
解决方案:
bash复制chown -R www:www /www/wwwroot
chmod -R 755 /www/wwwroot
4.3 PM2进程崩溃
症状:Node.js应用突然停止响应
解决方案:
- 检查应用日志:
bash复制
pm2 logs - 配置PM2自动重启:
bash复制pm2 start app.js --name "my-app" --watch --max-memory-restart 300M
4.4 数据库连接失败
症状:应用无法连接MySQL
解决方案:
- 确认数据库服务正在运行:
bash复制
systemctl status mysqld - 检查连接字符串中的主机、端口、用户名和密码
- 确保MySQL允许远程连接(不推荐生产环境使用)
5. 高级配置与优化
项目成功部署后,我们可以进一步优化性能和安全性:
5.1 启用HTTPS
使用Let's Encrypt免费SSL证书:
- 在宝塔面板的网站设置中,找到SSL选项
- 选择Let's Encrypt,勾选要申请的域名
- 强制HTTPS跳转
5.2 Nginx性能优化
编辑Nginx配置文件,添加以下参数:
nginx复制gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
gzip_min_length 1000;
gzip_comp_level 6;
client_max_body_size 20m;
keepalive_timeout 65;
5.3 数据库备份策略
在宝塔面板中设置定期自动备份:
- 进入"计划任务"
- 添加数据库备份任务
- 设置备份周期和保留份数
- 可选:配置备份到远程存储(如阿里云OSS)
5.4 监控与告警
使用宝塔的监控功能或配置第三方服务:
- 服务器资源监控
- 网站可用性监控
- 异常流量告警
6. 持续集成与自动化部署
对于需要频繁更新的项目,可以考虑设置自动化部署流程:
6.1 使用Git钩子
在服务器上配置Git仓库,设置post-receive钩子自动拉取代码并重启服务:
bash复制#!/bin/bash
WEB_DIR="/www/wwwroot/my-vue-app"
GIT_DIR="/www/repos/my-vue-app.git"
git --work-tree=$WEB_DIR --git-dir=$GIT_DIR checkout -f
cd $WEB_DIR && npm install && npm run build
6.2 配置CI/CD管道
可以使用GitHub Actions、GitLab CI等工具实现自动化测试和部署。示例GitHub Actions配置:
yaml复制name: Deploy to Production
on:
push:
branches: [ main ]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Install SSH Key
uses: shimataro/ssh-key-action@v2
with:
key: ${{ secrets.SSH_PRIVATE_KEY }}
known_hosts: ${{ secrets.KNOWN_HOSTS }}
- name: Deploy to Server
run: |
ssh root@your_server_ip "cd /www/server/my-node-app && git pull && npm install && pm2 restart all"
6.3 使用Docker容器化
对于更复杂的项目,可以考虑使用Docker简化部署:
dockerfile复制# Node.js后端Dockerfile示例
FROM node:16
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["node", "app.js"]
然后使用docker-compose编排前端、后端和数据库服务。
部署全栈项目到云服务器看似复杂,但通过合理的规划和工具使用,可以大大简化这个过程。从我的经验来看,成功部署的关键在于:
- 清晰的部署文档:记录每一步操作和配置
- 充分的测试:在本地模拟生产环境进行测试
- 备份策略:确保在出现问题时能快速恢复
- 监控系统:及时发现并解决问题
记住,部署不是终点,而是运维的起点。定期更新系统、监控性能和安全性,才能确保你的应用长期稳定运行。
