tls加密客户端Hello握手

Go 的 crypto/tls 客户端会在握手开始时发送 ClientHello，告诉服务端自己支持的 TLS 版本、密码套件、密钥交换组、签名算法以及可选的 SNI、ALPN 等扩展。它不是“把应用数据加密后直接发出去”，而是先协商出双方都能使用的安全参数，再建立后续记录层的加密。

官方地址：https://pkg.go.dev/crypto/tls

实际开发中不需要手工拼 ClientHello。用 tls.Config 描述客户端边界，调用 Dialer.DialContext 或显式 HandshakeContext，让标准库完成消息编码、版本协商、证书校验和密钥建立。

ClientHello 先解决什么问题

在 TLS 1.3 中，ClientHello 主要携带四类协商信息：密码套件列表、supported_groups 与 key_share、可接受的签名算法，以及需要恢复会话时使用的 PSK 信息。服务端从这些选项中选择共同参数，再用 ServerHello 继续握手。

Go 内部会根据 tls.Config 生成 ClientHello；ServerName 同时参与主机名证书校验，并在客户端握手中支持虚拟主机。ClientHello 只是协商起点，不代表服务端证书已经可信，也不等于应用层请求已经发送。

客户端配置：让标准库完成加密握手

客户端最重要的配置是服务器名、最低版本和连接超时。不要为了“让握手成功”把 InsecureSkipVerify 设为 true；这会关闭默认的服务器证书校验，除非你另有完整的自定义验证链路。

package main

import (
	"context"
	"crypto/tls"
	"fmt"
	"net"
	"time"
)

func dialTLS(ctx context.Context, addr string) (*tls.Conn, error) {
	config := &tls.Config{
		// ServerName 用于 SNI，也用于校验证书中的主机名。
		ServerName: "example.com",
		// 只接受 TLS 1.2 及以上，避免回落到过旧协议。
		MinVersion: tls.VersionTLS12,
	}
	dialer := &net.Dialer{Timeout: 5 * time.Second}
	conn, err := tls.DialWithDialer(dialer, "tcp", addr, config)
	if err != nil {
		return nil, fmt.Errorf("TLS 连接失败: %w", err)
	}
	// 调用方负责关闭连接，避免底层 TCP 资源泄漏。
	return conn, nil
}

func main() {
	ctx, cancel := context.WithTimeout(context.Background(), 8*time.Second)
	defer cancel()
	// 示例只展示握手入口；真实项目应把 ctx 传给支持 DialContext 的封装。
	_ = ctx
	conn, err := dialTLS(context.Background(), "example.com:443")
	if err != nil {
		fmt.Println(err)
		return
	}
	defer conn.Close()
	fmt.Println(conn.ConnectionState().Version)
}

如果项目需要把取消信号精确传到握手阶段，应使用 tls.Dialer.DialContext，或者先建立底层连接再调用 HandshakeContext。握手成功后，可以通过 ConnectionState 查看实际协商出的版本、协议和是否恢复会话。

服务端怎样读取 ClientHello

服务端不应该自己解析网络字节。把 GetCertificate 或 GetConfigForClient 放到 tls.Config 后，标准库会把 ClientHello 转换为 ClientHelloInfo。其中 ServerName 可用于 SNI 路由，SupportedVersions、SupportedProtos 和 CipherSuites 可用于记录或选择匹配配置。

serverConfig := &tls.Config{
	Certificates: []tls.Certificate{defaultCert},
	GetConfigForClient: func(hello *tls.ClientHelloInfo) (*tls.Config, error) {
		// 只把 SNI 当作选择证书的输入，不要从 Conn 读取握手字节。
	if hello.ServerName == "api.example.com" {
		return &tls.Config{Certificates: []tls.Certificate{apiCert}}, nil
	}
	// 返回 nil 表示继续使用外层配置处理当前连接。
	return nil, nil
	},
}

ClientHelloInfo.Conn 是底层连接，但官方明确要求不要直接读写它，否则会破坏 TLS 会话。回调适合做证书或配置选择，不适合承担慢速外部请求；如果证书不匹配，应返回错误让握手终止。

握手失败时按阶段判断

超时：底层拨号超时和握手超时要分别设置，不能只依赖默认值。证书错误：先检查 ServerName 是否与证书匹配、系统根证书是否可用；不要把跳过校验当成修复。版本或算法不兼容：检查客户端的 MinVersion、服务端支持范围和证书签名算法。

TLS 1.3 还可能出现 HelloRetryRequest，表示服务端要求客户端根据新的参数重新发送 ClientHello。Go 会在握手状态机内部处理这一过程，应用层通常只需要处理最终错误；若通过 ConnectionState 记录握手结果，可关注 HelloRetryRequest 和 DidResume 等字段。

生产接入速查表

常见问题

ClientHello 能看到服务端证书吗？

不能。它是客户端发出的第一阶段协商消息，服务端证书会在后续握手消息中返回。客户端应在握手完成时检查证书验证结果。

为什么设置了 ServerName 仍然握手失败？

ServerName 只解决 SNI 和主机名校验这一部分。还要检查根证书、证书有效期、协议版本、签名算法以及对端是否要求客户端证书。

理解 ClientHello 的关键，是把它看成“能力声明和协商输入”，而不是一个需要业务代码手工加密的报文。客户端交给 tls.Config，服务端通过 ClientHelloInfo 做轻量选择，再用超时、证书和版本错误把生产边界补齐。