源码安装 Nginx 后需手动部署手册页：将 nginx.8 放入 /usr/local/share/man/man8/，执行 sudo mandb -q 更新数据库，并在 MANPATH 中添加该路径，最后用 man -w nginx 和 man nginx 验证。

源码安装 Nginx 后，man nginx 默认不可用，因为安装过程不自动部署手册页，也不更新系统手册索引和路径。要让命令行帮助正常工作，需手动完成手册文件放置、路径注册和索引重建三步。

确认 nginx.8 手册文件是否存在

Nginx 源码包的 docs/man/ 目录下通常自带 nginx.8 文件。安装前可检查：

• ls /path/to/nginx-source/docs/man/nginx.8 —— 若有输出，说明手册可用
• 若缺失，可从官网下载对应版本的源码包提取，或直接复制已验证可用的 nginx.8（注意格式为 Unix man 手册标准 troff 格式）

将 nginx.8 安装到标准 man 路径

推荐目标路径为 /usr/local/share/man/man8/，这是 GNU/Linux 系统中本地编译软件手册的标准位置：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

• sudo mkdir -p /usr/local/share/man/man8
• sudo cp /path/to/nginx-source/docs/man/nginx.8 /usr/local/share/man/man8/
• sudo mandb -q —— 静默更新手册数据库（部分系统如 Debian/Ubuntu 需此步；CentOS/RHEL 可用 sudo mandb）

确保 MANPATH 包含本地手册目录

即使文件放对了，如果 MANPATH 不包含该路径，man 命令仍找不到它：

• 运行 echo $MANPATH 查看当前值；若为空或不含 /usr/local/share/man，需补充
• 编辑 ~/.bashrc 或 /etc/profile，添加：
  export MANPATH="/usr/local/share/man:$MANPATH"
• 执行 source ~/.bashrc 生效（或新开终端）

验证配置是否成功

执行以下命令逐项确认：

• man -w nginx → 应输出 /usr/local/share/man/man8/nginx.8
• man nginx → 应分页显示完整的 Nginx 手册内容（含 SYNOPSIS、OPTIONS、SIGNALS 等）
• man -k nginx → 应列出 nginx (8) 条目（依赖 mandb 更新完成）