@[TOC](Ubuntu系统编译安装 Nginx 教程)

---

# Ubuntu 系统编译安装 Nginx 教程

## 一、准备工作

### 1.Nginx介绍


Nginx 是一款高性能、轻量级的开源 Web 服务器和反向代理服务器，以其高并发处理能力和低内存消耗著称。它不仅支持 HTTP、HTTPS、SMTP、POP3 等协议，还可作为负载均衡器和 HTTP 缓存服务器使用。凭借模块化架构和丰富的第三方模块生态，Nginx 广泛应用于现代 Web 架构中。
### 2. 当前系统


- 当前实践系统为Ubuntu 22.04.1 LTS

```bash
root@wangge:~# cat /etc/os-release
PRETTY_NAME="Ubuntu 22.04.1 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.1 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=jammy
```

### 3. 更新系统

- 可更新系统软件包

```bash
apt update &&  apt upgrade -y
```

### 4. 安装编译依赖

- 安装编译依赖：
```bash
apt install -y build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev git wget
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/efd5a5ef4541d29d892321072a7b312b.png)



## 二、下载 Nginx 源码

### 1. 访问官网获取下载链接
前往 [Nginx 官网](http://nginx.org/en/download.html)，复制稳定版（Stable）或主线版（Mainline）的源码包链接。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/26da677860b5a7ca543cbc9e69af0864.png)

### 2. 下载并解压

- 执行以下命令，下载并解压Nginx软件包。
```bash
wget http://nginx.org/download/nginx-1.25.3.tar.gz
tar -zxvf nginx-1.25.3.tar.gz
cd nginx-1.25.3
```



## 三、配置编译选项

### 1. 基础配置

- 执行以下命令，进行编译前的基础配置。

```bash
./configure \
--prefix=/usr/local/nginx \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--pid-path=/var/run/nginx.pid \
--lock-path=/var/run/nginx.lock \
--with-http_ssl_module \
--with-http_v2_module \
--with-http_realip_module \
--with-threads \
--with-http_stub_status_module
```

- 常用可选模块

```bash
- `--with-http_gzip_static_module`：启用 Gzip 静态压缩
- `--with-stream`：启用 TCP/UDP 代理
- `--add-module=/path/to/custom-module`：添加第三方模块
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/b72f97fbb31eda8819c23ebf4df55a41.png)



## 四、编译与安装

### 1. 编译源码
```bash
make -j$(nproc)  # 使用全部 CPU 核心加速编译
```


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/63db8ff2a37e5b024ac357c69e834e3f.png)


### 2. 安装到系统
```bash
make install
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/3629a704b53501e7a79e0595ee5967eb.png)

## 五、验证安装

### 1. 检查版本

- 检查安装后的Nginx版本
```bash
nginx -v
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/d53cb45ed2da3db4a6976509ee98d835.png)


### 2. 启动 Nginx

-  启动 Nginx：
```bash
nginx
```

### 3. 验证服务状态
```bash
curl -I 127.0.0.1
```
若返回 `HTTP/1.1 200 OK` 则说明安装成功。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/e0a95418368d3caab66dd8b55eb57669.png)


## 六、配置系统服务

### 1. 创建 systemd 服务文件
```bash
vim  /etc/systemd/system/nginx.service
```

### 2. 写入以下内容
```ini
[Unit]
Description=The NGINX HTTP and reverse proxy server
After=network.target

[Service]
Type=forking
ExecStartPre=/usr/sbin/nginx -t
ExecStart=/usr/sbin/nginx
ExecReload=/usr/sbin/nginx -s reload
ExecStop=/usr/sbin/nginx -s quit
TimeoutStopSec=5
KillMode=mixed

[Install]
WantedBy=multi-user.target
```

### 3. 启用服务
```bash
systemctl daemon-reload
systemctl enable nginx
systemctl start nginx
```

---

## 七、防火墙配置（可选）
```bash
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
```

---

## 八、卸载方法
```bash
sudo systemctl stop nginx
sudo rm -rf /usr/local/nginx /etc/nginx /usr/sbin/nginx
sudo rm /etc/systemd/system/nginx.service
sudo systemctl daemon-reload
```

---

## 九、常见问题

### 1. 端口冲突
若遇到 `80端口被占用`，停止 Apache 或其他服务：
```bash
sudo systemctl stop apache2
```

### 2. 模块缺失错误
重新运行 `./configure` 并添加所需模块，然后重新编译。

---



## 十、总结


>通过本次编译安装 Nginx 的实践，不仅掌握了从源码构建软件的完整流程，还深入理解了 Nginx 的模块化配置与系统集成方式。相比直接使用包管理器安装，源码编译提供了更高的灵活性和定制能力，适用于生产环境的特定需求。建议在实际部署前充分测试配置，并做好服务管理和安全加固。

Nginx 是一款高性能、轻量级的开源 Web 服务器和反向代理服务器，以其高并发处理能力和低内存消耗著称。它不仅支持 HTTP、HTTPS、SMTP、POP3 等协议，还可作为负载均衡器和 HTTP 缓存服务器使用。凭借模块化架构和丰富的第三方模块生态，Nginx 广泛应用于现代 Web 架构中。

Ubuntu系统编译安装 Nginx 教程

操作系统

网络与通信

后端

Ubuntu系统编译安装Nginx详细教程，包含准备工作、源码下载、编译配置、安装验证及系统服务集成。适用于Ubuntu 22.04 LTS，指导用户从源码构建高性能Nginx服务器，支持HTTP/2、SSL等模块，提供防火墙配置和常见问题解决方案。

负载均衡

包管理器

服务器

防火墙

Ubuntu

4核4G3M云服务器 新用户低至38元/年！

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Ubuntu系统编译安装 Nginx 教程-腾讯云开发者社区-腾讯云

Ubuntu系统编译安装 Nginx 教程

Ubuntu系统编译安装 Nginx 教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐