速卖通素材
努力

腾讯云服务器部署微信小程序教程?

服务器

在腾讯云服务器上部署微信小程序后端服务,是一个常见的开发与上线流程。以下是一份详细的教程,帮助你从零开始在腾讯云服务器上部署微信小程序的后端服务。


🌐 一、准备工作

1. 注册账号

  • 注册 腾讯云 账号
  • 注册 微信公众平台 账号(用于小程序)

2. 购买腾讯云服务器(CVM)

推荐配置:

  • 操作系统:Ubuntu 20.04 / CentOS 7(建议 Ubuntu)
  • 配置:1核2G起步(适合测试)
  • 带宽:1Mbps 起步
  • 地域:选择离用户近的区域(如广州、上海)

可使用“轻量应用服务器”简化操作(更便宜,集成更好)


💻 二、登录服务器并配置环境

1. 使用 SSH 登录服务器

ssh root@你的公网IP
# 输入密码

2. 更新系统 & 安装必要软件

# Ubuntu 示例
sudo apt update && sudo apt upgrade -y

# 安装 Node.js(以 v18 为例)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node -v
npm -v

3. 安装 PM2(进程管理工具)

npm install -g pm2

4. 安装 Nginx(反向X_X & HTTPS)

sudo apt install nginx -y
sudo systemctl start nginx
sudo systemctl enable nginx

🛠️ 三、上传并运行后端代码

假设你的小程序后端是基于 Node.js 的 Express/Koa 服务。

1. 上传代码到服务器

方式有多种:

  • 使用 scp 命令上传:
    scp -r ./your-backend root@your-server-ip:/root/wechat-app
  • 使用 Git 克隆:
    git clone https://github.com/yourname/weapp-backend.git
    cd weapp-backend
    npm install

2. 启动后端服务

# 启动服务(例如监听 3000 端口)
npm start
# 或使用 PM2 守护进程
pm2 start app.js --name "weapp-api"
pm2 startup
pm2 save

🔐 四、配置域名与 HTTPS(重要!)

微信小程序要求后端接口必须使用 HTTPS 协议

1. 购买或申请免费域名

  • 在腾讯云注册一个域名(如:myapp.com

2. 备案(国内服务器必须备案)

  • 登录腾讯云控制台 → 域名与网站 → 备案

⚠️ 未备案的域名无法绑定国内服务器的 80/443 端口。

3. 申请免费 SSL 证书

  • 腾讯云搜索“SSL证书” → 申请免费证书(TrustAsia)
  • 下载 Nginx 版本证书,上传到服务器 /etc/nginx/ssl/

4. 配置 Nginx 反向X_X

编辑配置文件:

sudo nano /etc/nginx/sites-available/default

示例配置(HTTPS + 反向X_X):

server {
    listen 80;
    server_name api.myapp.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name api.myapp.com;

    ssl_certificate /etc/nginx/ssl/1_api.myapp.com_bundle.crt;
    ssl_certificate_key /etc/nginx/ssl/2_api.myapp.com.key;

    location / {
        proxy_pass http://127.0.0.1:3000;  # 你的 Node.js 服务
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

重启 Nginx:

sudo nginx -t         # 测试配置
sudo systemctl reload nginx

5. 域名解析

  • 进入腾讯云“云解析 DNS”
  • 添加 A 记录:api.myapp.com → 指向你的服务器公网 IP

📱 五、小程序前端配置

1. 修改小程序 request 请求域名

在微信开发者工具中:

  • app.js 或请求代码中,使用你的 HTTPS 域名:
    wx.request({
    url: 'https://api.myapp.com/login',
    // ...
    })

2. 配置小程序后台合法域名

进入 微信公众平台 → 开发管理 → 开发设置

  • https://api.myapp.com 添加到 request 合法域名

注意:不能使用 IP 地址或 HTTP 协议!


✅ 六、测试与上线

  1. 启动后端服务(PM2 管理)
  2. 打开小程序开发者工具,测试网络请求是否成功
  3. 提交审核,发布上线

🧰 常见问题

问题 解决方案
请求失败 ERR_SSL_PROTOCOL_ERROR 检查 Nginx SSL 配置和证书路径
域名未备案 必须完成 ICP 备案才能用 443 端口
接口返回 404 检查 Nginx proxy_pass 是否正确指向服务端口
微信提示域名不合法 检查公众平台配置的 request 域名

🎁 进阶建议

  • 使用 Serverless:腾讯云云函数 SCF + API 网关,免运维
  • 数据库:搭配腾讯云 MongoDB / MySQL(云数据库)
  • 自动化部署:配合 GitHub Actions 或 CODING CI/CD

📚 参考链接

  • 腾讯云官网:https://cloud.tencent.com/
  • 微信小程序文档:https://developers.weixin.qq.com/miniprogram/dev/framework/
  • 腾讯云轻量服务器部署教程:https://cloud.tencent.com/document/product/1266

如果你提供具体的后端技术栈(如 Node.js + Express、Python Flask、Java SpringBoot),我可以给出更详细的部署脚本和配置。

需要我生成一个完整的 Express 示例项目部署流程吗?

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