Files
hzdyjs/docs/部署文档/nginx配置/nginx快速配置指南.md
T
2025-08-08 20:35:17 +08:00

220 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 访问了!**