温馨提示×

如何在debian编译nginx

小樊
45
2026-10-09 11:22:19
栏目: 智能运维

在 Debian 上编译 Nginx 一般包括安装依赖 → 下载源码 → 配置 → 编译 → 安装 → 运行这几个步骤。下面给你一个实用、可复现的流程(以 Nginx 稳定版为例)。


一、安装编译依赖

sudo apt update
sudo apt install -y \
  build-essential \
  libpcre3-dev \
  zlib1g-dev \
  libssl-dev \
  wget \
  curl

说明:

  • build-essential:gcc、make 等
  • pcre:Nginx 正则支持
  • zlib:压缩支持
  • openssl:HTTPS 支持

二、下载 Nginx 源码

去官网查看最新稳定版:https://nginx.org/en/download.html

示例(以 1.26.2 为例):

cd /usr/local/src
sudo wget https://nginx.org/download/nginx-1.26.2.tar.gz
sudo tar -zxvf nginx-1.26.2.tar.gz
cd nginx-1.26.2

三、配置编译参数

最常用配置(推荐)

./configure \
  --prefix=/usr/local/nginx \
  --with-http_ssl_module \
  --with-http_stub_status_module \
  --with-http_gzip_static_module \
  --with-stream

常用模块说明:

  • http_ssl_module:HTTPS
  • stub_status:状态监控
  • gzip_static:静态压缩
  • stream:四层代理(TCP/UDP)

四、编译并安装

make
sudo make install

安装完成后:

/usr/local/nginx/sbin/nginx -v

五、启动 Nginx

sudo /usr/local/nginx/sbin/nginx

测试:

curl http://localhost

停止:

sudo /usr/local/nginx/sbin/nginx -s stop

六、(推荐)配置 systemd 服务

创建文件:

sudo vim /etc/systemd/system/nginx.service

内容:

[Unit]
Description=nginx
After=network.target

[Service]
Type=forking
ExecStart=/usr/local/nginx/sbin/nginx
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s quit
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用:

sudo systemctl daemon-reload
sudo systemctl enable nginx
sudo systemctl start nginx

七、常见问题

1. 端口被占用

sudo ss -lntp | grep 80

2. 想加第三方模块

例如 echo-nginx-module:

--add-module=/path/to/echo-nginx-module

3. 和 apt 安装的 Nginx 冲突

建议:

  • 源码版用 /usr/local/nginx
  • 不要同时 apt install nginx

如果你告诉我:

  • 是否需要 HTTP/3 / QUIC
  • 是否要 Lua / Brotli / RTMP
  • Debian 版本(11 / 12)

我可以给你定制编译参数。

0 踩