Nginx 1.28.0 源码编译安装与自定义网页部署详细指南

 更新时间:2026年05月11日 09:42:39   作者:Lw老王要学习  
本文介绍了Nginx1.28.0的安装过程,提供了自定义HTML文件部署步骤、安装后核心目录说明、常用管理命令、部署前端项目示例等内容,感兴趣的朋友跟随小编一起看看吧

一、前置说明

  • 安装包:nginx-1.28.0.tar.gz,已上传至 /root 目录
  • 系统:CentOS 7.x(适配你当前的环境)
  • 安装方式:源码编译安装,默认安装到 /usr/local/nginx
  • 前置依赖:gcc、pcre、zlib、openssl(脚本自动安装)

二、一键安装脚本(推荐直接使用)

vim /root/nginx_install.sh
  • 脚本如下:
#!/bin/bash
# Nginx 1.28.0 源码编译安装脚本(CentOS 7.x,root执行)
# ==================== 配置参数 ====================
NGINX_VERSION="1.28.0"
NGINX_PACKAGE="/root/nginx-${NGINX_VERSION}.tar.gz"
INSTALL_PATH="/usr/local/nginx"
# =================================================
# 1. 检查root权限
if [ $UID -ne 0 ]; then
    echo "请使用root用户执行此脚本!"
    exit 1
fi
# 2. 检查安装包是否存在
if [ ! -f "${NGINX_PACKAGE}" ]; then
    echo "错误:/root目录下未找到nginx-${NGINX_VERSION}.tar.gz安装包!"
    exit 1
fi
# 3. 安装编译依赖
echo "===== 安装编译依赖 ====="
yum install -y gcc gcc-c++ make pcre pcre-devel zlib zlib-devel openssl openssl-devel
# 4. 解压源码包
echo "===== 解压Nginx源码包 ====="
cd /root
tar -zxf nginx-${NGINX_VERSION}.tar.gz
cd nginx-${NGINX_VERSION}
# 5. 配置编译参数(含SSL、gzip、rewrite等核心模块)
echo "===== 配置编译参数 ====="
./configure \
--prefix=${INSTALL_PATH} \
--with-http_ssl_module \
--with-http_gzip_static_module \
--with-http_stub_status_module \
--with-http_realip_module \
--with-pcre
# 6. 编译并安装
echo "===== 编译并安装Nginx ====="
make && make install
# 7. 配置环境变量(方便直接调用nginx命令)
echo "===== 配置环境变量 ====="
if ! grep -q "nginx" /etc/profile; then
    echo "export PATH=\$PATH:${INSTALL_PATH}/sbin" >> /etc/profile
fi
source /etc/profile
# 8. 创建系统服务(systemd管理,开机自启)
echo "===== 创建Nginx系统服务 ====="
cat > /usr/lib/systemd/system/nginx.service << EOF
[Unit]
Description=Nginx Web Server
After=network.target
[Service]
Type=forking
ExecStart=${INSTALL_PATH}/sbin/nginx
ExecReload=${INSTALL_PATH}/sbin/nginx -s reload
ExecStop=${INSTALL_PATH}/sbin/nginx -s stop
PrivateTmp=true
[Install]
WantedBy=multi-user.target
EOF
# 重载systemd配置并设置开机自启
systemctl daemon-reload
systemctl enable nginx
# 9. 开放防火墙端口(80/443)
echo "===== 开放防火墙端口 ====="
firewall-cmd --add-service=http --permanent
firewall-cmd --add-service=https --permanent
firewall-cmd --reload
# 10. 启动Nginx并验证
echo "===== 启动Nginx并验证 ====="
systemctl start nginx
sleep 2
if ps aux | grep nginx | grep -v grep > /dev/null; then
    echo "====================================="
    echo "✅ Nginx ${NGINX_VERSION} 安装成功!"
    echo "安装路径:${INSTALL_PATH}"
    echo "配置文件:${INSTALL_PATH}/conf/nginx.conf"
    echo "网页目录:${INSTALL_PATH}/html"
    echo "启动命令:systemctl start nginx"
    echo "访问地址:http://你的服务器IP"
    echo "====================================="
else
    echo "❌ Nginx 启动失败,请检查安装日志!"
    exit 1
fi

赋权执行脚本+重新加载环境变量

chmod +x nginx_install.sh
sh /root/nginx_install.sh
source /etc/profile

三、手动分步安装流程(可选)

步骤1:安装编译依赖

yum install -y gcc gcc-c++ make pcre pcre-devel zlib zlib-devel openssl openssl-devel

步骤2:解压源码包

cd /root
tar -zxf nginx-1.28.0.tar.gz
cd nginx-1.28.0

步骤3:配置编译参数

./configure \
--prefix=/usr/local/nginx \
--with-http_ssl_module \
--with-http_gzip_static_module \
--with-http_stub_status_module \
--with-http_realip_module \
--with-pcre

步骤4:编译并安装

make && make install

步骤5:配置环境变量

echo "export PATH=\$PATH:/usr/local/nginx/sbin" >> /etc/profile
source /etc/profile

步骤6:创建systemd服务

cat > /usr/lib/systemd/system/nginx.service << EOF
[Unit]
Description=Nginx Web Server
After=network.target
[Service]
Type=forking
ExecStart=/usr/local/nginx/sbin/nginx
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s stop
PrivateTmp=true
[Install]
WantedBy=multi-user.target
EOF
# 重载配置并设置开机自启
systemctl daemon-reload
systemctl enable nginx

步骤7:开放防火墙端口

firewall-cmd --add-service=http --permanent
firewall-cmd --add-service=https --permanent
firewall-cmd --reload

步骤8:启动并验证

# 启动Nginx
systemctl start nginx
# 验证进程
ps aux | grep nginx
# 验证端口(80端口)
ss -tlnp | grep 80
# 本地访问测试
curl http://127.0.0.1

步骤9、自定义HTML文件部署步骤

替换默认首页(快速测试)

如果仅需替换Nginx默认的欢迎页,直接将自定义的index.html覆盖默认文件即可:

# 备份默认首页(可选)
cp /usr/local/nginx/html/index.html /usr/local/nginx/html/index.html.bak
# 将本地自定义的index.html上传到服务器(示例用scp,也可通过rz、FTP等方式)
scp /本地路径/index.html root@你的服务器IP:/usr/local/nginx/html/
# 刷新页面即可访问(无需重启Nginx)

----#####我这里用的xftp¥¥¥¥¥----

四、安装后核心目录说明

目录/文件作用说明
/usr/local/nginx/conf/nginx.conf主配置文件,所有反向代理、站点配置都在这里
/usr/local/nginx/conf/conf.d/自定义站点配置目录(可手动创建,在nginx.conf中include)
/usr/local/nginx/html/默认网页根目录,部署前端项目时将文件放在这里
/usr/local/nginx/logs/日志目录,包含access.log(访问日志)和error.log(错误日志)
/usr/local/nginx/sbin/nginxNginx主程序,可直接执行命令(如nginx -s reload重载配置)

五、常用管理命令

# 启动Nginx
systemctl start nginx
# 停止Nginx
systemctl stop nginx
# 重启Nginx
systemctl restart nginx
# 重载配置(修改配置文件后用,不中断服务)
systemctl reload nginx
# 或直接用主程序
nginx -s reload
# 检查配置文件语法
nginx -t
# 查看Nginx状态
systemctl status nginx
# 查看Nginx进程
ps aux | grep nginx
# 查看端口占用
ss -tlnp | grep nginx

六、部署前端项目示例

  1. 将前端打包文件上传至 /usr/local/nginx/html/你的项目目录(如 /usr/local/nginx/html/frontend
  2. 编辑配置文件 /usr/local/nginx/conf/nginx.conf,添加站点配置:
server {
    listen 80;
    server_name 你的服务器IP;
    location / {
        root /usr/local/nginx/html/frontend;
        index index.html index.htm;
        try_files $uri $uri/ /index.html; # 解决SPA路由刷新404问题
    }
    # 反向代理后端接口示例
    location /api {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
  1. 检查配置并重载:
nginx -t && nginx -s reload

七、常见问题排查

  1. 端口被占用:执行 ss -tlnp | grep 80 查看占用进程,停止占用进程或修改Nginx监听端口
  2. 配置文件语法错误nginx -t 会明确提示错误位置,根据提示修改配置文件
  3. 访问403 Forbidden:检查网页目录权限,确保Nginx进程用户(默认nobody)有读取权限
  4. 无法访问:检查防火墙是否开放80/443端口,服务器安全组是否放行

到此这篇关于Nginx 1.28.0 源码编译安装与自定义网页部署简明指南的文章就介绍到这了,更多相关nginx 1.28.0 源码编译安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • nginx里集成php模块安装配置步骤详解

    nginx里集成php模块安装配置步骤详解

    这篇文章主要为大家介绍了nginx里集成php模块安装配置步骤详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-08-08
  • 通过nginx做mysql的负载均衡实现过程

    通过nginx做mysql的负载均衡实现过程

    Nginx stream模块用于DNS和主从MySQL的TCP/UDP代理与负载均衡,安装需编译启用或通过yum安装,配置stream块及upstream实现转发和轮询,测试后验证端口监听状态
    2025-07-07
  • nginx反向代理二级域名绑定方法及注意事项

    nginx反向代理二级域名绑定方法及注意事项

    本文介绍了利用nginx实现多域名和多站点的绑定的方法及相关注意事项,需要的朋友可以参考下
    2018-04-04
  • 讨论nginx location 顺序问题

    讨论nginx location 顺序问题

    在有一次配置时发现,请求 uri 明明是符合了前缀匹配 ^~ 规则,但 nginx 却没有使用,这让我对上述结论产生了疑惑。后续通过调研、实践后发现,上述结论可以说对,但也不对,是不是更疑惑了?没关系,看完这篇文章你就知道我为什么会这样说了
    2022-05-05
  • 深入浅析Nginx虚拟主机

    深入浅析Nginx虚拟主机

    对于Nginx而言,每一个虚拟主机相当于一个在同一台服务器中却相互独立的站点,从而实现一台主机对外提供多个 web 服务,每个虚拟主机之间是独立的,互不影响的。这篇文章主要介绍了Nginx虚拟主机的相关知识,需要的朋友可以参考下
    2020-07-07
  • nginx 访问限制与访问控制的实现

    nginx 访问限制与访问控制的实现

    访问控制要做的事情是控制客户端的资源访问权限,本文主要介绍了nginx 访问限制与访问控制的实现,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
    2024-02-02
  • Nginx接收Http协议请求转发使用Https协议的问题

    Nginx接收Http协议请求转发使用Https协议的问题

    这篇文章主要介绍了Nginx接收Http协议请求转发使用Https协议,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-06-06
  • Nginx自定义日志中时间格式的操作方法

    Nginx自定义日志中时间格式的操作方法

    工作需要对接内部的日志中台,对日志打印有固定的格式要求,为了使Nginx的access日志也能被采集,需要对日志格式进行自定义,这篇文章主要介绍了Nginx自定义日志中时间格式,需要的朋友可以参考下
    2023-11-11
  • Nginx 负载均衡算法及故障转移解析

    Nginx 负载均衡算法及故障转移解析

    这篇文章主要介绍了Nginx 负载均衡算法及故障转移解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-09-09
  • nginx php-fpm环境中chroot功能的配置使用方法

    nginx php-fpm环境中chroot功能的配置使用方法

    这篇文章主要介绍了nginx php-fpm环境中chroot功能的配置使用方法,此方法是比禁用PHP敏感函数更好的一个安全防护手手段,需要的朋友可以参考下
    2014-05-05

最新评论