Golang配置HTTPS与Let'sEncrypt证书教程

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang配置HTTPS与Let's Encrypt自动证书方案》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

配置 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 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 验证方式，这就要求：

• 你的服务器能从外网访问
• 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 支持。

基本上就这些。只要一开始把基础条件准备好，后续维护几乎可以完全交给系统自动完成。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~