跳到主要内容
HTTPS安装配置

SSL 证书安装配置全流程:申请、Nginx/IIS/Tomcat 部署与 iOS ATS/小程序兼容

SSL 证书安装配置全流程:申请、Nginx/IIS/Tomcat 部署与 iOS ATS/小程序兼容 — SSL 证书安装配置全流程:申请、Nginx/IIS/Tomcat 部署与 iOS ATS/小程序兼容

问题背景与根因:HTTP 站点为什么必须升级 HTTPS

HTTP 明文传输没有身份校验,链路上任何代理、路由器、运营商节点都能插入广告、跳转页面或劫持域名。部署 SSL/TLS 后,浏览器与服务器之间建立加密通道,并通过证书链验证服务器身份,能显著降低域名劫持、页面强插和内容篡改风险。但要注意,地区级劫持、网吧代理劫持并不总能被 HTTPS 完全防御,仍需配合 HSTS、DNSSEC 和 CDN 安全策略。

业务侧更直接的原因是平台强制要求。iOS 的 ATS(App Transport Security)默认要求 App 的网络请求使用 HTTPS,且 TLS 版本、证书签名算法和密钥强度要达标;微信小程序要求请求域名必须配置为 HTTPS 合法域名,TLS 版本不低于 1.2,证书链完整且不能使用自签名证书。Chrome、Edge、Safari 等浏览器对 HTTP 页面标记“不安全”,EV 证书也不再显示绿色地址栏,所谓“小绿锁”已不是判断标准,核心是证书有效、域名匹配、链完整、无混合内容。

证书有效期规则也已变化:公开信任的 SSL/TLS 证书单张最长有效期不得超过 398 天,Let’s Encrypt 免费证书有效期为 90 天,必须自动化续期。很多旧文章仍写“证书一年或两年”,按现在规则会直接导致过期事故。根因通常不是“证书没装”,而是证书链缺失、SAN 不含实际域名、服务器仍启用 TLS 1.0/1.1、页面引用 http:// 的 js/css/img 造成混合内容,或者 IIS6、旧版 OpenSSL 等环境不支持 SNI/TLS 1.2。

上线前环境检查与域名准备

先确认 HTTP 能正常访问,再检查服务器软件和加密库版本。以下命令可直接执行:

openssl version -a
nginx -V 2>&1 | grep ssl
httpd -v
java -version
keytool -list -keystore /opt/tomcat/conf/keystore.jks
ss -lntp | grep -E ':80|:443'
dig +short A example.com
dig +short A www.example.com
curl -I http://example.com
date -u

OpenSSL 低于 1.0.1 不支持 TLS 1.2,无法满足 ATS 和小程序要求;建议使用 OpenSSL 1.1.1 或 3.x,以支持 TLS 1.3。Nginx 需编译 ngx_http_ssl_module,Apache 需加载 mod_ssl。IIS6/Windows Server 2003 不支持 SNI,默认也不支持 TLS 1.2,不建议继续用于需要 ATS 的业务。检查 80 和 443 端口未被占用,云安全组和防火墙已放行。域名解析必须指向当前服务器,HTTP-01 验证依赖 80 端口;使用 CDN 或虚拟主机时,先确认提供商支持自定义证书和 TLS 1.2。

证书私钥建议 2048 位 RSA 或 ECC P-256。生成 CSR 时 SAN 必须覆盖所有实际访问域名,例如 example.com、www.example.com、m.example.com。通配符证书 *.example.com 不覆盖根域 example.com,需要把根域加入 SAN 或单独签发。服务器时间必须准确,时间偏差会导致证书被判定未生效或已过期。准备一个可用的邮箱用于证书签发和到期通知,并把私钥权限设为 600。

证书申请与 CSR/私钥生成实操

商业证书和免费证书流程不同,但核心材料都是私钥、CSR 和域名验证。用 OpenSSL 1.1.1+ 生成私钥和 CSR:

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

把 CSR 提交给 CA,完成 DNS TXT 或 HTTP 文件验证。Let’s Encrypt 可用 certbot 自动化:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com --agree-tos --no-eff-email
certbot renew --dry-run

签发后通常得到 cert.pem、chain.pem、fullchain.pem、privkey.pem。Nginx 使用 fullchain.pem 和私钥;Apache 可分别配置 SSLCertificateFile 与 SSLCertificateChainFile;IIS/Tomcat 需要合并为 PFX/P12。合并命令:

cat cert.pem chain.pem > fullchain.pem
openssl pkcs12 -export -out example.pfx -inkey example.com.key -in fullchain.pem
openssl x509 -in fullchain.pem -noout -dates -subject -issuer -ext subjectAltName

证书链一般只放服务器证书和中间证书,不要放根证书。公开证书最长有效期 398 天,Let’s Encrypt 为 90 天,务必配置自动续期并在续期后 reload Nginx/Apache。不要把私钥提交到代码仓库,不要使用来路不明的“合并证书”。如果 CA 提供的是 CER/DER 格式,用 openssl x509 -inform DER -in cert.cer -out cert.pem 转换。

Nginx 与 Apache 配置示例

Nginx 推荐把 80 端口跳转到 443,并在 443 server 块中配置完整证书链、TLS 1.2/1.3、HSTS 和 OCSP stapling。示例:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    root /var/www/html;
    index index.html;
}

执行 nginx -t 检查语法,再 systemctl reload nginx。HSTS 第一次建议 max-age=300,确认所有子域都支持 HTTPS 后再加 includeSubDomains 和 preload。OCSP stapling 需要 chain.pem 和可用的 DNS resolver,否则可先关闭。Apache 示例:

Listen 443
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/cert.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/chain.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security 'max-age=31536000'

执行 apachectl configtest 后 systemctl reload httpd。常见问题是只配了 cert.pem 没配 chain.pem,浏览器或 curl 报 unable to get local issuer certificate。另一个问题是私钥与证书不匹配,可用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5 比对。

IIS、Tomcat 与移动端 ATS/小程序配置

IIS 先在“服务器证书”中导入 PFX,绑定 443 时勾选 SNI(IIS8/Windows Server 2012 及以上),同一 IP 可承载多张证书。IIS6/Windows Server 2003 不支持 SNI,每个独立 IP 只能绑定一张证书,通常只能用通配符或多域名证书。导入后可执行 certutil -store My 查看证书。Tomcat 需要 JKS 或 PKCS12 keystore:

keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12 -destkeystore /opt/tomcat/conf/keystore.jks -deststoretype JKS
keytool -list -keystore /opt/tomcat/conf/keystore.jks

server.xml 的 Connector 示例(XML 属性用单引号):

<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
  SSLEnabled='true' scheme='https' secure='true'
  keystoreFile='/opt/tomcat/conf/keystore.jks' keystorePass='changeit'
  sslProtocol='TLS' />

Tomcat 8.5 以前通常一个 Connector 绑定一张证书,8.5 以后配合 JSSE 支持 SNI 多证书。iOS ATS 要求 TLS 1.2 及以上、SHA-256 签名、RSA 至少 2048 位或 ECC 256 位,并支持前向保密套件。Info.plist 中不要长期使用 NSAllowsArbitraryLoads=true 绕过 ATS,否则审核风险高。微信小程序要求 request 合法域名使用 HTTPS,证书链完整,TLS 1.2+,不能使用自签名证书或 IP 地址。开发者工具中“不校验合法域名”只用于调试,真机必须使用已备案且证书有效的域名。

多系统证书部署能力对比表

不同平台对 SNI、多证书和 TLS 版本的支持差异很大,选型时先看下表:

平台/版本 SNI 多证书 单 IP 多证书 TLS 1.2/1.3 ATS/小程序 备注
IIS6 / Windows Server 2003 不支持 不支持 默认不支持 TLS 1.2 不满足 每个 IP 一张证书,建议升级
IIS7/7.5 / Windows Server 2008 R2 不支持 不支持 需补丁和注册表启用 需额外配置 用通配符或多域名证书
IIS8+ / Windows Server 2012+ 支持 支持 支持 TLS 1.2,1.3 需较新系统 可满足 绑定 443 勾选 SNI
Nginx 常用版本 支持 支持 支持 TLS 1.2/1.3 可满足 需完整 fullchain
Apache 2.4 常用版本 支持 支持 支持 TLS 1.2/1.3 可满足 需 mod_ssl 和链文件
Tomcat 8.5 以前 通常不支持 通常一张 取决于 JDK 需 JDK 8+ 配置 一个 Connector 一张证书
Tomcat 8.5+ 支持 支持 取决于 JDK 可满足 建议 JDK 11+

虚拟主机和 CDN 能否安装证书,取决于服务商是否开放 SSL 模块和自定义证书入口,不能只看“支持 HTTPS”宣传。若必须兼容老旧 IIS6,优先使用通配符证书或多域名证书减少 IP 绑定。小程序和 App 上线前,应把证书链、TLS 版本、域名备案和 443 端口一起检查,而不是只验证浏览器能打开。

常见错误排查(含真实报错)

1. curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链不完整。Nginx 改用 fullchain.pem,Apache 配置 SSLCertificateChainFile,Tomcat 重新导入包含中间证书的 PFX。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 检查返回链。

2. NET::ERR_CERT_COMMON_NAME_INVALID:访问域名不在证书 SAN 中。重新签发时把根域、www、m 等全部写入 SAN,通配符不覆盖根域。用 openssl x509 -in fullchain.pem -noout -ext subjectAltName 核对。

3. nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed:路径错误或权限不足。检查文件是否存在,Nginx worker 用户是否有读权限,SELinux 是否拦截。执行 nginx -t 前先 ls -l /etc/nginx/ssl。

4. nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line):把 PFX/DER 当 PEM 用。用 openssl pkcs12 -in example.pfx -nodes -out fullchain.pem 或 openssl x509 -inform DER 转换。

5. Tomcat java.io.IOException: Invalid keystore format:keystoreType 与文件格式不匹配。JKS 配 keystoreType=’JKS’,PKCS12 配 keystoreType=’PKCS12’,不要混用。用 keytool -list 验证。

6. Apache AH02572: Failed to configure at least one certificate and key for example.com:443:证书或私钥路径错误、权限不足、证书与私钥不匹配。用 modulus 比对,确认 SSLCertificateFile 与 SSLCertificateKeyFile 指向同一套材料。

7. 小程序 request:fail ssl handshake error:TLS 版本过低、证书链不完整、证书域名不匹配或使用自签名。用 openssl s_client -tls1_2 验证,确保服务器开启 TLS 1.2,证书由公开 CA 签发。

8. Mixed Content: The page at ‘https://example.com’ was loaded over HTTPS, but requested an insecure resource ‘http://example.com/a.js’. This request has been blocked.:页面引用了 http 资源。把 js/css/img 改为 https 或相对协议,检查数据库和模板中的硬编码 http://。iOS ATS 报 App Transport Security has blocked a cleartext HTTP resource load 同理,必须改 HTTPS 或配置精确例外。

效果验证与上线检查

配置完成后不要只看浏览器地址栏。执行以下验证:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
curl -I https://example.com
curl -I http://example.com
testssl.sh --severity HIGH https://example.com
openssl x509 -in fullchain.pem -noout -dates -issuer -subject

预期结果:证书链完整,issuer 为公开 CA,subject/SAN 包含实际域名,notAfter 未过期;HTTP 返回 301 到 HTTPS;TLS 1.0/1.1 握手失败,TLS 1.2/1.3 成功;SSL Labs 评级达到 A 或 A+。Chrome DevTools 的 Security 面板应显示证书有效且无混合内容。小程序开发者工具切换到真机调试,确认 request 合法域名已配置且证书链完整。iOS App 用真机访问接口,确认 ATS 未拦截。

最后设置证书到期监控,Let’s Encrypt 用 certbot renew –dry-run 验证自动续期,商业证书在到期前 30 天续签。HSTS 一旦开启 includeSubDomains,所有子域都必须支持 HTTPS,否则会把自己锁死。上线后定期扫描混合内容和 TLS 配置,避免服务器升级或模板改动引入 http:// 资源。

常见问题

SSL 证书安装配置需要多长时间?

常规 Nginx/Apache 环境 10-30 分钟;IIS、Tomcat 或需要转换证书格式时约 30-60 分钟。远程操作取决于网络和权限,建议提前准备 TeamViewer/向日葵和服务器管理员权限。

配置完成的验收标准是什么?

https://域名 可正常访问只是最低标准。还应满足证书链完整、域名匹配、TLS 1.2+、HTTP 自动跳转 HTTPS、无混合内容,并通过 openssl s_client 和 SSL Labs 检查。

证书最长有效期是多久?

公开信任的 SSL/TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天。必须配置自动续期和到期监控,不能按旧文章的一年或两年有效期操作。

支持苹果 ATS 和微信小程序吗?

满足条件即可:公开 CA 签发、证书链完整、域名匹配、TLS 1.2 及以上、SHA-256、RSA 2048 位以上。IIS6/Windows Server 2003 和 OpenSSL 低于 1.0.1 的环境通常不满足。

一台服务器能装多少张证书?

Nginx/Apache 常用版本不限数量;IIS8+ 支持 SNI 单 IP 多证书;IIS6/7/7.5 通常每个 IP 一张;Tomcat 8.5+ 支持 SNI 多证书,更早版本通常一个 Connector 一张。

虚拟主机或 CDN 能安装证书吗?

取决于服务商是否开放 SSL 模块和自定义证书上传。需要确认支持完整证书链、TLS 1.2+、SNI 和 443 端口,否则只能更换主机或使用其托管证书。

内容审核

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