将“若依”(RuoYi)微信小程序部署到阿里云服务器,实际上涉及多个环节:前端小程序、后端 Java 服务、数据库、以及部署环境(阿里云服务器)。下面是一个完整的部署流程说明,适用于 RuoYi-Weapp(微信小程序版) + RuoYi-Backend(Spring Boot 后端) 部署在阿里云 ECS 上。
一、准备工作
1. 购买阿里云服务器(ECS)
- 地域选择:靠近用户(如华南1 – 广州)
- 系统:推荐 Ubuntu 20.04 LTS 或 CentOS 7
- 配置:至少 2核4G(适合中小型项目)
- 安全组:开放以下端口:
22(SSH)80(HTTP)443(HTTPS)8080(Spring Boot 默认端口,可自定义)
2. 域名(可选但推荐)
- 申请一个域名(如:
api.yourdomain.com) - 备案(国内服务器必须备案)
- DNS 解析到 ECS 公网 IP
3. 获取 RuoYi 项目源码
- 后端:https://gitee.com/y_project/RuoYi
- 小程序前端:https://gitee.com/y_project/RuoYi-Weapp
二、部署后端(RuoYi Spring Boot)
1. 登录阿里云 ECS
ssh root@你的ECS公网IP
2. 安装必要环境
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Java 8 或 11(RuoYi 通常用 Java 8)
sudo apt install openjdk-8-jdk -y
# 安装 Maven
sudo apt install maven -y
# 安装 MySQL
sudo apt install mysql-server -y
sudo mysql_secure_installation
3. 配置 MySQL 数据库
-- 登录 MySQL
mysql -u root -p
-- 创建数据库
CREATE DATABASE ruoyi DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
-- 授权用户(可选)
CREATE USER 'ruoyi'@'%' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON ruoyi.* TO 'ruoyi'@'%';
FLUSH PRIVILEGES;
导入 RuoYi 的 SQL 文件:
- 下载
ry_2023xxxx.sql(从 RuoYi 项目中的sql/目录) - 上传到服务器,执行:
mysql -u root -p ruoyi < ry_2023xxxx.sql
4. 修改后端配置文件
进入 RuoYi 项目目录,修改:
# resources/application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
username: ruoyi
password: 你的密码
5. 打包并运行后端
mvn clean package -Dmaven.test.skip=true
java -jar ruoyi-admin/target/ruoyi-admin.jar
推荐使用
nohup或systemd后台运行:nohup java -jar ruoyi-admin.jar > app.log 2>&1 &
三、配置 Nginx(可选,用于反向X_X和 HTTPS)
1. 安装 Nginx
sudo apt install nginx -y
2. 配置反向X_X
编辑 /etc/nginx/sites-available/ruoyi:
server {
listen 80;
server_name api.yourdomain.com;
location / {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
启用配置:
sudo ln -s /etc/nginx/sites-available/ruoyi /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
3. 申请 SSL 证书(HTTPS)
- 使用阿里云免费证书或 Let’s Encrypt
- 配置 HTTPS 端口 443
四、微信小程序前端(RuoYi-Weapp)
1. 修改请求域名
在小程序项目中修改 utils/request.js 或 api.js:
// 将请求地址从 localhost 改为你的服务器域名
baseURL: 'https://api.yourdomain.com'
2. 上传代码到微信开发者工具
- 使用微信开发者工具打开
RuoYi-Weapp项目 - 修改
app.js中的 API 地址 - 预览或上传代码
3. 微信公众平台配置
- 登录 微信公众平台
- 设置 服务器域名:
- request 合法域名:
https://api.yourdomain.com - socket 合法域名(如有)
- request 合法域名:
- 注意:必须使用 HTTPS
五、安全与优化建议
- 防火墙:只开放必要端口
- 数据库安全:不要使用 root 远程连接
- 后端安全:避免暴露敏感接口,启用 JWT 鉴权
- 日志监控:使用
journalctl或logrotate - 自动部署:可结合 Jenkins / GitHub Actions
六、常见问题
| 问题 | 解决方案 |
|---|---|
| 小程序请求失败 | 检查域名是否备案、HTTPS、合法域名配置 |
| 后端连接数据库失败 | 检查 MySQL 用户权限、防火墙、配置文件 |
| 接口返回 404 | 检查 Nginx 是否X_X正确,后端是否启动 |
| 登录失败 | 检查 JWT 密钥、用户数据是否导入 |
七、参考文档
- 若依官方文档:https://doc.ruoyi.vip
- 阿里云 ECS 文档:https://help.aliyun.com/product/25365.html
- 微信小程序开发文档:https://developers.weixin.qq.com/miniprogram/dev/framework/
✅ 完成以上步骤后,你的若依微信小程序就可以通过域名访问后端 API,实现完整部署。
如果你提供更具体的版本(如 RuoYi-Vue、RuoYi-Cloud),我可以给出更精确的部署方案。需要的话也可以提供一键部署脚本。
秒懂云