配置 https 在 golang web 项目中可通过 autocert 包实现自动化;1. 引入 autocert 并设置 hostwhitelist 指定允许申请证书的域名;2. 使用 dircache 设置本地缓存目录以存储证书;3. 配置 tlsconfig 并监听 443 端口;4. 确保 80 端口开放、域名解析正确以完成 let's encrypt 的 http-01 验证;5. 自动续期无需干预,证书更新由后台异步完成。

配置 HTTPS 对于现代 Web 开发来说几乎是标配,特别是在生产环境中。Go(Golang)作为一门适合构建高性能网络服务的语言,在搭建 Web 应用时也自然需要支持 HTTPS。而 Let's Encrypt 提供了免费、自动化、受信任的 SSL/TLS 证书,非常适合用于 Golang Web 项目中。

下面我们就来看看在 Golang Web 开发中,如何通过 Let's Encrypt 自动化地配置 HTTPS。

使用 autocert
包自动申请和管理证书
Go 标准库中的
golang.org/x/crypto/acme/autocert是官方推荐的 Let's Encrypt 集成方式。它封装了与 Let's Encrypt 的交互逻辑,包括自动申请证书、续期等操作。
立即学习“go语言免费学习笔记(深入)”;
使用起来非常简单,只需要几行代码就可以让你的 Go Web 程序支持 HTTPS:

package main
import (
"log"
"net/http"
"golang.org/x/crypto/acme/autocert"
)
func main() {
certManager := autocert.Manager{
Prompt: autocert.AcceptTOS,
HostPolicy: autocert.HostWhitelist("yourdomain.com", "www.yourdomain.com"),
Cache: autocert.DirCache("/var/www/.cache"),
}
server := &http.Server{
Addr: ":https",
Handler: nil, // 设置你自己的路由处理器
TLSConfig: certManager.TLSConfig(),
}
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello over HTTPS!"))
})
log.Fatal(server.ListenAndServeTLS("", ""))
}注意点:
HostWhitelist
指定允许哪些域名申请证书DirCache
是本地缓存目录,必须保证运行用户有写入权限- 启动后会自动监听 80 和 443 端口(用于验证域名所有权)
域名解析和服务器端口开放是关键前提
Let's Encrypt 在签发证书前需要验证你对域名拥有控制权。通常采用 HTTP-01 或 DNS-01 挑战方式。
如果你使用的是
autocert,默认使用 HTTP-01 验证方式,这就要求:
本书图文并茂,详细讲解了使用LAMP(PHP)脚本语言开发动态Web程序的方法,如架设WAMP平台,安装与配置开源Moodle平台,PHP程序设计技术,开发用户注册与验证模块,架设LAMP平台。 本书适合计算机及其相关专业本、专科学生作为学习LAMP(PHP)程序设计或动态Web编程的教材使用,也适合对动态Web编程感兴趣的读者自觉使用,对LAMP(PHP)程序设计人员也具有一定的参考价值。
- 你的服务器能从外网访问
- 80 端口开放(即使你只跑 HTTPS)
- 域名已正确解析到当前服务器 IP
如果不能开放 80 端口或想更灵活控制验证流程,可以考虑使用 DNS-01 验证,比如搭配 Cloudflare、Aliyun DNS 等 API 来完成自动验证。
常见问题:
- 防火墙没开 80 端口 → 验证失败
- 域名未解析或解析错误 → 验证失败
- 没同意 TOS(AcceptTOS)→ 无法申请
自动续期无需手动干预
Let's Encrypt 的证书有效期为 90 天,但
autocert会在证书即将过期时自动进行续期,完全透明且无需手动处理。
续期过程是后台异步执行的,只要你的服务保持运行,并且域名仍然指向当前服务器,就能自动更新证书。
你可以通过以下方式确认是否正常工作:
- 查看日志是否有证书更新记录
- 手动访问站点并检查证书有效期
- 使用 SSL Labs 进行检测
需要注意的是:如果你部署在多个实例上,每个实例都要独立申请证书,或者使用共享存储来统一证书缓存。
小结
整个配置 HTTPS 的过程其实不复杂,重点在于域名解析、端口开放和证书自动管理机制的设置。Golang 提供了官方支持的方案,配合 Let's Encrypt 能够实现零成本、全自动的 HTTPS 支持。
基本上就这些。只要一开始把基础条件准备好,后续维护几乎可以完全交给系统自动完成。









