# Nginx 安装与启动教程

URL: https://caijiao.org/nginx/install-and-start
Source: docs/nginx/install-and-start.md
Description: 本节详细讲解 Nginx 安装与启动教程，涵盖在 Linux、Windows 与 macOS 上安装 nginx、启动服务与常用命令，帮助你快速部署 Nginx 环境。

在使用 **Nginx** 前，需要先完成安装与服务启动。本节将介绍在 **Linux、Windows、macOS** 等平台上安装与运行 Nginx 的方法，并提供验证与命令示例。

## 一、Linux 下安装 Nginx

### 1. 使用包管理器安装

#### 🟢 CentOS / Rocky Linux / RHEL 系列

```bash
sudo yum install epel-release -y
sudo yum install nginx -y
````

#### 🔵 Ubuntu / Debian 系列

```bash
sudo apt update
sudo apt install nginx -y
```

### 2. 启动与开机自启

```bash
sudo systemctl start nginx
sudo systemctl enable nginx
```

### 3. 验证安装

在浏览器中访问：
👉 [http://localhost](http://localhost)
如果看到 “Welcome to Nginx” 页面，则说明安装成功。

## 二、Windows 下安装 Nginx

1. 前往 [nginx官网](https://nginx.org/en/download.html) 下载 Windows 版压缩包。
2. 解压后进入目录，例如 `C:\nginx`。
3. 在命令提示符中运行：

```bash
start nginx
```

4. 访问 [http://localhost](http://localhost) 验证是否启动成功。

停止 Nginx：

```bash
nginx -s stop
```

重新加载配置：

```bash
nginx -s reload
```

## 三、macOS 安装 Nginx

通过 Homebrew 安装：

```bash
brew install nginx
```

启动服务：

```bash
brew services start nginx
```

Nginx 默认运行在端口 `8080`，可访问
👉 [http://localhost:8080](http://localhost:8080)

## 四、验证与常用命令

| 命令                       | 功能说明          |
| ------------------------ | ------------- |
| `nginx -t`               | 检查配置文件语法是否正确  |
| `nginx -s reload`        | 热加载配置文件       |
| `nginx -s stop`          | 停止 Nginx 服务   |
| `nginx -v`               | 查看 Nginx 版本   |
| `systemctl status nginx` | 查看 Nginx 运行状态 |

## 五、常见问题

* **80 端口被占用**：修改 `nginx.conf` 的 `listen` 端口或关闭冲突进程。
* **启动失败**：检查配置文件错误，执行 `nginx -t` 验证后再启动。
* **权限不足**：使用 `sudo` 运行或调整文件权限。

---

通过本节学习，你已掌握 Nginx 的安装、启动与验证方式，为后续配置与优化打下基础。