微信小程序如何部署到云服务器?

将微信小程序部署到云服务器主要包括以下几个步骤。这里假设你已经完成了小程序的前端开发,并希望将后端服务(如 Node.js、PHP、Java 等)部署到自己的云服务器上,而不是使用微信云开发。


一、准备材料

  1. 微信小程序账号:已注册并拥有 AppID。
  2. 云服务器(VPS):例如阿里云、腾讯云、华为云、AWS 等。
  3. 域名:用于接口请求,必须备案(我国大陆服务器需要)。
  4. SSL证书(可选):如果你要使用 HTTPS 协议。
  5. 小程序代码后端项目代码

二、部署流程

步骤 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

  1. 绑定域名

    • 在 DNS 提供商处解析你的域名到服务器 IP。
    • api.yourdomain.com 指向你的服务器公网 IP。
  2. 申请 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)
  }
})

微信后台配置域名白名单:

  1. 登录 微信公众平台
  2. 找到「开发」->「开发管理」->「开发设置」
  3. 设置 服务器域名
    • request合法域名:https://api.yourdomain.com
    • socket合法域名(如果用 WebSocket)
    • uploadFile合法域名
    • downloadFile合法域名

⚠️ 注意:

  • 必须使用 HTTPS
  • 域名必须备案(国内服务器)
  • 不支持 IP 地址或 localhost

三、测试与上线

  1. 小程序本地调试无误后,上传代码。
  2. 登录微信公众平台提交审核。
  3. 审核通过后即可发布上线。

四、常见问题

问题 解决方案
请求被拦截 检查是否添加了域名白名单
域名未备案 联系服务商进行备案
无法访问服务器 检查防火墙、安全组设置
HTTPS 报错 检查证书是否正确安装,域名是否匹配

五、补充说明

如果你不想自己搭建服务器,也可以使用微信官方提供的 云开发 TCB(CloudBase),它提供数据库、存储、函数、CDN 等能力,适合中小型项目快速上线。


总结

部署微信小程序到云服务器的核心是:

✅ 搭建服务器环境
✅ 部署后端服务
✅ 配置域名和 HTTPS
✅ 设置微信域名白名单
✅ 测试并发布小程序


如果你告诉我你使用的后端语言(如 Node.js、Python、Java),我可以给你更具体的部署命令和配置示例。需要吗?

未经允许不得转载:云计算HECS » 微信小程序如何部署到云服务器?