Go crypto/tls.CipherSuites 怎样查看当前支持的密码套件
如果你想查看当前 Go crypto/tls 实现了哪些可用密码套件,直接调用 tls.CipherSuites()。它返回按套件 ID 排序的 []*tls.CipherSuite,并排除官方标记为存在安全问题的套件;后者可以用 tls.InsecureCipherSuites() 单独查看。
官方文档:https://pkg.go.dev/crypto/tls#CipherSuites
要注意,这个返回值是“当前实现的可用目录”,不是一次连接一定会采用的默认协商顺序。Go 官方文档明确说明,默认套件选择还可能由动态逻辑决定。因此,排查配置时应先打印目录,再结合实际的 tls.Config.CipherSuites 判断。
先用 CipherSuites 打印当前支持的套件
下面的程序把最有用的四个信息放在同一行:数值 ID、名称、可协商的 TLS 版本,以及安全标记。示例只做静态 API 读取,不发起网络连接。
package main
import (
"crypto/tls"
"fmt"
)
func main() {
// CipherSuites 返回当前实现且未被标记为不安全的套件,并按 ID 排序。
for _, suite := range tls.CipherSuites() {
fmt.Printf("0x%04X %-42s versions=", suite.ID, suite.Name)
for i, version := range suite.SupportedVersions {
// 多个版本用逗号分隔,便于复制到排查日志中。
if i > 0 {
fmt.Print(",")
}
fmt.Print(tls.VersionName(version))
}
fmt.Printf(" insecure=%t\n", suite.Insecure)
}
}

输出中的 SupportedVersions 是该套件能够参与协商的协议版本集合。例如某个套件只出现在 TLS 1.3 版本列表中,就不能把它写入只允许 TLS 1.2 的配置。版本名称用 tls.VersionName 转换,比直接打印数字更适合日志和配置审查。
CipherSuite 的字段分别表示什么
tls.CipherSuite 是一个描述对象,核心字段可以这样理解:
| 字段 | 用途 | 排查时关注什么 |
|---|---|---|
ID | 协议使用的数值标识 | 写入 tls.Config.CipherSuites 时使用它,而不是名称字符串 |
Name | 便于阅读的套件名称 | 用于日志、白名单审查和配置说明 |
SupportedVersions | 可以协商该套件的 TLS 版本 | 检查它是否与 MinVersion、MaxVersion 兼容 |
Insecure | 对象自身的安全问题标记 | CipherSuites() 返回的对象通常不在不安全目录中 |
这里有一个容易混淆的点:套件名称里出现 AES 或 CHACHA20,并不等于它能在任意 TLS 版本下使用。真正的版本边界要看 SupportedVersions,连接的最终结果还要受双方能力和配置共同影响。
不要把 CipherSuites 和 InsecureCipherSuites 混为一谈
需要审计旧配置时,可以把两个目录按 ID 做一次对照。CipherSuites() 表示当前实现且未被标记为不安全的套件,InsecureCipherSuites() 则专门返回官方认为存在安全问题的套件。大多数应用不应该主动使用第二个列表中的项目。
func printInsecureSuites() {
// 只打印官方单独列出的不安全套件,用于迁移旧配置时的排查。
for _, suite := range tls.InsecureCipherSuites() {
fmt.Printf("0x%04X %s versions=%v\n", suite.ID, suite.Name, suite.SupportedVersions)
}
}
不要用“两个列表的差集”推断默认配置,也不要因为某个套件没有出现在 CipherSuites() 中就断言它从所有 Go 版本中永久删除。标准库的实现目录会随 Go 版本和安全策略变化;文章开头的官方文档地址适合在升级后重新核对。
把目录结果转换成明确的 tls.Config 白名单
如果业务确实需要固定允许列表,建议以套件名称做可读的配置输入,再映射成 ID,并在启动时拒绝未知名称。这样既能避免把字符串直接塞进配置,也能让升级后新增或移除套件变得可见。
func suiteIDs(allowNames []string) ([]uint16, error) {
// 先建立名称到 ID 的索引,避免把名称误当成 tls.Config 的配置类型。
byName := make(map[string]uint16)
for _, suite := range tls.CipherSuites() {
byName[suite.Name] = suite.ID
}
ids := make([]uint16, 0, len(allowNames))
for _, name := range allowNames {
id, ok := byName[name]
if !ok {
// 未知名称直接报错,防止服务启动后静默使用意外配置。
return nil, fmt.Errorf("unsupported or insecure cipher suite: %s", name)
}
ids = append(ids, id)
}
return ids, nil
}
func exampleConfig() (*tls.Config, error) {
ids, err := suiteIDs([]string{
"TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
})
if err != nil {
return nil, err
}
// CipherSuites 使用数值 ID;TLS 版本仍由 MinVersion/MaxVersion 控制。
return &tls.Config{
MinVersion: tls.VersionTLS12,
CipherSuites: ids,
}, nil
}

这个示例只展示配置边界,不代表所有项目都应固定为一个套件。实际白名单至少要与证书类型、客户端覆盖范围和允许的 TLS 版本一起评估;如果没有明确的兼容需求,优先让标准库维护默认选择通常更省心。
常见误区与排查顺序
- 先看名称,忽略版本:先读取
SupportedVersions,再对照MinVersion和MaxVersion。 - 把目录当成默认顺序:
CipherSuites()按 ID 排序,不能用它推断一次握手的最终选择。 - 只改 CipherSuites:如果白名单与证书、协议版本或对端能力不兼容,握手仍可能失败。
- 遇到未知名称静默跳过:升级或配置拼写错误时应在启动阶段报错,而不是悄悄退回另一套策略。
小结
tls.CipherSuites() 适合回答“当前 Go 标准库有哪些未被标记为不安全的密码套件”,返回对象里的 ID、Name 和 SupportedVersions 分别服务于配置、阅读和兼容性判断。它不是默认协商结果;需要迁移旧配置时,再用 InsecureCipherSuites() 定位风险项,并在明确需求下把 ID 写入 tls.Config.CipherSuites。
相关问题
为什么 tls.CipherSuites 没有返回我配置里的某个套件?
先检查它是否被归入 InsecureCipherSuites(),再检查当前 Go 版本与构建模式;不要只根据名称判断套件是否仍由当前实现提供。
tls.Config.CipherSuites 应该填名称还是数字?
字段类型是 []uint16,应填套件 ID。名称可以作为外部配置,再通过 tls.CipherSuites() 映射并在启动时校验。
CipherSuites 返回顺序就是握手优先级吗?
不是。官方文档说明返回列表按 ID 排序,而默认选择还可能依赖无法由静态列表表达的动态逻辑。
Go io.MultiWriter 怎样把一份写入复制到多个 Writer
- 上一篇
- Go io.MultiWriter 怎样把一份写入复制到多个 Writer
- 下一篇
- Go io.ReadFull 怎样读取固定长度数据并区分短读
-
- Golang · Go教程 | 5分钟前 | 标准库 · 文件操作 · Go教程 · Go 文件路径 filepath.Abs EvalSymlinks os.File.Name
- Go os.File.Name 怎样获取打开文件对象的路径字符串
- 214浏览 收藏
-
- Golang · Go教程 | 10分钟前 | 标准库 · go · 性能优化 · Go io.Copy 流式写入 io.ReaderFrom bufio.Writer.ReadFrom
- Go bufio.Writer.ReadFrom 怎样高效接收 Reader 数据
- 163浏览 收藏
-
- Golang · Go教程 | 12分钟前 | 标准库 · Go教程 · FLUSH bufio.Reader bufio.Writer Go bufio.NewReadWriter io.ReadWriter
- Go bufio.NewReadWriter 怎样组合读写缓冲器
- 116浏览 收藏
-
- Golang · Go教程 | 12分钟前 | 文件操作 · Go教程 · Go os.OpenFile O_APPEND
- Go os.OpenFile 怎样组合创建、追加和权限标志
- 111浏览 收藏
-
- Golang · Go教程 | 15分钟前 | 标准库 · Go教程 · 文件系统 · 虚拟文件系统 Go io/fs.ValidPath fs.FS Go 路径校验
- Go io/fs.ValidPath 怎样判断文件名是否符合 FS 路径规则
- 261浏览 收藏
-
- Golang · Go教程 | 18分钟前 | 标准库 · 字符串处理 · Go教程 · 字符串读取 io.Reader strings.Reader Go strings.NewReader
- Go strings.NewReader 怎样把字符串包装成可读取对象
- 376浏览 收藏
-
- Golang · Go教程 | 23分钟前 |
- Go io.TeeReader 怎样把读取内容同步写入另一个 Writer
- 193浏览 收藏
-
- Golang · Go教程 | 24分钟前 | 标准库 · 错误处理 · Go教程 · io.Reader 短读 Go io.ReadFull io.ErrUnexpectedEOF 固定长度读取
- Go io.ReadFull 怎样读取固定长度数据并区分短读
- 491浏览 收藏
-
- Golang · Go教程 | 34分钟前 | 标准库 · 错误处理 · Go教程 · io.Writer 多目标写入 Go io.MultiWriter 日志旁路
- Go io.MultiWriter 怎样把一份写入复制到多个 Writer
- 270浏览 收藏
-
- Golang · Go教程 | 1小时前 | Markdown · Go教程 · Go markdown 文档注释 go/doc/comment Printer.Markdown
- Go go/doc/comment.Printer.Markdown 怎样把文档注释导出为 Markdown
- 418浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · Go 接口嵌入 go/types EmbeddedType
- Go go/types.Interface.EmbeddedType 怎样读取接口声明里直接嵌入的类型
- 121浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1099次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1094次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1264次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1204次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1050次使用
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- 快速掌握Go语言HTTP标准库的实现方法
- 2022-12-30 327浏览
-
- 使用Go实现TLS服务器和客户端的示例
- 2023-02-16 245浏览

