在 Ubuntu 22.04 上安装和配置 Nginx 的完整指南
阅读:19 2025-07-10
✅ 一、更新系统 & 安装 Nginx
打开终端,依次执行:
sudo apt update sudo apt install nginx -y
安装完成后,系统会自动创建并启动 Nginx 服务。
✅ 二、检查安装状态
查看 Nginx 是否成功安装:
nginx -v
输出示例:
nginx version: nginx/1.18.0 (Ubuntu)
查看服务状态:
sudo systemctl status nginx
浏览器访问:
打开浏览器访问:http://服务器IP
你将看到:
Welcome to nginx!
✅ 三、常用命令整理
命令 | 说明 |
---|---|
sudo systemctl start nginx | 启动 Nginx |
sudo systemctl stop nginx | 停止 Nginx |
sudo systemctl restart nginx | 重启服务 |
sudo nginx -t | 检查配置语法 |
sudo nginx -s reload | 平滑重载配置 |
sudo systemctl enable nginx | 开机自启 |
✅ 四、文件结构说明
路径 | 说明 |
---|---|
/etc/nginx/nginx.conf | 主配置文件 |
/etc/nginx/sites-available/ | 可用的站点配置 |
/etc/nginx/sites-enabled/ | 启用的站点配置(软链接) |
/var/www/html/ | 默认网站根目录 |
/var/log/nginx/ | 日志目录 |
✅ 五、配置一个自定义站点
以 /var/www/my-site
为例。
1. 创建网站目录和测试文件
sudo mkdir -p /var/www/my-siteecho "<h1>Hello from my-site</h1>" | sudo tee /var/www/my-site/index.html
2. 创建配置文件
sudo nano /etc/nginx/sites-available/my-site
添加以下内容:
server { listen 80; server_name your-domain.com; # 或使用 IP 访问时填你的服务器IP root /var/www/my-site; index index.html; access_log /var/log/nginx/my-site.access.log; error_log /var/log/nginx/my-site.error.log; location / { try_files $uri $uri/ =404; } }
3. 启用该站点
sudo ln -s /etc/nginx/sites-available/my-site /etc/nginx/sites-enabled/
4. 检查配置是否正确
sudo nginx -t
5. 重载配置生效
sudo systemctl reload nginx
6. 浏览器访问
打开 http://your-server-ip
,看到:
Hello from my-site
✅ 六、开启防火墙端口(如有开启 UFW)
sudo ufw allow 'Nginx Full'sudo ufw reload
✅ 七、可选:绑定多个站点
你可以重复创建多个配置文件,例如:
/etc/nginx/sites-available/blog
/etc/nginx/sites-available/api
并分别绑定到不同域名或端口上,实现多站点部署。
✅ 八、可选:开启 HTTPS(使用 Let's Encrypt)
安装 Certbot:
sudo apt install certbot python3-certbot-nginx -y
自动配置并签发证书(需绑定域名并已解析):
sudo certbot --nginx
自动续签配置(建议):
sudo systemctl status certbot.timer
✅ 九、日志查看与调试
# 实时查看访问日志tail -f /var/log/nginx/access.log# 实时查看错误日志tail -f /var/log/nginx/error.log
🧠 十、常见问题排查
问题 | 原因 | 解决方法 |
---|---|---|
403 Forbidden | 文件无权限或根目录设置错误 | chmod -R 755 和确认 root 设置 |
404 Not Found | 路径拼写错误 / 文件不存在 | 检查 root 与文件路径是否匹配 |
502 Bad Gateway | 后端服务未响应 | 检查 proxy_pass 设置或后端程序是否已启动 |
✅ 结语
至此,你已经完成了 Ubuntu 22.04 上 Nginx 的完整安装与部署。你现在可以:
部署 HTML 静态站点
配合 PHP / Node 等后端项目
使用 Let’s Encrypt 免费证书部署 HTTPS
扩展多站点配置、反向代理、缓存等高级功能
声明
1、部分文章来源于网络,仅作为参考。 2、如果网站中图片和文字侵犯了您的版权,请联系1943759704@qq.com处理!