Windows 下 Nginx 安装与配置指南 [特殊字符]

Windows 下 Nginx 安装与配置指南 🚀

📋 目录

• 安装 Nginx
• 基础配置
• 启动与管理
• 设置开机自启
• 验证服务
• 常见问题
• 进阶配置

🔧 安装 Nginx

下载 Nginx

• 官网下载地址：https://nginx.org/en/download.html
• 选择稳定版（Stable version）的 Windows 版本（nginx/Windows-x.x.x）

解压安装

# 解压到指定目录（建议路径不要包含中文和空格）
Expand-Archive -Path .\nginx-x.x.x.zip -DestinationPath C:\nginx

目录结构

C:\nginx
├── conf/            # 配置文件目录
│   └── nginx.conf   # 主配置文件
├── html/            # 默认网站根目录
├── logs/            # 日志文件
└── nginx.exe        # 主程序

⚙️ 基础配置

修改主配置文件 (conf/nginx.conf)

worker_processes  1;  # 根据CPU核心数调整events {worker_connections  1024;
}http {include       mime.types;default_type  application/octet-stream;sendfile        on;keepalive_timeout  65;server {listen       9011;  # 自定义端口server_name  localhost;location / {root   html/dist;  # 前端项目路径index  index.html;try_files $uri $uri/ /index.html;  # 处理前端路由}# 后端API代理location /api/ {proxy_pass http://localhost:9010/;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;}}
}

检查配置文件语法

cd C:\nginx
.\nginx.exe -t
# 看到 "syntax is ok" 表示配置正确 ✅

🚀 启动与管理

启动服务

# 启动（控制台窗口运行）
.\nginx.exe# 后台静默启动
Start-Process -FilePath ".\nginx.exe"

常用命令

# 重新加载配置（不中断服务）
.\nginx.exe -s reload# 停止服务
.\nginx.exe -s stop# 强制退出
.\nginx.exe -s quit

🔄 设置开机自启（可选）

创建计划任务

$action = New-ScheduledTaskAction -Execute "C:\nginx\nginx.exe"
$trigger = New-ScheduledTaskTrigger -AtStartup
Register-ScheduledTask -TaskName "Nginx_Service" -Action $action -Trigger $trigger -RunLevel Highest

✅ 验证服务

检查端口监听

netstat -ano | findstr "9011"
# 应看到 nginx.exe 进程监听端口

浏览器访问

http://localhost:9011

❓ 常见问题

端口占用

# 查找占用端口的进程
netstat -ano | findstr "9011"
tasklist | findstr "PID"

权限问题

• 以管理员身份运行 PowerShell 👨‍💻
• 关闭 Windows Defender 防火墙测试 🛡️

查看错误日志

C:\nginx\logs\error.log

🔥 进阶配置

多站点配置

http {# 站点1 - 前端项目server {listen 9011;server_name site1.local;root html/site1;}# 站点2 - 另一个项目server {listen 9012;server_name site2.local;root html/site2;}
}

HTTPS 配置

server {listen       443 ssl;server_name  localhost;ssl_certificate      cert.pem;ssl_certificate_key  cert.key;ssl_session_cache    shared:SSL:1m;ssl_session_timeout  5m;
}

---

💡 提示：修改配置后记得执行 nginx -s reload 使配置生效