幕雪

ubuntu安装nginx：全面指南与常见问题解答

引言：Ubuntu 与 Nginx 的强强联合

在现代网络服务部署中，选择一个高效、稳定的操作系统与一个性能卓越的Web服务器至关重要。Ubuntu，作为一款广受欢迎的Linux发行版，以其强大的社区支持和易用性成为众多开发者的首选。而Nginx（发音：Engine-X），则是一款轻量级、高性能的HTTP和反向代理服务器，同时也可以作为邮件代理服务器和通用的TCP/UDP代理服务器。Nginx以其高并发处理能力、低内存消耗和卓越的稳定性而闻名。

将Nginx部署在Ubuntu系统上，是构建高性能、可扩展网络服务的常见且高效的组合。本篇文章将详细探讨在Ubuntu系统上安装、配置和管理Nginx的方方面面，涵盖其“是什么”、“为什么”、“哪里”、“如何”以及“常见问题”等实用信息，旨在为读者提供一个清晰、详尽的实战指南。

一、Nginx 是什么？为何在 Ubuntu 上选择它？

1.1 Nginx 简介

Nginx 是一个高性能的 HTTP 和反向代理服务器，也可以用作邮件代理服务器和通用 TCP/UDP 代理服务器。自2004年首次发布以来，它已成为全球最受欢迎的Web服务器软件之一，尤其在处理高并发连接方面表现卓越。

  • 高性能： 采用事件驱动、异步非阻塞的架构，能够处理数百万并发连接，远超传统Web服务器。
  • 低资源消耗： 即使在高负载下，Nginx 也能保持极低的内存和CPU占用。
  • 稳定性： 设计精良，在高压环境下表现稳定可靠。
  • 功能丰富： 除了作为Web服务器，还支持反向代理、负载均衡、HTTP缓存、SSL/TLS加密、URL重写等多种功能。
  • 模块化设计： 提供了丰富的模块，可以根据需求灵活配置和扩展功能。

1.2 为何在 Ubuntu 上安装 Nginx？

将Nginx部署在Ubuntu上，是许多Web服务架构的黄金搭档，原因如下：

  • 广泛的生态系统： Ubuntu拥有庞大活跃的用户和开发者社区，这意味着你可以轻松找到大量的教程、解决方案和支持。Nginx在Ubuntu上的部署案例也极其丰富。
  • 易于安装和管理： Ubuntu的APT包管理系统使得Nginx的安装和更新变得异常简单快捷。同时，Systemd服务管理器也让Nginx的启停、重启和状态检查变得标准化且方便。
  • 稳定性与安全性： Ubuntu作为一款企业级操作系统，提供定期的安全更新和长期支持版本（LTS），保证了系统的稳定性和安全性，为Nginx的稳定运行提供了坚实基础。
  • 资源效率： Nginx本身以高效著称，结合Ubuntu的轻量级特性，可以在有限的硬件资源上实现高性能的Web服务。
  • 高度兼容性： Nginx与Ubuntu上的其他常见服务（如PHP-FPM、Node.js、Python应用等）以及数据库（MySQL、PostgreSQL）兼容性良好，便于构建完整的应用堆栈。

二、在 Ubuntu 上安装 Nginx：从何处获取？

在Ubuntu上安装Nginx主要有两种方式：通过Ubuntu官方仓库安装（推荐）和通过Nginx官方仓库安装（获取最新版本）。两种方式各有优劣，您可以根据自己的需求选择。

2.1 Ubuntu 官方仓库安装 (推荐)

这是最简单、最常用的安装方式。Ubuntu官方仓库通常提供稳定且经过良好测试的Nginx版本，易于维护。

  1. 更新包列表：

    在安装任何新软件之前，始终建议更新本地的包索引，以确保您能安装到最新可用的版本信息。 

    sudo apt update
  2. 安装 Nginx：

    执行以下命令安装Nginx。系统会自动处理所有依赖关系。 

    sudo apt install nginx
  3. 验证安装：

    安装完成后，Nginx服务通常会自动启动。您可以通过以下命令检查其运行状态： 

    systemctl status nginx

    如果输出中显示“active (running)”，则表示Nginx已成功安装并正在运行。

2.2 Nginx 官方仓库安装 (获取最新版本)

如果您需要最新特性或更高性能，或者Ubuntu仓库中的Nginx版本不够新，您可以选择从Nginx官方仓库安装。这种方法会稍微复杂一些，但能保证您获取到Nginx的最新稳定版或主线版。

  1. 安装必要的依赖：

    首先，安装用于添加APT仓库的工具以及支持HTTPS的包。 

    sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
  2. 导入 Nginx 签名密钥：

    为了验证从Nginx仓库下载的包的真实性，需要导入其官方签名密钥。 

    curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
  3. 验证密钥指纹：

    验证导入的密钥指纹是否正确，以确保安全性。 

    gpg --dry-run --quiet --no-wrapper \
    --import --import-options show-only \
    --keyring /usr/share/keyrings/nginx-archive-keyring.gpg \
    /usr/share/keyrings/nginx-archive-keyring.gpg

    输出的指纹应与Nginx官方网站上公布的指纹一致。

  4. 添加 Nginx 仓库：

    根据您希望安装的版本（稳定版或主线版），添加对应的仓库。

    稳定版 (Stable): 适用于生产环境，经过充分测试。 

    echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
    http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
    | sudo tee /etc/apt/sources.list.d/nginx.list

    主线版 (Mainline): 包含最新功能和bug修复，但可能不如稳定版经过充分测试。 

    echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
    http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
    | sudo tee /etc/apt/sources.list.d/nginx.list
  5. 配置APT优先使用Nginx仓库：

    创建一个新的APT配置文件，确保系统优先从Nginx官方仓库获取Nginx包，而不是Ubuntu官方仓库。 

    echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
    | sudo tee /etc/apt/preferences.d/99nginx
  6. 更新包列表并安装 Nginx：

    更新包列表后，即可安装Nginx。 

    sudo apt update
sudo apt install nginx
  7. 验证安装：

    同样，检查Nginx状态和版本。 

    systemctl status nginx
nginx -v

三、如何配置与管理 Nginx？

Nginx 的强大之处在于其灵活的配置。理解其配置文件结构和常用命令是管理Nginx的关键。

3.1 Nginx 服务管理

Nginx 是一个Systemd服务，可以使用`systemctl`命令进行管理。

  • 启动 Nginx： 
    sudo systemctl start nginx
  • 停止 Nginx： 
    sudo systemctl stop nginx
  • 重启 Nginx： (会完全停止并重新启动服务，适用于较大的配置更改) 
    sudo systemctl restart nginx
  • 重新加载 Nginx 配置： (在不中断服务的情况下应用新的配置，适用于大多数配置更改) 
    sudo systemctl reload nginx
  • 检查 Nginx 状态： 
    systemctl status nginx
  • 开机自启 Nginx： 
    sudo systemctl enable nginx
  • 禁用开机自启 Nginx： 
    sudo systemctl disable nginx

3.2 防火墙设置 (UFW)

如果您在Ubuntu上启用了UFW (Uncomplicated Firewall)，您需要允许HTTP和HTTPS流量通过防火墙，Nginx在安装时会自动注册UFW应用程序配置文件。

  1. 检查可用的 Nginx UFW 配置：

    sudo ufw app list

    通常会看到以下选项：

    • `Nginx Full`: 同时开放80端口 (HTTP) 和 443端口 (HTTPS)。
    • `Nginx HTTP`: 仅开放80端口 (HTTP)。
    • `Nginx HTTPS`: 仅开放443端口 (HTTPS)。
  2. 允许 Nginx HTTP/HTTPS 流量：

    根据您的需求选择开放相应的端口。例如，如果您计划同时提供HTTP和HTTPS服务，可以使用： 

    sudo ufw allow 'Nginx Full'

    如果您暂时只提供HTTP服务： 

    sudo ufw allow 'Nginx HTTP'
  3. 检查 UFW 状态：

    sudo ufw status

    确保Nginx相关的规则已添加。

3.3 Nginx 默认工作验证

安装并允许防火墙后，您可以在Web浏览器中访问您的服务器IP地址或域名。如果您看到Nginx的默认欢迎页面，表明Nginx已成功运行。

例如，如果您的服务器IP地址是 `192.168.1.100`，则在浏览器中输入 `http://192.168.1.100`。

3.4 Nginx 配置文件的结构与作用

Nginx的配置中心位于`/etc/nginx/`目录。以下是一些关键文件和目录：

  • `/etc/nginx/nginx.conf`: 这是Nginx的主配置文件。它包含全局设置、事件模块设置以及HTTP模块的配置。通常，您会在这里找到`include`指令，用于引入其他配置片段。
  • `/etc/nginx/conf.d/`: 这个目录通常用于存放小的、独立的配置片段，例如特定的服务器块配置，这些文件会被`nginx.conf`中的`include /etc/nginx/conf.d/*.conf;`指令自动加载。
  • `/etc/nginx/sites-available/`: 这个目录用于存放您的所有网站（虚拟主机）的配置文件。这些文件可以被视为“可用”的配置模板，但它们本身并不会被Nginx加载。
  • `/etc/nginx/sites-enabled/`: 这个目录存放的是实际被Nginx加载并生效的网站配置文件。通常，这些文件是通过在`sites-available`目录下的文件创建软链接（symbolic link）到此目录来启用的。
  • `/var/log/nginx/`: Nginx的访问日志和错误日志默认存储在这个目录下。`access.log`记录所有访问请求，`error.log`记录服务器运行过程中遇到的错误。

3.5 配置你的第一个网站 (虚拟主机 / Server Block)

Nginx 使用“server blocks”（在Apache中称为虚拟主机）来定义和管理不同的网站。以下是如何创建一个简单的静态网站配置：

  1. 3.5.1 创建网站根目录

    为您的网站创建一个专用的目录来存放网页文件。通常，这些目录位于`/var/www/`下。假设您的域名是 `your_domain.com`。 

    sudo mkdir -p /var/www/your_domain.com/html

    设置目录所有者和权限： 

    sudo chown -R $USER:$USER /var/www/your_domain.com/html
sudo chmod -R 755 /var/www/your_domain.com

  2. 3.5.2 创建一个简单的 HTML 文件

    在刚才创建的网站根目录下创建一个 `index.html` 文件用于测试。 

    sudo nano /var/www/your_domain.com/html/index.html

    粘贴以下内容： 

    


    
    


    
    恭喜！您的 Nginx 网站已成功运行！
    
    
    这是您的第一个 Nginx Server Block 提供的页面。
    
    
    域名：your_domain.com

    保存并关闭文件 (Ctrl+X, Y, Enter)。

  3. 3.5.3 创建 Nginx Server Block 配置文件

    在 `sites-available` 目录中为您的网站创建一个新的配置文件。 

    sudo nano /etc/nginx/sites-available/your_domain.com

    粘贴以下配置内容，请将 `your_domain.com` 替换为您的实际域名： 

    server {
    listen 80;
    listen [::]:80;

    root /var/www/your_domain.com/html;
    index index.html index.htm index.nginx-debian.html;

    server_name your_domain.com www.your_domain.com;

    location / {
        try_files $uri $uri/ =404;
    }

    # 可选：如果您的网站有favicon.ico
    location = /favicon.ico {
        log_not_found off;
        access_log off;
    }

    # 可选：防止别人扫描你的.git, .svn等敏感目录
    location ~ /\. {
        deny all;
        access_log off;
        log_not_found off;
    }
}

    配置解释：

    • `listen 80;`: Nginx 监听 IPv4 的 80 端口（HTTP）。
    • `listen [::]:80;`: Nginx 监听 IPv6 的 80 端口。
    • `root /var/www/your_domain.com/html;`: 指定网站的根目录，Nginx 将从这里查找文件。
    • `index index.html index.htm index.nginx-debian.html;`: 定义当请求一个目录时，Nginx 优先查找的文件名。
    • `server_name your_domain.com www.your_domain.com;`: 定义这个Server Block 所服务的域名。当请求的 Host 头与此匹配时，该配置生效。
    • `location / { … }`: 这是一个位置块，定义了如何处理所有根目录下的请求。
    • `try_files $uri $uri/ =404;`: 这是 Nginx 处理请求文件路径的强大指令。它会尝试按顺序查找文件：
      • `$uri`: 尝试查找与请求URI完全匹配的文件。
      • `$uri/`: 如果`$uri`不是文件，尝试查找作为目录存在的`$uri`，并尝试目录下的`index`文件。
      • `=404`: 如果以上都找不到，则返回一个 404 Not Found 错误。

    保存并关闭文件。

  4. 3.5.4 启用 Server Block 并测试配置

    通过在 `sites-enabled` 目录中创建指向 `sites-available` 中配置文件的软链接来启用这个 Server Block： 

    sudo ln -s /etc/nginx/sites-available/your_domain.com /etc/nginx/sites-enabled/

    移除默认的Nginx配置文件，因为您现在有了自己的配置。 

    sudo rm /etc/nginx/sites-enabled/default

    在重新加载或重启Nginx之前，务必测试配置文件的语法是否正确： 

    sudo nginx -t

    如果输出显示 `syntax is ok` 和 `test is successful`，则表示配置无误。如果有错误，Nginx会指出错误所在的行数和原因，您需要回去修改。

  5. 3.5.5 重启 Nginx 服务

    应用新的配置： 

    sudo systemctl restart nginx

    现在，在您的浏览器中访问 `http://your_domain.com` (请确保您的域名已解析到服务器的IP地址)，您应该能看到您刚刚创建的`index.html`页面。

四、Nginx 常见应用场景与进阶配置

Nginx 远不止一个简单的Web服务器，它的多功能性使其在现代Web架构中扮演着核心角色。

4.1 反向代理 (Reverse Proxy)

Nginx最强大的功能之一是作为反向代理。这意味着它可以接收来自客户端的请求，然后将这些请求转发给后端服务器（如Node.js应用、Python Django/Flask应用、PHP-FPM等），并将后端服务器的响应返回给客户端。这对于隐藏后端服务器、提供负载均衡、以及处理SSL/TLS加密非常有用。

示例配置片段（Nginx作为PHP-FPM的反向代理）： 

server {
    listen 80;
    server_name your_php_app.com;
    root /var/www/your_php_app/public; # PHP应用的公共目录

    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 您的PHP-FPM版本对应的sock文件
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

在这个例子中，所有`.php`文件的请求都会被转发给PHP-FPM处理。

4.2 SSL/TLS 加密 (HTTPS)

为您的网站启用HTTPS是确保数据安全和建立用户信任的关键。Nginx可以很容易地配置SSL/TLS证书。通常，您会使用Certbot工具来自动化Let’s Encrypt免费SSL证书的获取和续期。

安装Certbot并为Nginx获取证书的典型命令如下： 

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your_domain.com -d www.your_domain.com

Certbot会自动修改您的Nginx配置文件，添加SSL/TLS相关的配置，并将HTTP请求重定向到HTTPS。

4.3 负载均衡 (Load Balancing)

当您的网站流量很大，单个后端服务器无法处理时，Nginx可以作为负载均衡器，将请求分发到多个后端服务器上，从而提高网站的可用性和可伸缩性。

示例配置片段： 

upstream backend_servers {
    server 192.168.1.101:8000;
    server 192.168.1.102:8000;
    # 可以添加更多服务器
    # fair; # 根据响应时间进行负载均衡
    # ip_hash; # 根据客户端IP进行负载均衡
}

server {
    listen 80;
    server_name your_load_balanced_app.com;

    location / {
        proxy_pass http://backend_servers; # 请求转发到上游定义的服务器组
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Nginx支持多种负载均衡算法，如轮询（默认）、加权轮询、ip_hash、least_conn等。

4.4 静态文件服务优化

Nginx在服务静态文件方面表现出色。您可以对其进行优化，例如启用浏览器缓存、文件压缩等。

示例配置片段（通常放在`http`块或`server`块内）： 

# 开启 gzip 压缩
gzip on;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_buffers 16 8k;
gzip_http_version 1.1;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

# 设置静态文件缓存头（例如图片、CSS、JS）
location ~* \.(jpg|jpeg|gif|png|ico|css|js|woff|woff2|ttf|eot|svg)$ {
    expires 30d; # 缓存30天
    access_log off;
    log_not_found off;
    add_header Cache-Control "public";
}

五、Nginx 故障排除与调试

在Nginx配置或运行过程中，可能会遇到各种问题。了解如何诊断和解决这些问题至关重要。

5.1 检查 Nginx 服务状态

这是诊断Nginx问题的第一步。 

systemctl status nginx

查看输出信息，特别是`Active:`行。如果不是`active (running)`，请检查是否有错误信息或建议。

5.2 测试 Nginx 配置语法

在每次修改配置文件后，务必运行此命令，它会在不重启服务的情况下检查配置文件的语法错误。 

sudo nginx -t

如果输出显示`syntax is ok`和`test is successful`，则配置无误。否则，它会精确指出错误位置，您需要根据提示进行修正。

5.3 查看 Nginx 错误日志

Nginx会将运行时错误和警告记录在错误日志中，这是解决问题的宝库。 

sudo tail -f /var/log/nginx/error.log

使用`tail -f`可以实时查看日志更新。当您尝试访问出现问题的网站时，查看此日志，通常能找到问题的原因，例如文件找不到、权限问题、上游服务器连接失败等。

同时，也可以查看访问日志 `access.log` 来了解客户端请求的情况： 

sudo tail -f /var/log/nginx/access.log

5.4 防火墙问题排查

如果您的网站无法访问，但Nginx服务状态正常且配置无误，那么很可能是防火墙阻止了流量。 

sudo ufw status verbose

检查80端口和443端口是否被允许。如果没有，请参考前面的防火墙设置部分进行配置。

5.5 文件权限问题

确保Nginx进程（通常是`www-data`用户）对网站根目录及其内容具有读取权限。 

sudo ls -ld /var/www/your_domain.com/html
sudo ls -l /var/www/your_domain.com/html/index.html

如果权限不正确，可以使用`chown`和`chmod`命令进行修正。

六、资源消耗与性能考量

关于“多少”，我们主要关注Nginx的资源消耗和性能表现。

  • 资源消耗： Nginx以其极低的资源消耗而闻名。即使在处理大量并发连接时，它的内存占用也相对较小，CPU使用率也表现出色。这使得Nginx非常适合部署在资源有限的VPS（虚拟专用服务器）或容器环境中。对于静态文件服务，Nginx的效率更是无人能及。
  • 性能表现： Nginx的异步非阻塞事件驱动架构是其高性能的根本。它能够有效地处理“C10K问题”（即一台服务器处理1万个并发连接），甚至更高。在作为Web服务器时，它的响应速度快；作为反向代理和负载均衡器时，其开销也很低，几乎不会成为性能瓶颈。
  • 可伸缩性： Nginx本身非常容易水平扩展。通过在多个服务器上运行Nginx并结合DNS轮询或更高级的负载均衡器，可以轻松应对不断增长的流量需求。
  • 成本考量： Nginx是开源免费的软件，这意味着您不需要支付任何软件许可费用。所有成本将仅限于服务器硬件、网络带宽以及可能的专业支持服务。

总结

在Ubuntu上安装和配置Nginx是一个相对直接但功能强大的过程。从基础的Web服务到复杂的反向代理、负载均衡和SSL加密，Nginx都提供了高效、灵活的解决方案。通过本文的详细指导，您应该能够成功地在您的Ubuntu服务器上部署Nginx，并开始提供强大的Web服务。记住，熟练掌握Nginx的配置文件结构、服务管理命令以及故障排除技巧是成为一名高效Nginx管理员的关键。随着您的需求增长，您会发现Nginx能够轻松适应并支持您的Web应用架构的演进。

ubuntu安装nginx