Nginx 基础配置实例

Nginx 基础配置实例

引言

学习了核心配置文件的内容,也仅仅是学习,没有实际例子来巩固的知识容易流失,本内容带你写一个简单的 demo 实例。

每次开机都手动启动 Nginx 服务?每次使用 Nginx 的指令总是要进入 sbin 目录下?本文带你配置 Naginx 服务自启和全局 nginx 指令。

基础配置实例

前面我们已经对 Nginx 服务器默认配置文件的结构和涉及的基本指令做了详细的阐述。通过这些指令的合理配置,我们就可以让一台 Nginx 服务器正常工作,并且提供基本的 Web 服务器功能。

接下来我们将通过一个比较完整和最简单的基础配置实例,来巩固下前面所学习的指令及其配置。

需求

  • 有如下访问:

    http://192.168.199.27:8081/server1/location1 访问的是:index_sr1_location1.html http://192.168.199.27:8081/server1/location2 访问的是:index_sr1_location2.html http://192.168.199.27:8082/server2/location1 访问的是:index_sr2_location1.html http://192.168.199.27:8082/server2/location2 访问的是:index_sr2_location2.html

  • 如果访问的资源不存在,返回自定义的 404 页面

  • 将 /server1 和 /server2 的配置使用不同的配置文件分割,将两个文件文件放到 /home/www/conf.d 目录下,然后在 Nginx 的配置文件使用 include 合并两个文件

  • 为 /server1 和 /server2 各自创建一个访问日志文件

实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 创建 404 页面
touch /home/www/404.html

# 创建 conf.d 目录
mkdir /home/www/conf

# 创建两个配置文件
touch /home/www/conf/server1.conf
touch /home/www/conf/server2.conf

# 创建 myweb 目录
mkdir /home/www/myweb

# 创建 server1 目录和其子目录以及 index.html 文件
mkdir -p /home/www/myweb/server1/location1
mkdir -p /home/www/myweb/server1/location2

touch /home/www/myweb/server1/location1/index.html
touch /home/www/myweb/server1/location2/index.html

# 创建日志目录和日志文件
mkdir -p /home/www/myweb/server1/logs
touch /home/www/myweb/server1/logs/access.log

# 创建 server2 目录和其子目录以及 index.html 文件
# 和创建 server1 步骤一样,把 1 改为 2 即可

准备相关文件,/homw/www 目录如下:

image

因为 Nginx 自带配置文件的备份,即 nginx.conf.default,所以我们可以直接修改配置文件,但是如果你的配置文件曾经修改过,那么请进行备份。

1
cp /usr/local/nginx/conf/nginx.conf /usr/local/nginx/conf/nginx.conf.backup

备份后,进入 /usr/local/nginx/conf/nginx.conf 配置文件

1
vim /usr/local/nginx/conf/nginx.conf

先清空文件,然后添加如下内容:

1
cache-lifetime="5" :options="{ useUrlFragment: false }"

有注释版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
user www; # 配置允许运行 Nginx 工作进程的用户和用户组
worker_processes 2; # 配置运行 Nginx 进程生成的 worker 进程数
error_log logs/error.log; # 配置 Nginx 服务器运行对错误日志存放的路径
pid logs/nginx.pid; # 配置 Nginx 服务器允许时记录 Nginx 的 master 进程的 PID 文件路径和名称
daemon on; # 配置 Nginx 服务是否以守护进程方法启动

events{
accept_mutex on; # 设置 Nginx 网络连接序列化,解决惊群
multi_accept on; # 设置 Nginx 的 worker 进程是否可以同时接收多个请求
worker_connections 1024; # 设置 Nginx 的 worker 进程最大的连接数
use epoll; # 设置 Nginx 使用的事件驱动模型
}

http{

include mime.types; # 定义 MIME-Type
default_type application/octet-stream;
sendfile on; # 配置允许使用 sendfile 方式运输
keepalive_timeout 65; # 配置连接超时时间

# 配置请求处理日志格式
log_format server1 '===>server1 access log';
log_format server2 '===>server2 access log';

include /home/www/conf/*.conf; # 引用其他 conf 文件
}

无注释版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
user www;
worker_processes 2;
error_log logs/error.log;
pid logs/nginx.pid;
daemon on;

events{
accept_mutex on;
multi_accept on;
worker_connections 1024;
use epoll;
}

http{

include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;


log_format server1 '===>this is server1 access log';
log_format server2 '===>this is server2 access log';

include /home/www/conf/*.conf;
}

第 25 行代码使用 include 将 service1 和service2 的配置文件进行引用。以后无需修改主配置文件,只需要引入子配置文件即可,主配置文件作为默认值,子配置文件的内容会覆盖和主配置文件相同的内容。

进入 server1.conf 文件

1
vim /home/www/conf/server1.conf

server1.conf 文件内容:

1
cache-lifetime="5" :options="{ useUrlFragment: false }"

有注释版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
server{
listen 8081; # 配置监听端口和主机名称
server_name localhost;
access_log /home/www/myweb/server1/logs/access.log server1; # 配置请求处理日志存放路径
error_page 404 /404.html; # 配置错误页面

location /server1/location1{ # 配置处理 /server1/location1 请求的 location
root /home/www/myweb;
index index.html; # 这是 server1 下的 location1 的 index.html
}

location /server1/location2{ # 配置处理 /server1/location2 请求的 location
root /home/www/myweb;
index index.html; # 这是 server1 下的 location2 的 index.html
}

location = /404.html { # 配置错误页面转向
root /home/www;
index 404.html;
}
}

无注释版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
server{
listen 8081;
server_name localhost;
access_log /home/www/myweb/server1/logs/access.log server1;
error_page 404 /404.html;

location /server1/location1{
root /home/www/myweb;
index index.html;
}

location /server1/location2{
root /home/www/myweb;
index index.html;
}

location = /404.html {
root /home/www;
index 404.html;
}
}

server2.conf 文件内容:

1
cache-lifetime="5" :options="{ useUrlFragment: false }"

有注释版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
server{
listen 8082; # 配置监听端口和主机名称
server_name localhost;
access_log /home/www/myweb/server2/logs/access.log server2; # 配置请求处理日志存放路径
error_page 404 /404.html; # 配置错误页面,对404.html做了定向配置

location /server2/location1{ # 配置处理 /server1/location1 请求的 location
root /home/www/myweb;
index index.html; # 这是 server2 下的 location1 的 index.html
}

location /server2/location2{ # 配置处理 /server2/location2 请求的 location
root /home/www/myweb;
index index.html; # 这是 server2 下的 location2 的 index.html
}

location = /404.html { # 配置错误页面转向
root /home/www;
index 404.html;
}
}

无注解版

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
server{
listen 8082;
server_name localhost;
access_log /home/www/myweb/server2/logs/access.log server2;
error_page 404 /404.html;

location /server2/location1{
root /home/www/myweb;
index index.html;
}

location /server2/location2{
root /home/www/myweb;
index index.html;
}

location = /404.html {
root /home/www;
index 404.html;
}
}

server1下面的location1下面的index.html的内容

1
2
3
4
5
6
7
8
9
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<h1>server1下面的loaction1下面的index.html</h1>
</body>
</html>

其他的三个页面把数字改了就可以

404.html内容;

1
2
3
4
5
6
7
8
9
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<h1>不好意思,程序小哥正在加紧维修中 ...... </h1>
</body>
</html>

重启 Nginx ,使得配置文件生效

1
nginx -s reload

测试

如果没有关闭防火墙,记得开放 8081 和 8082 端口。

1
2
3
4
5
6
# 开放 8081 和 8082 端口
firewall-cmd --zone=public --add-port=8081/tcp --permanent
firewall-cmd --zone=public --add-port=8082/tcp --permanent

# 重启防火墙
firewall-cmd --reload

打开浏览器分别访问,效果如图所示:

8081 的 server1 的 location1:

image

8081 的 server1 的 location2:

image

8082 的 server2 的 location1:

image

8082 的 server2 的 location2:

image

如果访问一个不存在的 404 请求:

image

日志也会打印,这里演示一个:

1
2
3
4
5
6
7
8
9
10
11
[root@master www]# tail /home/www/myweb/server1/logs/access.log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log
===>this is server1 access log

操作的问题

经过前面的操作,我们会发现,如果想要启动、关闭或重新加载 Nginx 配置文件,都需要先进入到 Nginx 的安装目录的 sbin 目录,然后使用 Nginx 的二级制可执行文件 nginx 来操作,相对来说操作比较繁琐,这块该如何优化?另外如果我们想把 Nginx 设置成随着服务器启动就自动完成启动操作,又该如何来实现?

这就需要用到接下来我们要讲解的两个知识点:

  • Nginx 服务启停配置
  • Nginx 全局命令配置

服务启停配置

把 Nginx 应用服务设置成为系统服务,方便对 Nginx 服务的启动和停止等相关操作,具体实现步骤:

  • /usr/lib/systemd/system 目录下创建 nginx.service 文件
1
vim /usr/lib/systemd/system/nginx.service

文件添加如下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[Unit]
Description=nginx web service
Documentation=http://nginx.org/en/docs/
After=network.target

[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pid
ExecStartPre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf
ExecStart=/usr/local/nginx/sbin/nginx
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s stop
PrivateTmp=true

[Install]
WantedBy=default.target

注意:可执行文件 nginx 根据自己的路径进行修改,以及 .conf 配置文件和 .pid 文件的路径。这份内容是基于默认安装目录的。

  • 添加完成后,如果权限有问题需要进行权限设置,没有则忽略这一步
1
chmod 755 /usr/lib/systemd/system/nginx.service
  • 使用系统命令来操作 Nginx 服务
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 启动 Nginx
systemctl start nginx

# 停止 Nginx
systemctl stop nginx

# 重启 Nginx
systemctl restart nginx

# 重新加载配置文件
systemctl reload nginx

# 查看 Nginx 状态
systemctl status nginx

# 开机启动
systemctl enable nginx

# 关闭开启启动
systemctl disable nginx

全局命令配置

前面我们介绍过 Nginx 安装目录下的二级制可执行文件 nginx 的很多命令,要想使用这些命令前提是需要进入 sbin 目录下才能使用,很不方便,如何去优化,我们可以将该二进制可执行文件加入到系统的环境变量,这样的话在任何目录都可以使用 nginx 对应的相关命令。具体实现步骤如下:

方法一:

  • 修改 /etc/profile 文件
1
2
3
4
vim /etc/profile

# 在最后一行添加
export PATH=$PATH:/usr/local/nginx/sbin

可执行文件 nginx 的路径根据自己的路径修改,这里是默认路径。

  • 使之立即生效
1
source /etc/profile
  • 任意位置执行 nginx 命令,测试成功
1
2
[root@master ~]# nginx -v
nginx version: nginx/1.21.6

方法二:

  • 将可执行文件 nginx 拷贝一份到 /usr/bin 目录下
1
cp /usr/local/nginx/sbin/nginx /usr/bin
  • 任意位置执行 nginx 命令,测试成功
1
2
[root@master ~]# nginx -v
nginx version: nginx/1.21.6
文章作者: GeYu
文章链接: https://nuistgy.github.io/2022/11/10/Nginx_Basic_case_configuration/
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 Yu's Blog