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

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


🧩 一、准备工作

1. 注册账号

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

2. 购买云服务器(CVM)

  • 登录腾讯云控制台 → 云服务器 CVM → 创建实例
  • 推荐配置(新手):
    • 地域:选择离用户近的(如广州、上海)
    • 镜像:Ubuntu Server 20.04 或 CentOS 7
    • 实例规格:1核2G(轻量应用够用)
    • 带宽:1Mbps 起步
    • 安全组:放行 HTTP(80)、HTTPS(443)、SSH(22)

✅ 建议使用「轻量应用服务器」更便宜,适合小程序后端。


🛠 二、配置云服务器环境

1. 登录服务器(使用 SSH)

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

2. 更新系统 & 安装基础软件

# Ubuntu
sudo apt update && sudo apt upgrade -y
sudo apt install nginx nodejs npm git -y

# CentOS
sudo yum update -y
sudo yum install nginx nodejs npm git -y

3. 安装 PM2(Node.js 进程管理)

npm install -g pm2

4. 安装数据库(可选:MySQL / MongoDB)

示例:安装 MySQL

sudo apt install mysql-server -y  # Ubuntu
sudo mysql_secure_installation

🌐 三、部署后端服务(以 Node.js + Express 为例)

1. 上传或克隆你的后端代码

git clone https://github.com/yourname/your-weapp-backend.git
cd your-weapp-backend
npm install

2. 修改配置文件(如数据库连接、端口等)

// config/db.js
module.exports = {
  host: 'localhost',
  user: 'root',
  password: '你的密码',
  database: 'weapp'
};

3. 启动服务(使用 PM2)

pm2 start app.js --name weapp-api
pm2 save
pm2 startup  # 设置开机自启

默认监听 3000 端口(或其他你设置的端口)


🔄 四、配置 Nginx 反向X_X

1. 创建 Nginx 配置文件

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

内容示例:

server {
    listen 80;
    server_name your-domain.com;  # 或服务器IP

    location / {
        proxy_pass http://127.0.0.1:3000;  # 转发到Node.js服务
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        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;
        proxy_cache_bypass $http_upgrade;
    }
}

2. 启用站点

sudo ln -s /etc/nginx/sites-available/weapp /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置
sudo systemctl reload nginx

🔐 五、申请 SSL 证书(启用 HTTPS)

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

1. 使用腾讯云免费证书

  • 进入 腾讯云 SSL 证书管理
  • 申请免费 DV 证书(支持单域名)
  • 下载 Nginx 版证书

2. 上传证书到服务器

# 上传证书文件到 /etc/nginx/ssl/weapp/
sudo mkdir /etc/nginx/ssl/weapp
# 上传 .crt 和 .key 文件

3. 修改 Nginx 配置支持 HTTPS

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /etc/nginx/ssl/weapp/your_cert.crt;
    ssl_certificate_key /etc/nginx/ssl/weapp/your_key.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://127.0.0.1:3000;
        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;
    }
}

# HTTP 跳转 HTTPS
server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

重载 Nginx:

sudo nginx -t
sudo systemctl reload nginx

📱 六、小程序前端配置

1. 在 app.js 中设置请求域名

wx.request({
  url: 'https://your-domain.com/api/login',
  // ...
})

2. 在微信公众平台配置服务器域名

  • 登录 微信公众平台
  • 进入「开发」→「开发管理」→「服务器域名」
  • 添加你的 HTTPS 域名到 request 合法域名
    • 如:https://your-domain.com

✅ 注意:不能使用 IP 地址,必须是备案域名 + HTTPS


📌 七、域名备案(我国大陆服务器必需)

  • 如果服务器在我国大陆,必须对域名进行 ICP备案
  • 腾讯云提供备案系统:https://beian.cloud.tencent.com/
  • 备案通过后才能X_X访问

❗ 未备案域名无法访问(即使配置了 HTTPS)


✅ 八、测试与上线

  1. 浏览器访问 https://your-domain.com 测试接口
  2. 小程序开发者工具中调试网络请求
  3. 确保无报错,提交小程序审核

🧰 常见问题

问题 解决方案
请求失败 ERR_CERT_AUTHORITY_INVALID 检查 SSL 证书是否正确安装
域名未备案 无法访问,必须备案
接口返回 502 检查 Node.js 是否运行、端口是否正确
微信提示域名不合法 检查公众平台是否添加了 request 域名

📚 推荐资源

  • 腾讯云轻量应用服务器:https://cloud.tencent.com/product/lighthouse
  • 微信小程序官方文档:https://developers.weixin.qq.com/miniprogram/dev/framework/
  • Express 框架:https://expressjs.com/

如果你使用的是 云开发(CloudBase),腾讯云也提供「云开发环境」,无需自己搭服务器,更适合新手。

👉 云开发教程:https://cloud.tencent.com/product/tcb


需要我根据你的具体技术栈(如 Python、Java、PHP、云开发等)提供更详细的部署方案吗?欢迎告诉我你的后端语言!

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