跳到主要内容
ssl证书按装

宝塔面板 SSL/HTTPS 证书安装全流程:Linux 与 Windows 环境搭建、Nginx/Apache/IIS 配置与排错

宝塔面板 SSL/HTTPS 证书安装全流程:Linux 与 Windows 环境搭建、Nginx/Apache/IIS 配置与排错 — 宝塔面板 SSL/HTTPS 证书安装全流程:Linux 与 Windows 环境搭建、Nginx/Apache/IIS 配置与排错

一、问题背景与根因:证书装上了,浏览器还是“不安全”

在宝塔面板(Linux 版或 Windows 版)里,最常见的 HTTPS 故障在于“装了但没装对”,并非“没装证书”。典型现象包括:Chrome 地址栏显示“不安全”、小程序或 APP 请求报 SSL handshake failed、支付回调验签失败、iOS 端正常而 Android 端报错。这类问题九成集中在六个根因上:

  • 证书链不完整:只部署了站点证书(server certificate),漏掉中间证书(intermediate CA)。桌面浏览器会自动补链,但 Java、OkHttp、curl、微信小程序不会。
  • 域名不匹配:证书 SAN 里只有 example.com,却用 www.example.com 访问。
  • 证书过期:Let’s Encrypt 有效期固定 90 天,自动续签任务失败即过期;公有 CA 证书自 2020 年 9 月起最长有效期被限制为 398 天。
  • 协议与套件过旧:仍开启 TLS 1.0/1.1 或使用 RC4、3DES 套件,被现代浏览器直接拒绝。
  • 混合内容:页面里仍有 http:// 的图片、JS、CSS 引用。
  • 链路层问题:云安全组未放行 443、CDN 回源走 80、Nginx 与 IIS 同时抢占 443 端口。

先做一次定位,再动手改配置:

curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

第一条返回 HTTP/1.1 200 说明 443 通了;第二条若 issuer 是 Let’s Encrypt 的 R3/E1 或 DigiCert Global G2,再看 notAfter 是否已过期。如果浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,几乎可以断定是链不完整。把“现象—根因”先对上号,后面每一节的配置才有的放矢。

二、环境准备:Linux 与 Windows 宝塔安装、443 放行与端口占用检查

Linux 侧建议 CentOS 7.9+ / Ubuntu 20.04+ / Debian 11+,内存 ≥1 GB(编译 Nginx 时建议 2 GB)。官方安装脚本:

# 通用安装脚本(推荐)
curl -sSO https://download.bt.cn/install/install_panel.sh && bash install_panel.sh
# 或 LTS 长期支持版
wget -O install.sh https://download.bt.cn/install/install_lts.sh && bash install.sh ed8484bec

安装完成会输出面板地址、用户名、密码,务必保存。放行端口(面板默认 8888,站点 80/443):

# firewalld
firewall-cmd --permanent --add-port=8888/tcp
firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload
# ufw
ufw allow 8888/tcp && ufw allow 80,443/tcp

云服务器还必须到控制台安全组放行 443,否则本机 curl 通、外网不通。检查端口占用:

ss -lntp | grep -E ':80|:443'
# Windows
netstat -ano | findstr ":443"
tasklist | findstr <PID>

Windows 版宝塔(bt-windows)安装后自带 IIS 与 PHP/MySQL 环境,不要再装 Apache/Nginx 同时启动,否则 80/443 冲突,浏览器会报 SSL_ERROR_RX_RECORD_TOO_LONG。Windows 下建议关闭系统自带 IIS,把站点统一托管到宝塔的 IIS 实例。装完软件后进入“网站 → 添加站点”,绑定域名与根目录,再装 PHP(推荐 7.4/8.1)与数据库,最后一步才是 SSL——顺序颠倒会导致证书申请时文件验证失败。面板自身的 8888 端口也建议在“面板设置”里开启 SSL,避免后台密码明文传输。

三、申请证书:Let’s Encrypt 90 天证书与商业证书 CSR 生成

宝塔“网站 → 设置 → SSL → Let’s Encrypt”可一键签发,免费、有效期 90 天、支持自动续签。两条硬规则要先记住:

  • 文件验证(HTTP-01)要求 http://example.com/.well-known/acme-challenge/ 可从公网访问,80 端口必须放行;若站点已开启全站 301 跳转,需临时关闭,否则验证请求被重定向会失败。
  • 泛域名 *.example.com 只能用 DNS-01 验证,需在域名商处添加 TXT 记录;宝塔支持阿里云、腾讯云、Cloudflare 的 API 自动添加。

商业证书(DV/OV)需通过 CSR 申请,OpenSSL 命令:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

若服务端支持 ECC,用 P-256 证书握手更快、证书体积更小:

openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj "/CN=example.com"

拿到证书后先本地校验私钥与证书是否配对,避免上线后 443 直接起不来:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5
# 两个 md5 必须完全一致

关于有效期:公有 CA 签发的 TLS 证书最长 398 天,所谓“买三年送两年”实际是多张 398 天证书分批签发,到期必须逐张替换;Let’s Encrypt 固定 90 天,靠自动化续签而不是靠长有效期。

四、配置示例:宝塔下 Nginx / Apache / IIS 三套部署写法

宝塔把证书统一放在 /www/server/panel/vhost/cert/<站点名>/,目录内通常有 fullchain.pem(站点证书 + 中间证书)、privkey.pem(私钥)、chain.pem(中间证书)。在面板“SSL → 其他证书”粘贴时,顺序必须是站点证书在前、中间证书在后。

Nginx(宝塔 → 网站 → 配置文件):

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate     /www/server/panel/vhost/cert/example.com/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/chain.pem;
    add_header Strict-Transport-Security "max-age=31536000" always;
}

Apache(宝塔 → 网站 → 配置文件):

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile    "/www/server/panel/vhost/cert/example.com/fullchain.pem"
    SSLCertificateKeyFile "/www/server/panel/vhost/cert/example.com/privkey.pem"
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
</VirtualHost>

Windows/IIS(宝塔 Windows 版即 IIS)。IIS 只认 PFX,需先合并:

openssl pkcs12 -export -out example.com.pfx -inkey privkey.pem -in fullchain.pem -passout pass:123456
# PowerShell 导入并绑定
Import-PfxCertificate -FilePath C:sslexample.com.pfx -CertStoreLocation Cert:LocalMachineMy -Password (ConvertTo-SecureString "123456" -AsPlainText -Force)
New-WebBinding -Name "example.com" -Protocol https -Port 443 -HostHeader "example.com" -SslFlags 1

改完必须校验再重载,绝不要直接 reload:

nginx -t && nginx -s reload
httpd -t && systemctl reload httpd
iisreset /restart

五、强制 HTTPS 跳转与 TLS 加固配置

宝塔面板的“强制 HTTPS”开关本质是往 80 端口 server 块写 301,手写更可控:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

Apache 用 mod_rewrite:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

IIS 在站点根目录 web.config 中配置:

<system.webServer><rewrite><rules>
  <rule name="ForceHTTPS" stopProcessing="true">
    <match url="(.*)" />
    <conditions><add input="{HTTPS}" pattern="off" /></conditions>
    <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
  </rule>
</rules></rewrite></system.webServer>

加固要点:① 关闭 TLS 1.0/1.1,只留 TLS 1.2/1.3;② 禁用 RC4、3DES、MD5;③ 开启 OCSP Stapling,减少握手时延;④ HSTS 首次上线先用短周期 max-age=300 验证,确认全站 HTTPS 无遗漏后再改 31536000 并考虑 includeSubDomains、preload——HSTS 一旦下发,回退成本很高;⑤ 多站点共用 IP 必须依赖 SNI,老客户端会拿到默认站点证书。

检查协议与套件是否真的关掉了:

nmap --script ssl-enum-ciphers -p 443 example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 期望输出 handshake failure / no protocols available

混合内容可用 CSP 兜底:在 Nginx 加 add_header Content-Security-Policy "upgrade-insecure-requests" always;,但这只是浏览器侧升级请求,源码里硬编码的 http:// 仍应逐个改成相对协议或 https。

六、对比表格:证书类型、部署路径与 Linux/Windows 差异

选型先看两张表,避免“该自动续签的买了三年、该用泛域名的申请了单域名”。

对比项 Let’s Encrypt 商业 DV 商业 OV/EV
有效期 90 天 最长 398 天 最长 398 天
验证方式 HTTP-01 / DNS-01 DNS 或文件验证 企业实名 + 电话核验
泛域名 支持(须 DNS-01) 支持(通常加价) 支持
续签 面板一键 + 自动任务 手动或 ACME 客户端 手动
浏览器信任 全平台 全平台 全平台
适用场景 个人站、测试、中小站 中小商业站 金融、政务、电商
对比项 Linux 宝塔 Windows 宝塔(IIS)
Web 服务器 Nginx / Apache IIS 10
证书格式 PEM(fullchain + privkey) PFX(PKCS#12)
存放位置 /www/server/panel/vhost/cert/域名/ 证书存储 LocalMachineMy
配置位置 站点配置文件 网站绑定 + web.config
重载命令 nginx -t && nginx -s reload iisreset /restart
强制跳转 return 301 URL Rewrite 模块
HTTP/2 默认支持 需 Server 2016+ 且绑定 SNI

从表中可以看出两个易错点:一是 Windows 侧必须先做格式转换,直接把 pem 粘进 IIS 一定失败;二是 IIS 的 HTTP/2 依赖 SNI 绑定,若使用 -SslFlags 0 绑定则只能跑 HTTP/1.1。Linux 侧则要注意 Apache 的 SSLCertificateChainFile 在 2.4.8 之后已并入 SSLCertificateFile,老教程里的写法会导致中间证书不生效。

七、常见错误排查:从真实报错到修复命令

以下报错均来自宝塔站点实际日志与浏览器控制台,按出现频率排序。

1) 浏览器 NET::ERR_CERT_AUTHORITY_INVALID,curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate
根因:缺中间证书。修复:把中间证书拼到站点证书后面,顺序不能反。

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem

2) nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
根因:文件是 DER 二进制、含 BOM 或中文注释、或把 PFX 直接改名成 pem。转换:

openssl x509 -inform DER -in cert.crt -out cert.pem
sed -i '1s/^xEFxBBxBF//' cert.pem

3) nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
根因:证书与私钥不是一对(常见于换证书只换了 crt)。用第三节的 modulus md5 比对,不一致就重签 CSR。

4) 浏览器 SSL_ERROR_RX_RECORD_TOO_LONG 或 ERR_SSL_PROTOCOL_ERROR
根因:443 端口上跑的是明文 HTTP,或 CDN 回源协议配成 HTTP 却填了 443。检查 ss -lntp | grep :443,并确认站点配置里写的是 listen 443 ssl;——漏写 ssl 关键字是高频错误。

5) ERR_CERT_COMMON_NAME_INVALID
根因:SAN 缺域名。重新签发时把 example.com、www.example.com、m.example.com 全部写进 SAN,不要依赖 CN。

6) 宝塔申请 Let’s Encrypt 报 该帐户1小时内失败的订单次数超过5次
根因:触发 ACME 速率限制(每域名每周 5 次重复证书)。等 1 小时或改用 DNS-01 验证,不要反复点“申请”。

7) 控制台 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...'
根因:源码或数据库里硬编码 http 资源。用 grep -rn "http://example.com" /www/wwwroot/example.com 批量替换,或在数据库执行 UPDATE 替换站点域名。

8) IIS 绑定报 0x80070005 拒绝访问
根因:PFX 导入到“当前用户”而非“本地计算机”,或私钥权限不足。用 certlm.msc 导入到“个人”存储,并在证书 → 所有任务 → 管理私钥中授予 IIS_IUSRS 读取权限。

八、效果验证:命令行 + 在线评级双确认

部署完不要只看浏览器绿锁,绿锁只代表证书链能被系统信任,不代表配置正确。

# 1. 证书主体、签发者、有效期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 2. 证书链完整性(应看到 s: 站点证书 / i: 中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "s:|i:"

# 3. 协议协商
curl -sIv https://example.com 2>&1 | grep -E "SSL connection|TLSv"

# 4. HTTP/2 是否生效
curl -sI --http2 https://example.com | head -n 1

# 5. 301 跳转是否生效
curl -sI http://example.com | grep -Ei "HTTP/|location"

期望结果:第 1 条 notAfter 距今大于 30 天;第 2 条至少返回两段证书;第 3 条输出 SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384;第 4 条首行为 HTTP/2 200;第 5 条返回 301 且 location: https://example.com/。

在线工具用 SSL Labs 与 MySSL,目标 A/A+:A 要求 TLS 1.2 起步、无已知漏洞;A+ 需 HSTS 且 max-age ≥ 15552000。若评 B,多半是开了 TLS 1.0/1.1 或 RC4;若评 C 并提示 “Certificate chain incomplete”,回到第七节第 1 条。最后确认自动续签真的会跑:

crontab -l | grep -i ssl
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -enddate

建议再加一个每日巡检脚本,剩余天数小于 15 天时告警,避免 90 天证书静默过期导致整站不可用。

常见问题

有效期 90 天。宝塔会在计划任务中自动创建续签任务,通常在到期前 30 天触发,前提是 80 端口可访问、域名解析未变。若站点已强制 HTTPS,需确认验证路径未被 301 拦截,否则续签失败,建议每周用 openssl 检查剩余天数。


多为证书链不完整。移动端 SDK 不会自动补链,必须把站点证书与中间证书按顺序拼成 fullchain.pem 一起部署。可用 openssl s_client -showcerts 查看是否返回多张证书,再用 SSL Labs 确认链完整。


不能。IIS 只识别 PKCS#12 的 PFX。用 openssl pkcs12 -export 把 fullchain.pem 与 privkey.pem 合并成 pfx,导入“本地计算机 → 个人”证书存储,再在站点绑定中添加 HTTPS 绑定并勾选需要服务器名称指示(SNI)。


不会,前提是启用 SNI。Nginx 需在每个 443 server 块写 server_name 与独立证书;Apache 默认已开启 SNI 支持。只有极老客户端(XP、Java 6)不支持 SNI,会回落到默认站点证书,从而报域名不匹配。


常见于 CDN 回源也走 443 且源站再次 301,形成循环;或反向代理未传 X-Forwarded-Proto,程序判断仍是 HTTP 又跳转。处理:CDN 回源改为 HTTPS,Nginx 加 proxy_set_header X-Forwarded-Proto $scheme,并清理重复跳转规则。


公有 CA 签发的 TLS 证书自 2020 年 9 月起最长 398 天,Apple 与 Chrome 会拒绝超期证书。所谓“买三年”实为多张 398 天证书分批签发,需按期替换;Let’s Encrypt 则固定 90 天,靠自动化续签。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。