速卖通素材
努力

腾讯云轻量应用服务器部署微信小程序?

服务器

在腾讯云轻量应用服务器(Lighthouse)上部署微信小程序,核心原则是:小程序本身不能直接“运行”在服务器上

微信小程序是一个客户端应用,用户通过微信 App 访问。你的服务器只需要提供后端 API 接口(用于处理业务逻辑、数据库读写等),供小程序调用即可。

以下是完整的部署流程和关键注意事项:

1. 架构理解

  • 前端(小程序):由开发者在微信开发者工具中编写代码,编译后上传到微信官方服务器,用户扫码或搜索即可使用。不需要部署在你的腾讯云服务器上。
  • 后端(服务器):部署在轻量应用服务器上,负责接收小程序发出的 HTTP/HTTPS 请求,处理数据并返回结果。
  • 通信:小程序 <-> (HTTPS) <-> 轻量应用服务器 API。

2. 准备工作

在开始之前,请确保你拥有:

  1. 已备案的域名:这是最关键的一步。根据我国法律法规,微信小程序的服务器域名必须在 ICP 备案列表中。
    • 注意:直接使用 IP 地址是无法配置合法域名的,且无法通过微信后台校验。
  2. SSL 证书:小程序强制要求后端接口必须使用 HTTPS 协议。你需要购买或申请免费 SSL 证书并绑定到你的域名。
  3. 轻量应用服务器:已创建实例,操作系统建议选择 Ubuntu 20.04/22.04 或 CentOS 7.9。

3. 具体部署步骤

第一步:配置域名与 SSL

  1. 解析域名:在腾讯云 DNS 控制台,将你的域名 A 记录指向轻量应用服务器的公网 IP。
  2. 申请证书
    • 进入腾讯云【SSL 证书】控制台。
    • 选择“免费版”或付费版,申请域名型证书。
    • 下载证书文件(通常包含 .crt.key 两个文件)。
  3. 安装证书

    • 登录轻量应用服务器终端。
    • 将证书文件上传到服务器(例如 /root/cert/ 目录)。
    • 配置 Web 服务器(Nginx 或 Apache)启用 HTTPS。以 Nginx 为例:

      server {
          listen 443 ssl;
          server_name your-domain.com; # 替换为你的域名
      
          ssl_certificate /root/cert/fullchain.pem;
          ssl_certificate_key /root/cert/private.key;
      
          location / {
              # 这里配置反向X_X到你的 Node.js/Java/Python 服务端口
              proxy_pass http://localhost:3000; 
          }
      }
      
      # 强制跳转 HTTPS (可选但推荐)
      server {
          listen 80;
          server_name your-domain.com;
          return 301 https://$server_name$request_uri;
      }

第二步:搭建后端环境

根据你的技术栈选择一种方式安装运行环境。轻量应用服务器有预装的镜像(如 Node.js, Python, Java 等),也可以手动安装。

  • 方案 A:使用 Node.js (推荐)
    # 安装 Node.js (如果未安装)
    curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
    sudo apt-get install nodejs -y
    # 安装 PM2 进程管理器
    npm install pm2 -g
  • 方案 B:使用 Python (Django/Flask)
    sudo apt update
    sudo apt install python3-pip python3-venv -y
    # 激活虚拟环境并安装依赖

第三步:修改小程序后端配置

在你的后端代码中(例如 app.js 或配置文件),将请求地址改为你的 HTTPS 域名:

// 示例:Node.js (Express/Koa)
const app = require('express')();
const port = 3000; // 本地监听端口

app.listen(port, () => {
  console.log(`Server running at http://your-domain.com/api`);
});

同时,确保你的代码支持跨域(CORS),或者在 Nginx 层面配置好 CORS 头。

第四步:提交至微信公众平台

这是最容易出错的一步。

  1. 登录 微信公众平台。
  2. 进入 开发管理 -> 开发设置
  3. 找到 服务器域名 板块。
  4. request 合法域名 中添加你的 HTTPS 域名(例如 https://api.your-domain.com)。
    • 注意:必须带 https:// 前缀,且不能有路径 /api 这种后缀,只能是根域名。
  5. 保存后,点击“校验”,如果提示成功,则配置完成。

第五步:启动服务

使用 PM2 或其他进程管理器启动你的后端程序,并设置开机自启:

pm2 start app.js --name "my-miniprogram-api"
pm2 startup
pm2 save

4. 常见问题与避坑指南

问题点 解决方案
无法配置域名 检查域名是否已完成 ICP 备案。未备案的域名无法添加到微信后台的“服务器域名”列表中。
接口报错 404 或 500 检查轻量应用服务器的安全组规则,确保 80/443 端口开放,同时确保你的后端服务端口(如 3000)被 Nginx 正确转发。
微信提示“不在以下 request 合法域名列表中” 仔细核对微信后台填写的域名是否与 Nginx 配置的 Server Name 完全一致(包括大小写、http/https)。
证书过期 免费证书有效期通常为 90 天,需设置定时任务自动续期(如使用 Certbot)。
流量费用 轻量应用服务器的流量包通常有限额(如 1TB/月),如果小程序用户量大,注意监控流量,避免超额扣费。

总结

部署的核心不在于“把小程序放在服务器上”,而在于“搭建一个带有 HTTPS 认证的 API 后端,并将该域名在微信后台白名单化”。只要完成了ICP 备案SSL 证书配置微信后台域名校验这三步,轻量应用服务器就能完美支撑微信小程序的后端需求。

未经允许不得转载:轻量云Cloud » 腾讯云轻量应用服务器部署微信小程序?