Go tls.Config 怎样限制最低 TLS 版本

Go 中限制最低 TLS 版本，直接设置 tls.Config.MinVersion。常见做法是使用 tls.VersionTLS12 作为最低版本；如果业务只接受 TLS 1.3，则改用 tls.VersionTLS13。官方资料：https://pkg.go.dev/crypto/tls。

不要通过手写密码套件或字符串判断来“猜”协议版本。MinVersion 负责下限，MaxVersion 负责上限；配置交给客户端或服务端使用后，再从 ConnectionState.Version 读取实际协商结果。

• 默认边界：当前 Go crypto/tls 的最低默认版本是 TLS 1.2，最高默认版本是包支持的最高版本。
• 显式设置：用 tls.VersionTLS12 或 tls.VersionTLS13 表达最低版本，不要写魔法数字。
• 结果判断：握手完成后读取 ConnectionState().Version，需要展示名称时使用 tls.VersionName。

用 MinVersion 设置最低版本

MinVersion 的含义是“连接允许使用的最低 TLS 版本”。下面的配置把 TLS 1.2 设为下限，同时保留更高版本的协商空间，适合需要兼顾兼容性和基本安全边界的客户端或服务端。

package main

import "crypto/tls"

func newTLSConfig() *tls.Config {
	return &tls.Config{
		// 明确拒绝低于 TLS 1.2 的连接，避免依赖隐含默认值。
		MinVersion: tls.VersionTLS12,
	}
}

这里没有设置 MaxVersion，表示上限继续使用包当前支持的默认最高版本。官方文档说明，MinVersion 默认最低为 TLS 1.2，MaxVersion 默认使用当前包支持的最高版本；常量 VersionTLS12 和 VersionTLS13 分别代表 TLS 1.2 与 TLS 1.3。

按兼容性选择 TLS 1.2 或 TLS 1.3

如果上下游都明确支持 TLS 1.3，可以把最低版本提高到 TLS 1.3：

config := &tls.Config{
	// 只接受 TLS 1.3 及以上版本；当前 Go 包中不会再向下协商。
	MinVersion: tls.VersionTLS13,
}

这个设置更严格，但也会排除只能使用 TLS 1.2 的旧客户端或旧服务端。生产配置应先确认对端能力、代理终止 TLS 的位置和回滚方案。若只是希望拒绝 TLS 1.0、TLS 1.1，而仍需兼容常见 TLS 1.2 对端，使用 VersionTLS12 作为下限更直接。

MinVersion、MaxVersion 和 CipherSuites 不是一回事

MinVersion 与 MaxVersion 组成协议版本范围；例如下列配置只允许 TLS 1.2：

config := &tls.Config{
	// 上下限相同，协议版本范围被收窄到 TLS 1.2。
	MinVersion: tls.VersionTLS12,
	MaxVersion: tls.VersionTLS12,
}

CipherSuites 则是 TLS 1.0–1.2 使用的密码套件列表，TLS 1.3 密码套件不能通过这个字段配置。它不替代最低版本设置，也不负责证书链和主机名校验。不要为了“固定版本”去堆一组密码套件；先用版本上下限表达协议政策，再按实际需求处理其他配置。

读取 ConnectionState 做结果判断

配置完成不等于你已经知道本次连接实际使用了哪个版本。握手完成后，可从连接状态读取 Version，并用 tls.VersionName 转成可读名称：

func negotiatedVersion(conn *tls.Conn) (string, error) {
	// 主动完成握手，让版本协商错误在这里暴露出来。
	if err := conn.Handshake(); err != nil {
		// 握手失败时不能读取一个“看起来成功”的协商结果。
		return "", err
	}

	// ConnectionState.Version 是本次连接实际使用的协议版本。
	return tls.VersionName(conn.ConnectionState().Version), nil
}

如果对端只支持低于 MinVersion 的协议，握手会失败，应该把错误作为连接失败处理，而不是降低配置后无限重试。对于 HTTP 客户端，通常把同一个 *tls.Config 放进 http.Transport；对于服务端，则交给 http.Server 的 TLS 配置或底层 TLS listener 使用，重点是保证配置在首次使用前完成。

几个容易混淆的问题

MinVersion 不设置时是不是允许 TLS 1.0？

当前 crypto/tls 文档说明默认最低版本为 TLS 1.2，TLS 1.0 是该包支持的最低版本。即使如此，安全策略仍建议在应用配置中显式写出目标下限，让代码审查和部署差异更容易发现。

只设置 MinVersion 能保证证书安全校验吗？

不能。它只约束协议版本；证书链、主机名校验和自定义验证属于其他配置与校验职责。不要用设置 TLS 版本来替代证书验证，也不要为了排查问题长期打开 InsecureSkipVerify。

为什么设置 TLS 1.3 后连接失败？

最常见原因是对端或中间终止点不支持 TLS 1.3。先确认实际握手位置和对端能力，再决定是否退回 TLS 1.2 下限；不要把失败简单归因于 Go 代码或随意关闭校验。

记住一个最小判断：用 MinVersion 写清最低协议版本，用 MaxVersion 表达上限，握手后用 ConnectionState.Version 读取事实。这样 Go 的 TLS 版本策略既明确，又不会把版本范围、密码套件和证书校验混在一起。