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

5.0 KiB
Raw Blame History

Nginx快速配置指南

🎯 总览

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

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

🚀 方法一:一键安装脚本(推荐)

使用智能安装脚本

# 确保文件在同一目录下
ls hzdyjsweb.camasort.com.conf nginx-setup.sh

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

脚本特性

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


🏗️ 方法二:手动配置

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

Ubuntu/Debian系统(sites-enabled方式)

# 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方式)

# 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

📋 验证配置

检查配置是否生效

# 检查nginx配置
sudo nginx -T | grep -A 5 "server_name hzdyjsweb.camasort.com"

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

# 检查nginx进程
sudo systemctl status nginx

测试访问

# 本地测试(需要配置hosts或DNS)
curl -I http://hzdyjsweb.camasort.com

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

🔧 日常管理命令

站点管理(sites-enabled方式)

# 禁用站点
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方式)

# 禁用站点
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

通用命令

# 测试配置
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文件:

# 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:配置测试失败

# 检查配置语法
sudo nginx -t

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

问题2:无法访问站点

# 检查端口是否被占用
sudo netstat -tlnp | grep :80

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

问题3:权限问题

# 检查网站目录权限
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 访问了!