将微信小程序部署到云服务器主要包括以下几个步骤。这里假设你已经完成了小程序的前端开发,并希望将后端服务(如 Node.js、PHP、Java 等)部署到自己的云服务器上,而不是使用微信云开发。
一、准备材料
- 微信小程序账号:已注册并拥有 AppID。
- 云服务器(VPS):例如阿里云、腾讯云、华为云、AWS 等。
- 域名:用于接口请求,必须备案(我国大陆服务器需要)。
- SSL证书(可选):如果你要使用 HTTPS 协议。
- 小程序代码 和 后端项目代码。
二、部署流程
步骤 1:配置云服务器环境
1. 登录服务器
使用 SSH 登录你的云服务器:
ssh root@your_server_ip
2. 安装运行环境
根据你的后端语言安装相应的环境,例如:
-
Node.js:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs -
Nginx(反向):
sudo apt update sudo apt install nginx -
MySQL / MongoDB / Redis等数据库/缓存服务也需安装。
3. 部署你的后端服务
上传你的后端项目到服务器(可以通过 FTP、SCP、Git 或直接下载压缩包):
git clone https://github.com/yourname/your-backend.git
cd your-backend
npm install
npm run start
建议使用
pm2来管理 Node.js 服务:npm install pm2 -g pm2 start app.js --name myapp
步骤 2:配置 Nginx 反向(可选)
创建一个新的站点配置文件:
sudo nano /etc/nginx/sites-available/myapi
写入如下内容(示例):
server {
listen 80;
server_name api.yourdomain.com;
location / {
proxy_pass http://localhost:3000; # 后端服务监听的端口
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
启用站点并重启 Nginx:
sudo ln -s /etc/nginx/sites-available/myapi /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
步骤 3:配置域名和 HTTPS
-
绑定域名
- 在 DNS 提供商处解析你的域名到服务器 IP。
- 如
api.yourdomain.com指向你的服务器公网 IP。
-
申请 SSL 证书(HTTPS)
推荐使用 Let’s Encrypt 免费证书:sudo apt install certbot python3-certbot-nginx sudo certbot --nginx -d api.yourdomain.com之后会自动配置 HTTPS。
步骤 4:配置微信开发者工具
在小程序项目中,修改请求地址为你的域名:
wx.request({
url: 'https://api.yourdomain.com/api/login',
success(res) {
console.log(res.data)
}
})
微信后台配置域名白名单:
- 登录 微信公众平台
- 找到「开发」->「开发管理」->「开发设置」
- 设置 服务器域名:
- request合法域名:
https://api.yourdomain.com - socket合法域名(如果用 WebSocket)
- uploadFile合法域名
- downloadFile合法域名
- request合法域名:
⚠️ 注意:
- 必须使用 HTTPS
- 域名必须备案(国内服务器)
- 不支持 IP 地址或 localhost
三、测试与上线
- 小程序本地调试无误后,上传代码。
- 登录微信公众平台提交审核。
- 审核通过后即可发布上线。
四、常见问题
| 问题 | 解决方案 |
|---|---|
| 请求被拦截 | 检查是否添加了域名白名单 |
| 域名未备案 | 联系服务商进行备案 |
| 无法访问服务器 | 检查防火墙、安全组设置 |
| HTTPS 报错 | 检查证书是否正确安装,域名是否匹配 |
五、补充说明
如果你不想自己搭建服务器,也可以使用微信官方提供的 云开发 TCB(CloudBase),它提供数据库、存储、函数、CDN 等能力,适合中小型项目快速上线。
总结
部署微信小程序到云服务器的核心是:
✅ 搭建服务器环境
✅ 部署后端服务
✅ 配置域名和 HTTPS
✅ 设置微信域名白名单
✅ 测试并发布小程序
如果你告诉我你使用的后端语言(如 Node.js、Python、Java),我可以给你更具体的部署命令和配置示例。需要吗?
云计算HECS