源码安装 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 系统中本地编译软件手册的标准位置:
- 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 更新完成)











