安装 Nginx 并准备独立实验目录

在 Ubuntu 中安装 Nginx,准备独立的网页和配置目录,避免混淆系统服务与学习实例。

🎯 引言

第一步不是改系统配置,而是准备一个自己能管理的实验目录。本篇完成软件安装、目录创建和网页准备,下一篇再编写让它运行的配置。


🧰 安装所需工具

在 Ubuntu 的终端中,一行一行执行下面的命令。命令前不需要输入 $:

sudo apt update
sudo apt install nginx curl vim openssl
nginx -v

apt 是 Ubuntu 安装软件的工具;update 更新可用软件列表;install 安装软件。sudo 表示以管理员权限执行,输入密码时通常不显示字符。nginx -v 输出安装版本,记录实际结果即可,不需要为了对齐补丁号降级。

curl 用来发请求,vim 用来在终端编辑文本,openssl 在 HTTPS 章节用于生成实验用证书。

软件源与命令行交互提示可能随系统版本更新,安装时以当前提示为准。本课程命令面向 Ubuntu 24.04,其他系统请先核对对应安装文档。

安装包可能自动启动一个系统 Nginx,使用 /etc/nginx/nginx.conf 和端口 80。本课程另开独立实例,使用用户目录与 8080,不要把系统服务的启动结果当成课程实验结果。Ubuntu 安装行为可参考官方安装说明。


🛠 创建目录与第一份网页

$HOME 是当前用户的个人目录。mkdir -p 创建目录,路径中的 / 表示下一层:

mkdir -p "$HOME/nginx-course/conf/servers"
mkdir -p "$HOME/nginx-course/html/assets"
mkdir -p "$HOME/nginx-course/logs"
mkdir -p "$HOME/nginx-course/temp/client"
mkdir -p "$HOME/nginx-course/temp/proxy"
mkdir -p "$HOME/nginx-course/temp/fastcgi" "$HOME/nginx-course/temp/uwsgi" "$HOME/nginx-course/temp/scgi"
vim "$HOME/nginx-course/html/index.html"

最后一行用 Vim 打开文件。如果文件还没创建,Vim 会打开一个空白编辑区。刚打开时处于普通模式,按键用于操作文本。按小写 i 进入插入模式,就可以输入或粘贴下面的内容。

html/index.html
<!doctype html>
<html lang="zh-CN">
    <head>
        <meta charset="UTF-8">
        <title>学习笔记站</title>
    </head>
    <body>
        <h1>我的学习笔记</h1>
        <p>这是通过 Nginx 访问的第一份网页。</p>
    </body>
</html>

粘贴后按 Esc 回到普通模式,输入 :wq(包含开头的冒号),再按 Mac 键盘上的 ↩ Return(其他键盘上的 Enter)。w 表示写入文件,q 表示退出,执行成功后会回到终端。后续用 Vim 编辑其他文件时,也用这套步骤保存并退出。

如果打开文件后想放弃本次改动,按 Esc,输入 :q! 并按 ↩ Return,Vim 会退出并丢弃尚未保存的修改。我们将这份网页命名为 index.html,供下一篇配置为目录首页。

目录用途
conf存放配置,servers 中拆分各个站点
html允许浏览器读取的公开网页
logs存放运行记录和实例进程编号
temp临时存放请求体、代理响应等数据

不要把密码、证书私钥和配置文件放进 html,因为这个目录稍后将允许通过 HTTP 访问。


🧱 给实验实例起一个命令名

反复输入长路径容易出错。将下面的 Bash 函数整体粘贴进当前终端:

ngx() {
    nginx -e stderr -p "$HOME/nginx-course/" -c conf/nginx.conf "$@"
}

函数把 ngx 作为命令简称。-p 指定本实例的路径前缀,-c 指定配置文件,-e stderr 让读取配置前的报错也能显示在终端;"$@" 会把你追加的参数原样传给 Nginx。选项含义见官方命令参数。

以后出现 ngx,都指这个函数。新开终端后先重新定义它。 它此时还不能启动,因为下一篇才创建 conf/nginx.conf。

实验期间用普通用户执行 ngx。不要一会儿加 sudo,一会儿不加,否则日志和进程文件可能变成当前用户无法写入的文件。


❓ 知识问答

Q1:出现 nginx: command not found 怎么办?

说明当前终端找不到 Nginx 程序。先确认是在安装过软件的 Ubuntu 内操作,再检查安装命令是否成功。

Q2:在浏览器访问 localhost 看到了欢迎页,说明准备成功了吗?

这很可能是系统实例的 80 端口。课程实例的验收地址会明确写为 http://127.0.0.1:8080。


🧪 小练习

执行下面的命令,确认文件确实存在且内容正确:

cat "$HOME/nginx-course/html/index.html"

cat 会输出文件内容。应能看到“我的学习笔记”和完整的 HTML 标签;如果提示不存在,先检查保存路径,再进入下一篇。


🎉 实验环境已经准备好,接下来让 Nginx 读懂你的配置!