在腾讯云服务器上配置小程序的 HTTPS 接口,是确保小程序能正常调用后端服务的关键步骤。以下是详细的操作流程:
一、准备工作
-
拥有腾讯云服务器(CVM)
- 确保已购买并配置好腾讯云 CVM 实例(如 CentOS、Ubuntu 等系统)。
- 已部署你的后端服务(如 Node.js、PHP、Java、Python 等)。
-
拥有备案过的域名
- 小程序要求所有接口必须使用 HTTPS,且域名需已完成 ICP 备案。
- 域名建议使用一级域名或二级域名,如
api.yourdomain.com。
-
申请 SSL 证书
- 腾讯云提供免费的 SSL 证书(由 TrustAsia 提供,有效期1年)。
- 登录 腾讯云 SSL 证书管理控制台。
二、申请并下载 SSL 证书
- 进入 SSL 证书控制台 → 点击【申请证书】
- 选择「免费版 DV SSL」→ 填写域名(如
api.yourdomain.com) - 验证方式选择「DNS 验证」或「文件验证」,完成域名所有权验证
- 审核通过后,点击【下载】证书
- 选择对应服务器类型(如 Nginx、Apache、Tomcat 等),下载证书包
常见目录结构:
your_domain/ ├── cert.pem (公钥) ├── private.key (私钥)
三、上传证书到服务器
将证书文件上传到服务器某个目录,例如:
/home/ubuntu/cert/api.yourdomain.com/
可以使用 scp 或 SFTP 工具上传。
四、配置 Web 服务器(以 Nginx 为例)
- 安装 Nginx(若未安装)
# Ubuntu/Debian
sudo apt update && sudo apt install nginx -y
# CentOS/RHEL
sudo yum install nginx -y
- 创建 Nginx 配置文件
编辑配置文件(如 /etc/nginx/sites-available/api.yourdomain.com):
server {
listen 443 ssl;
server_name api.yourdomain.com;
# SSL 证书路径(根据实际路径修改)
ssl_certificate /home/ubuntu/cert/api.yourdomain.com/cert.pem;
ssl_certificate_key /home/ubuntu/cert/api.yourdomain.com/private.key;
# 推荐的 SSL 安全配置
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers off;
# 后端服务X_X(假设运行在 3000 端口)
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 api.yourdomain.com;
return 301 https://$server_name$request_uri;
}
- 启用站点
sudo ln -s /etc/nginx/sites-available/api.yourdomain.com /etc/nginx/sites-enabled/
- 测试配置并重启 Nginx
sudo nginx -t # 测试配置是否正确
sudo systemctl reload nginx
五、开放防火墙端口
确保安全组允许 443(HTTPS)和 80(HTTP)端口:
- 登录腾讯云控制台 → 进入「云服务器 CVM」→ 找到实例
- 点击「安全组」→ 编辑规则,添加:
- 类型:HTTPS,端口:443,源:0.0.0.0/0
- 类型:HTTP,端口:80,源:0.0.0.0/0(可选)
六、绑定域名并解析 DNS
- 登录腾讯云「域名控制台」
- 找到你的域名,添加 DNS 解析记录:
- 记录类型:A
- 主机记录:
api(或@) - 记录值:你的 CVM 公网 IP
- TTL:默认即可
等待 DNS 生效(通常几分钟到几小时)。
七、测试 HTTPS 接口
在浏览器访问:
https://api.yourdomain.com
应能看到你的服务正常响应(无证书错误)。
你也可以使用 curl 测试:
curl -I https://api.yourdomain.com
八、在小程序中配置合法域名
- 登录 微信公众平台
- 进入「开发」→「开发管理」→「开发设置」
- 在「服务器域名」中,将
https://api.yourdomain.com添加到 request 合法域名
注意:
- 必须使用 HTTPS
- 域名必须备案
- 不支持 IP 地址或 localhost
九、后续维护建议
- 证书续期:免费证书有效期为1年,到期前在腾讯云控制台重新申请并更新。
- 自动续期:可使用
Certbot+ Let’s Encrypt 实现自动续签(推荐长期项目)。 - 监控服务状态:使用云监控或第三方工具确保服务可用。
✅ 完成以上步骤后,你的小程序就可以通过 HTTPS 正常调用后端接口了。
如有具体技术栈(如 Express、Django、Spring Boot 等),可进一步提供配置示例。
PHPWP博客