> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man5/moduli.5.md).

# moduli.5

`moduli` — Diffie-Hellman 模数

## 名称

`moduli`

## 描述

**/etc/ssh/moduli** 文件包含供 sshd(8) 在 Diffie-Hellman 组交换密钥交换方法中使用的素数和生成元。

可以使用 [ssh-keygen(1)](/man/man1/ssh-keygen.1.md) 通过两步过程生成新的模数。第一步是 *候选生成*，使用 `ssh-keygen -G` 计算可能可用的数值。第二步是 *素性测试*，使用 `ssh-keygen -T` 提供高度保证，确认这些数值为素数并且在 Diffie-Hellman 操作中供 sshd(8) 使用是安全的。`moduli` 格式用作每一步的输出。

该文件由以换行符分隔的记录组成，每个模数一条记录，包含七个以空格分隔的字段。这些字段如下：

**0** 未知，未测试。

**2** “安全”素数；(p-1)/2 也是素数。

**4** Sophie Germain 素数；2p+1 也是素数。

**0x00** 未测试。

**0x01** 合数——非素数。

**0x02** 埃拉托斯特尼筛法。

**0x04** 概率性 Miller-Rabin 素性测试。

**timestamp** 模数上次处理的时间，格式为 YYYYMMDDHHMMSS。

**type** 指定素数模数内部结构的十进制数。支持的类型为：[ssh-keygen(1)](/man/man1/ssh-keygen.1.md) 最初生成的模数候选项为 Sophie Germain 素数（类型 4）。通过 [ssh-keygen(1)](/man/man1/ssh-keygen.1.md) 进一步素性测试后，产生可在 sshd(8) 中使用的安全素数模数（类型 2）。OpenSSH 不使用其他类型。

**tests** 十进制数，表示该数已经过的素性测试类型，以如下值的位掩码表示：[ssh-keygen(1)](/man/man1/ssh-keygen.1.md) 模数候选项生成使用埃拉托斯特尼筛法（标志 0x02）。随后的 [ssh-keygen(1)](/man/man1/ssh-keygen.1.md) 素性测试为 Miller-Rabin 测试（标志 0x04）。

**trials** 十进制数，表示已对该模数执行的素性测试次数。

**size** 十进制数，表示素数的位长度。

**generator** 用于该模数的推荐生成元（十六进制）。

**modulus** 模数本身（十六进制）。

执行 Diffie-Hellman 组交换时，sshd(8) 首先估计所需的模数大小，以产生足够的 Diffie-Hellman 输出来为选定的对称密码充分密钥化。然后 sshd(8) 从 **/etc/ssh/moduli** 中随机选择一个最符合大小要求的模数。

## 参见

[ssh-keygen(1)](/man/man1/ssh-keygen.1.md), sshd(8)

> “Diffie-Hellman Group Exchange for the Secure Shell (SSH) Transport Layer Protocol”, 2006.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man5/moduli.5.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.