将微信小程序部署到自己的服务器上,主要分为以下几个步骤。这里假设你已经开发好了微信小程序,并希望将其后端服务(如 API 接口、数据库等)部署在自己的服务器上。
一、准备工作
1. 准备服务器
- 可以是阿里云、腾讯云、华为云、VPS 等。
- 建议使用 Linux 系统(如 CentOS、Ubuntu),也支持 Windows Server。
- 配置好域名 + 备案(微信要求接口必须有备案域名)。
2. 安装运行环境
根据你的后端技术栈安装相应环境:
- Node.js(适用于 Express/Koa/NestJS 等)
- Nginx(用于反向X_X或静态资源托管)
- MySQL / MongoDB / PostgreSQL(数据库)
- Redis(可选)
3. 微信开发者工具
- 下载并安装 微信开发者工具
二、部署后端服务到服务器
1. 编写后端 API
确保你有一个可用的后端服务(Node.js、Java、PHP、Python 等均可),提供 RESTful API 接口供小程序调用。
示例(Node.js + Express):
const express = require('express');
const app = express();
app.get('/api/hello', (req, res) => {
res.json({ message: 'Hello from server' });
});
app.listen(3000, () => {
console.log('Server running on port 3000');
});
2. 将代码上传到服务器
可以通过以下方式上传项目代码:
- 使用
git clone - 使用 FTP/SFTP 工具(如 FileZilla)
- 使用 SCP 命令传输文件
3. 启动服务
使用 PM2 或直接运行:
node app.js
# 或使用 pm2 进程管理器保持后台运行
pm2 start app.js
4. 配置 Nginx(可选)
配置反向X_X,让请求走 80/443 端口:
server {
listen 80;
server_name yourdomain.com;
location /api/ {
proxy_pass http://localhost:3000/;
}
}
重启 Nginx:
systemctl restart nginx
三、配置小程序访问服务器
1. 登录微信公众平台
地址:https://mp.weixin.qq.com
2. 设置服务器域名
进入【开发】->【开发管理】->【开发设置】->【服务器域名】
需要配置以下几项:
- request合法域名(HTTPS,不能带端口号)
- uploadFile合法域名
- downloadFile合法域名
- websocket合法域名
注意:
- 必须使用 HTTPS 协议
- 域名必须备案
- 不允许使用 IP 地址作为域名
例如添加:
https://yourdomain.com
四、小程序中调用后端 API 示例
wx.request({
url: 'https://yourdomain.com/api/hello',
success(res) {
console.log(res.data);
}
});
五、HTTPS 证书配置(重要)
微信小程序要求所有网络请求必须通过 HTTPS。
解决方案:
- 购买 SSL 证书(阿里云、腾讯云等提供免费 DV 证书)
- 使用 Let’s Encrypt 免费证书(推荐)
使用 Certbot 获取证书:
sudo apt install certbot
sudo certbot --nginx -d yourdomain.com
六、注意事项
| 事项 | 说明 |
|---|---|
| 域名备案 | 必须完成 ICP 备案 |
| HTTPS | 必须启用 HTTPS,否则无法上线 |
| 不支持本地IP | 不能使用公网 IP 直接访问 |
| 不支持 localhost | 开发时可以开启不校验域名校验,但上线前必须关闭 |
| 接口权限控制 | 建议做 token 验证、防止调用 |
七、总结流程图
小程序客户端 --> 发送请求到你自己的服务器域名
↓
自建服务器接收请求
↓
处理逻辑并返回数据给小程序
如果你能提供具体的技术栈(比如你是用 Node.js、Java、PHP 还是 Python),我可以给出更具体的部署指导。
是否需要我为你生成一个完整的部署脚本或文档?欢迎继续提问!
CDNK博客