Ubuntu 26.04 Nginx 站点配置:启用文件、Host 路由与默认响应
管理 Ubuntu 的 Nginx 站点时,先确认实际 include 配置,再通过 sites-enabled 启用 sites-available 中的站点文件。本实验把两个站点绑定在 127.0.0.1:8080,在服务器本机验证不同 Host 的响应。
仅限本机的是新建的 8080 实验站点,不是整台服务器。Ubuntu 安装 Nginx 时可能启动默认站点;安装前先确认管理连接保留与 UFW 过滤范围,或使用与外部网络隔离的专用虚拟机。
安装并检查已有配置
sudo apt update
sudo apt install nginx curl
sudo nginx -t
sudo nginx -T
sudo ss -lntp
在专用虚拟机中逐条执行,检查每一步结果;发现其他 Web 服务占用端口时,不强行终止它。nginx -t 检查配置,nginx -T 还输出配置内容。查看实际启用的 include、listen、server_name 与默认 server;完整输出可能含敏感地址或认证信息,不应公开粘贴。
sites-available 用于保存候选配置,sites-enabled 中的文件或链接只有被实际 include 时才会生效。目录命名是 Ubuntu 软件包的常见组织方式,不应假定所有安装都一样。Ubuntu 的 Nginx 配置指南说明了 server 块、文档根目录和默认站点之间的关系。
检查默认端口 80 的对外范围
sudo ss -lntp
sudo ufw status verbose
ls -l /etc/nginx/sites-enabled
sudo nginx -T
0.0.0.0:80 或 [::]:80 监听与 127.0.0.1:8080 不同。如果 UFW 未激活或已广泛放行端口 80,其他设备可能访问默认站点。先检查实际监听和各层过滤,再分别测试本机、获准客户端及被排除客户端的新连接;监听存在本身不等于公网可达。
只有在新的专用虚拟机且无需软件包默认站点时,才运行下面整个块,保存后移除它的符号链接。不要用于现有生产站点。链接类型、解析目标或备份结果不符合预期时停止,不自行替换其他文件。
(
set -eu
link=/etc/nginx/sites-enabled/default
if [ ! -L "$link" ] || [ "$(readlink -f "$link")" != /etc/nginx/sites-available/default ]; then
printf 'Not the expected package-default symlink; inspect manually.\n' >&2
exit 1
fi
backup_dir=$(sudo mktemp -d /root/nginx-default-link.XXXXXX)
sudo cp -a "$link" "$backup_dir/default"
printf 'Preserved link: %s/default\n' "$backup_dir"
sudo rm -- "$link"
sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp
)
原始 sites-available/default 会保留。如果端口 80 仍在监听,应调查其他站点或进程。注意移除链接之后的语法检查若失败,磁盘配置已改变而运行中的旧配置可能仍在;先修复或按备份恢复,不把失败当成卸载完成。
恢复时,使用打印的备份链接,先确认原位置没有后续编辑,再放回原路径;通过 nginx -t 后才重新加载。不要覆盖其他管理员的新变更。Ubuntu 的 Nginx 安装指南说明安装会启动服务,因此默认站点的暴露范围应提前检查。
准备不同的文档根目录
以下目录、index.html 和后续配置名都必须是本次专用的新路径。已有文件时保留内容并重新规划名称,不能直接执行 tee 覆盖。两个文档根目录分别返回不同文字,方便判断命中了哪个站点。
sudo install -d -m 0755 /srv/ubuntu-course-alpha /srv/ubuntu-course-beta
printf '%s\n' 'alpha-site' | sudo tee /srv/ubuntu-course-alpha/index.html
printf '%s\n' 'beta-site' | sudo tee /srv/ubuntu-course-beta/index.html
Web 服务用户需要读取文件及遍历父目录,不需要所有用户都能写入。创建后核对 index.html 的实际读取权限;umask 可能影响新文件模式。若本次新建文件不能被服务读取,可只对这两个已确认的练习 index.html 设置 0644,例如 sudo chmod 0644 /srv/ubuntu-course-alpha/index.html /srv/ubuntu-course-beta/index.html,不要对已有站点递归放宽权限。
保存完整的本机 server 配置
将下面完整配置保存到新的 /etc/nginx/sites-available/ubuntu-course-lab 文件。alpha.example.test 和 beta.example.test 是本地实验名称,不是本次公开 DNS 或证书签发的域名。原有端口 80 站点按上一节的决定单独管理;8080 的新增配置并不会替你关闭它。
server {
listen 127.0.0.1:8080 default_server;
server_name _;
return 404;
}
server {
listen 127.0.0.1:8080;
server_name alpha.example.test;
root /srv/ubuntu-course-alpha;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
server {
listen 127.0.0.1:8080;
server_name beta.example.test;
root /srv/ubuntu-course-beta;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
Nginx 先根据监听地址和端口选择候选 server,再比较 HTTP 请求的 Host(主机名)字段。这里未知 Host 会进入 default_server 块并返回 404;server_name _ 中的下划线本身不是特殊的拒绝开关。默认 server 属于对应的监听地址与端口,不能在同一位置重复定义。原理见 Nginx 官方请求处理说明。
两个具名站点使用不同 root 和相同的 index.html 查找规则。try_files 按当前文档根目录检查请求路径及目录,找不到时返回 404;修改 root 后还要验证实际文件和访问权限,不能只看主机名。
启用配置,通过检查后重新加载
(
set -eu
sudo ln -s /etc/nginx/sites-available/ubuntu-course-lab /etc/nginx/sites-enabled/ubuntu-course-lab
sudo nginx -t
sudo systemctl reload nginx
)
符号链接已经存在时,先检查目标,不用强制覆盖选项。nginx -t 失败时,此块不会继续 reload;根据报错文件、行号及监听冲突修复。此时新链接可能已经留在磁盘上,要先处理它,再测试配置。语法检查成功也不能保证所有请求都能读到正确文件。
分别验证主机名、正文与默认响应
以下请求在服务器本机运行。本地实验为避免代理环境把 .test 请求转发到别处,逐条显式使用 --noproxy '*';这只作用于当前 curl 调用。两个具名请求通过 --resolve 指定该名称和端口的连接地址。
curl --noproxy '*' --fail --show-error --resolve alpha.example.test:8080:127.0.0.1 http://alpha.example.test:8080/
curl --noproxy '*' --fail --show-error --resolve beta.example.test:8080:127.0.0.1 http://beta.example.test:8080/
curl --noproxy '*' -i -H "Host: unknown.example.test" http://127.0.0.1:8080/
前两次分别应输出 alpha-site 和 beta-site;最后一次响应头应为 404。最后一条没有 --fail,因此 curl 正常收到 HTTP 404 时仍可能返回零,必须阅读 HTTP 状态。前两次也要检查正文,不能只看命令退出成功。
--resolve 不修改系统 DNS 或 hosts 文件,仅给当前调用提供名称与地址映射。相关选项见 curl 官方手册。出现错误响应时,对照实际 include、重复 server_name、请求端口、文档根目录、文件权限与日志。
停用实验时,只移除本次 sites-enabled 的 ubuntu-course-lab 链接;通过配置检查后再重新加载,并重新测试响应。保留原始站点文件和其他站点配置。实际互联网部署还需单独准备域名、地址、防火墙、HTTPS 证书与续期及日志策略。




