# Nginx快速配置指南

## 🎯 总览

本指南提供三种方式将 `hzdyjsweb.camasort.com.conf` 挂载到主nginx配置中：

1. **🚀 一键安装脚本（推荐）** - 自动检测系统并配置
2. **🏗️ 手动配置方法** - 分步骤手动操作  
3. **📚 详细说明文档** - 完整的技术文档

---

## 🚀 方法一：一键安装脚本（推荐）

### 使用智能安装脚本
```bash
# 确保文件在同一目录下
ls hzdyjsweb.camasort.com.conf nginx-setup.sh

# 执行自动安装脚本
sudo ./nginx-setup.sh
```

### 脚本特性
✅ **自动检测系统类型**（Ubuntu/Debian 或 CentOS/RHEL）  
✅ **智能选择配置方法**（sites-enabled 或 conf.d）  
✅ **自动备份现有配置**  
✅ **完整错误检查和回滚**  
✅ **彩色输出和详细日志**  
✅ **自动创建网站目录和设置权限**  

---

## 🏗️ 方法二：手动配置

根据你的系统类型选择对应方法：

### Ubuntu/Debian系统（sites-enabled方式）
```bash
# 1. 复制配置文件
sudo cp hzdyjsweb.camasort.com.conf /etc/nginx/sites-available/

# 2. 创建软链接启用站点
sudo ln -s /etc/nginx/sites-available/hzdyjsweb.camasort.com.conf /etc/nginx/sites-enabled/

# 3. 创建网站目录
sudo mkdir -p /root/hzdyjsweb9091/dist
sudo chown -R www-data:www-data /root/hzdyjsweb9091/dist
sudo chmod -R 755 /root/hzdyjsweb9091/dist

# 4. 测试并重载
sudo nginx -t
sudo nginx -s reload
```

### CentOS/RHEL系统（conf.d方式）
```bash
# 1. 复制配置文件
sudo cp hzdyjsweb.camasort.com.conf /etc/nginx/conf.d/

# 2. 创建网站目录
sudo mkdir -p /root/hzdyjsweb9091/dist
sudo chown -R nginx:nginx /root/hzdyjsweb9091/dist
sudo chmod -R 755 /root/hzdyjsweb9091/dist

# 3. 测试并重载
sudo nginx -t
sudo nginx -s reload
```

---

## 📋 验证配置

### 检查配置是否生效
```bash
# 检查nginx配置
sudo nginx -T | grep -A 5 "server_name hzdyjsweb.camasort.com"

# 检查端口监听
sudo netstat -tlnp | grep :80

# 检查nginx进程
sudo systemctl status nginx
```

### 测试访问
```bash
# 本地测试（需要配置hosts或DNS）
curl -I http://hzdyjsweb.camasort.com

# 或者直接用IP测试
curl -I http://your-server-ip -H "Host: hzdyjsweb.camasort.com"
```

---

## 🔧 日常管理命令

### 站点管理（sites-enabled方式）
```bash
# 禁用站点
sudo rm /etc/nginx/sites-enabled/hzdyjsweb.camasort.com.conf

# 重新启用站点
sudo ln -s /etc/nginx/sites-available/hzdyjsweb.camasort.com.conf /etc/nginx/sites-enabled/

# 列出所有可用站点
ls /etc/nginx/sites-available/

# 列出所有启用站点
ls /etc/nginx/sites-enabled/
```

### 站点管理（conf.d方式）
```bash
# 禁用站点
sudo mv /etc/nginx/conf.d/hzdyjsweb.camasort.com.conf /etc/nginx/conf.d/hzdyjsweb.camasort.com.conf.disabled

# 重新启用站点
sudo mv /etc/nginx/conf.d/hzdyjsweb.camasort.com.conf.disabled /etc/nginx/conf.d/hzdyjsweb.camasort.com.conf
```

### 通用命令
```bash
# 测试配置
sudo nginx -t

# 重载配置（不中断服务）
sudo nginx -s reload

# 重启nginx
sudo systemctl restart nginx

# 查看错误日志
sudo tail -f /var/log/nginx/error.log

# 查看站点访问日志
sudo tail -f /var/log/nginx/hzdyjsweb.camasort.com.access.log
```

---

## 🌐 域名配置

### DNS解析配置
在你的域名服务商控制台添加A记录：
```
类型: A
主机记录: hzdyjsweb.camasort.com
记录值: 你的服务器IP地址
TTL: 600（或默认值）
```

### 本地测试（hosts文件）
如果暂时没有DNS，可以修改本地hosts文件：
```bash
# Linux/Mac
sudo echo "your-server-ip hzdyjsweb.camasort.com" >> /etc/hosts

# Windows (以管理员身份运行)
echo your-server-ip hzdyjsweb.camasort.com >> C:\Windows\System32\drivers\etc\hosts
```

---

## 📁 文件清单

创建的文件：
- `hzdyjsweb.camasort.com.conf` - nginx站点配置文件
- `nginx-setup.sh` - 智能安装脚本（可执行）
- `nginx配置挂载说明.md` - 详细技术文档
- `nginx快速配置指南.md` - 本快速指南

---

## 🚨 常见问题

### 问题1：配置测试失败
```bash
# 检查配置语法
sudo nginx -t

# 查看详细错误信息
sudo nginx -T
```

### 问题2：无法访问站点
```bash
# 检查端口是否被占用
sudo netstat -tlnp | grep :80

# 检查防火墙设置
sudo ufw status  # Ubuntu
sudo firewall-cmd --list-all  # CentOS
```

### 问题3：权限问题
```bash
# 检查网站目录权限
ls -la /root/hzdyjsweb9091/

# 重新设置权限
sudo chown -R www-data:www-data /root/hzdyjsweb9091/dist  # Ubuntu
sudo chown -R nginx:nginx /root/hzdyjsweb9091/dist       # CentOS
sudo chmod -R 755 /root/hzdyjsweb9091/dist
```

---

## 🎯 推荐流程

1. **使用一键脚本**：`sudo ./nginx-setup.sh`
2. **配置DNS解析**：添加A记录指向服务器IP
3. **上传网站文件**：将构建产物上传到 `/root/hzdyjsweb9091/dist/`
4. **验证访问**：`curl -I http://hzdyjsweb.camasort.com`

---

**✅ 配置完成后，你的Vue前端应用就可以通过 `http://hzdyjsweb.camasort.com` 访问了！**