Dot520 文档中心

主题

Dot5202025-03-31
907
3.5m

Nginx 常用命令速查笔记 ​

本文档主打 Nginx 日常运维常用命令，精简冗余内容，保留生产环境高频使用指令、配置校验、启停规范及关键避坑要点，适用于 CentOS 7+ 系统，可直接复制使用。

一、Nginx 核心常用命令 ​

统一使用 systemctl 服务管理，普通用户需加 sudo 提权，root 用户可直接执行。

1. 安装命令 ​

bash
# 一键安装 Nginx（自动确认）
sudo yum install nginx -y

2. 服务启停、重启、重载（高频） ​

bash
# 启动服务
sudo systemctl start nginx

# 停止服务（优雅停机，处理完现有请求再关闭）
sudo systemctl stop nginx

# 【生产最常用】重载配置（不中断业务，更新配置必用）
sudo systemctl reload nginx

# 重启服务（中断业务，仅重大修改使用）
sudo systemctl restart nginx

# 完整服务重启写法（效果同上）
sudo systemctl restart nginx.service

3. 状态查看与开机自启 ​

bash
# 查看运行状态、报错、进程信息
sudo systemctl status nginx

# 设置开机自启
sudo systemctl enable nginx

# 关闭开机自启
sudo systemctl disable nginx

4. 配置校验命令（关键避坑） ​

bash
# 校验 Nginx 配置文件语法是否正确
nginx -t

# 校验并显示详细配置信息
nginx -T

使用规范：修改任何 Nginx 配置后，先校验、再重载，避免配置错误导致服务启动失败。

5. 辅助常用命令 ​

bash
# 查看 Nginx 版本
nginx -v

# 强制停止 Nginx（暴力停止，慎用）
pkill nginx

二、命令使用核心注意事项 ​

  • 优先 reload，少用 restart：reload 热更新配置，无业务中断；restart 会断开当前连接，影响用户访问。

  • 端口冲突禁忌：Nginx 监听端口、后端代理服务端口、本地其他进程端口不能重复，否则启动报错。

  • 权限要求：端口小于1024需管理员权限，日常操作统一加 sudo 避免权限报错。

  • 故障排查：服务异常优先用 status nginx 查看日志报错，快速定位问题。

三、极简常用配置（配套命令使用） ​

仅保留高频反向代理基础配置，适配日常接口转发场景，修改后配合上述命令生效。

nginx
# 常规反向代理基础配置
server {
    listen 5002;
    server_name localhost;
    client_max_body_size 10m;

    location / {
        proxy_pass http://127.0.0.1:5003;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # SignalR 长连接访问配置（解决WebSocket连接、504超时问题）
    location /hub {
        proxy_pass http://webname ;  # 替换为实际 Web 服务地址（IP+端口/域名）

        # 解决长连接504超时问题，默认60秒，建议业务按需延长
        proxy_send_timeout 600;
        proxy_read_timeout 600;
        proxy_connect_timeout 600;

        # WebSocket 长连接核心协议升级配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
    }
}

SignalR 长连接访问配置（解决WebSocket连接、504超时问题） ​


    location /hub {
        proxy_pass http://webname ;  # 替换 http://webname 为您的实际 Web 服务地址

        # 解决 Nginx 504 问题
        # proxy_send_timeout 600; # 单位秒 默认60
        # proxy_read_timeout 600; # 单位秒 默认60
        # proxy_connect_timeout 600; # 单位秒 默认60

        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host; 
    }

四、Windows 系统 Nginx 安装为系统服务 ​

Windows 默认双击启动 Nginx 为临时进程，关闭窗口即停止服务，推荐注册为系统服务，实现开机自启、后台运行。 实现方案 借助 nssm 工具将 Nginx 封装为 Windows 系统服务，稳定无闪退，运维便捷。

  1. 下载 nssm 工具，解压后对应系统位数使用对应程序；
  2. cmd 进入 nssm 目录，执行命令创建服务；
  3. 配置 Nginx 程序路径、启动参数，设置开机自启；
  4. 可在 Windows 服务列表中直接启停、管理 Nginx。
最近更新