0

0

GolangHTTPS服务的基本配置流程

P粉602998670

P粉602998670

发布时间:2026-01-06 16:13:03

|

877人浏览过

|

来源于php中文网

原创

Go的http.ListenAndServeTLS仅支持PEM格式证书和私钥,需确保证书含服务器及中间CA(不含根CA)、私钥未加密,参数顺序为地址、证书路径、私钥路径;HTTP跳转需另启端口服务;Let’s Encrypt续期须用autocert包并配置缓存与挑战路径。

golanghttps服务的基本配置流程

证书和私钥文件必须是 PEM 格式

Go 的 http.ListenAndServeTLS 不接受 DER、PFX 或其他格式,只认 PEM 编码的证书链和 RSA/ECDSA 私钥。常见错误是直接用 openssl pkcs12 -in cert.pfx 导出却忘了加 -nodes-nocerts 分离私钥,或漏掉中间证书导致客户端验证失败。

  • 证书文件(如 cert.pem)应包含服务器证书 + 所有中间 CA 证书(按顺序拼接),但不能含根 CA
  • 私钥文件(如 key.pem)必须未加密(即无密码),否则 ListenAndServeTLS 会静默失败或 panic
  • 可用 openssl x509 -in cert.pem -text -nooutopenssl rsa -in key.pem -check -noout 验证格式有效性

ListenAndServeTLS 的参数顺序不能颠倒

http.ListenAndServeTLS 第二个参数是证书路径,第三个是私钥路径——顺序反了会报 tls: failed to find any PEM data in certificate input,因为 Go 把私钥当证书读,而私钥开头是 -----BEGIN RSA PRIVATE KEY-----,不被当作有效证书块。

http.ListenAndServeTLS(":443", "cert.pem", "key.pem", nil)
  • 第一个参数是监听地址,支持 ":443""localhost:8443";空字符串会 panic
  • 若证书或私钥路径错误,错误信息不会直接暴露在日志里,需检查 error 返回值并打印
  • 不建议在生产环境传 nil 作为 handler,至少应传 &http.ServeMux{} 明确意图

HTTP 到 HTTPS 的自动跳转需要单独启动 HTTP 服务

Go 标准库不内置重定向逻辑。常见做法是另起一个 http.Server 监听 :80,对所有请求返回 301 跳转到 https://$host$request_uri。注意 Host 头可能为空或不可信,应校验或使用配置的域名。

网人b2b电子商务门户系统
网人b2b电子商务门户系统

经过对v6.0为期一个月的调整,WRMPS v6.1 正式和大家见面,此版本在原6.0的基础上除修正旧版本所有问题外,还增加了很多人性化的功 能。 特别是在推广易功能上,做了很大提升,其包含的品牌店铺、竞价广告等服务内容将极大的提高站长的收益,而且快捷方便的服务购买支付 流程,将非常有效的推动客户在您的网站上进行消费。

下载
go func() {
    http.RedirectHandler("https://example.com"+r.RequestURI, http.StatusMovedPermanently).ServeHTTP(w, r)
}()
  • 不要在 TLS server 内部做 HTTP 重定向——那需要同时监听两个端口,必须两个 goroutine 启动
  • 若用反向代理(如 Nginx)终止 TLS,则 Go 服务只需跑 HTTP,跳转由前置组件处理
  • 本地开发时,localhost 域名无法使用 Let’s Encrypt,建议用 mkcert 生成可信自签名证书

Let’s Encrypt 自动续期需用 autocert 包而非手动替换文件

手动替换 cert.pemkey.pem 不会生效,因为 ListenAndServeTLS 只在启动时读一次文件。要用 golang.org/x/crypto/acme/autocert,它通过 ACME 协议与 Let’s Encrypt 交互,并在内存中缓存证书,自动刷新过期证书。

立即学习go语言免费学习笔记(深入)”;

  • autocert.Manager 必须设置 Cache(如 autocert.DirCache("/var/www/.cache")),否则每次重启都重新申请
  • HTTP-01 挑战要求 :80 端口可访问,且 /.well-known/acme-challenge/ 路径能被公网访问到
  • 首次申请可能触发速率限制,测试阶段应使用 Let’s Encrypt 的 staging 环境(Cache: autocert.DirCache("/tmp/cert") + HostPolicy: autocert.HostWhitelist("example.com")
证书路径错、参数顺序反、跳转没分端口、续期靠手动替换——这四点踩中任意一个,HTTPS 就跑不起来。尤其 autocert 的缓存和挑战路径,线上部署时最容易被忽略。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

PPT动态图表制作教程大全
PPT动态图表制作教程大全

本专题整合了PPT动态图表制作相关教程,阅读专题下面的文章了解更多详细内容。

13

2026.01.07

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HTML5/CSS3/JavaScript/ES6入门课程
HTML5/CSS3/JavaScript/ES6入门课程

共102课时 | 6.6万人学习

前端基础到实战(HTML5+CSS3+ES6+NPM)
前端基础到实战(HTML5+CSS3+ES6+NPM)

共162课时 | 18.6万人学习

第二十二期_前端开发
第二十二期_前端开发

共119课时 | 12.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号