在 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处理!