源码安装 Nginx 后需手动安装 nginx.8 手册页至 /usr/local/share/man/man8/,创建目录、复制文件、运行 sudo mandb 更新索引,并确保 MANPATH 包含该路径,最后通过 man -w nginx 和 man nginx 验证。

源码安装 Nginx 后,man nginx 默认无法使用,因为安装过程不会自动将手册页(man page)复制到系统 man 路径,也不会更新 MANPATH。需手动配置手册页位置并确保系统能识别。
确认 Nginx 自带 man 手册是否存在
Nginx 源码包中通常包含 nginx.8(位于 docs/man/ 目录下)。编译安装后,该文件一般不会被自动安装。可检查源码目录:
ls /path/to/nginx-source/docs/man/nginx.8- 若存在,说明手册可用;若无,可从官网或源码包中单独获取
将 nginx.8 安装到标准 man 路径
推荐安装到 /usr/local/share/man/man8/(对应本地软件的 man 路径),操作如下:
- 创建目标目录:
sudo mkdir -p /usr/local/share/man/man8 - 复制手册页:
sudo cp /path/to/nginx-source/docs/man/nginx.8 /usr/local/share/man/man8/ - 更新 mandb 索引:
sudo mandb(部分系统用sudo mandb -q静默更新)
确保 MANPATH 包含本地 man 目录
多数现代系统已默认包含 /usr/local/share/man,但可验证并补充:
- 运行
echo $MANPATH查看当前路径 - 若输出为空或不含
/usr/local/share/man,在/etc/profile或~/.bashrc中添加:export MANPATH="/usr/local/share/man:$MANPATH" - 重新加载配置:
source ~/.bashrc(或重启终端)
验证配置是否生效
执行以下命令确认:
-
man -w nginx→ 应输出类似/usr/local/share/man/man8/nginx.8 -
man nginx→ 应正常显示 Nginx 手册内容 -
man -k nginx→ 可搜索相关手册条目(需 mandb 已更新)










