跳到正文
零到全栈 · 卷 1 · 电脑与命令行直觉

让世界看到你的文件

本合集目录
本章目录

单册说明:本文件是卷 1 的第 6 章,可独立阅读。前置:第 5 章(云服务器与 SSH)。本章把 index.html 放进 Nginx 的目录,让任何人用你的公网 IP 都能打开它。

项 内容
所属卷 卷 1 · 电脑与命令行直觉(第 6 / 6 章)
前置章节 1.5 租一台云服务器
本章产出 一个公网可访问的首页(http://你的公网IP/),以及一份 403/404/超时的排查顺序
对应代码 index.html、/etc/nginx/sites-available/dudao(见 1.6.3)
配图 无(后续统一制图)
读完的判定 在你自己的电脑上 curl -I http://你的公网IP/ 返回 HTTP/1.1 200 OK

1.6.1 一句话结论:公网能打开一个文件,要同时满足四个条件

条件 不满足时的表现 先查什么
文件在 root 指向的目录里 404 Not Found Nginx 配置里的 root 与实际路径
Nginx 进程读得到这个文件 403 Forbidden 目录与文件的权限、每一级父目录
配置已经加载 还是默认页 / 还是旧内容 sites-enabled、nginx -T、有没有 reload
80 端口从外部可达 连接超时 云安全组、本机 ufw

四个条件对应四种完全不同的现象。所以"打不开"这三个字没有信息量,必须先看是哪一种。

真实翻车:你按记忆配好了站点,浏览器打开公网 IP,得到一个白底黑字的 403 Forbidden。你去改 index.html 的内容,改了三遍,还是 403。因为 403 从来不是"文件内容不对",是"不许读"。

1.6.2 原理与方法

① Nginx 收到一个请求,做了四件事

以 GET / 为例:

  1. 找到匹配的 server 块(按 listen 端口和 server_name)。
  2. 把 root 和请求路径拼起来:/var/www/dudao + /。
  3. 路径以 / 结尾,于是找 index 指令列出的文件:index.html。
  4. 读文件,按扩展名查 mime.types 得到 Content-Type,加上状态行和响应头,发回去。

配置的层级是:

nginx.conf
  └─ http 块
       └─ include /etc/nginx/sites-enabled/*;
            └─ server 块(listen / server_name / root / location)

Ubuntu 把站点拆成两个目录:sites-available 是"仓库",放所有可用的配置;sites-enabled 是"开关",放指向仓库的符号链接。只改 sites-available 不建链接,等于没配。

默认站在 /var/www/html,首页文件叫 index.nginx-debian.html。装完 Nginx 先访问一次,能看到欢迎页,说明 80 端口这条路本身是通的——这一步能把"网络问题"和"配置问题"提前分开。

② 权限:403 的真正来源

Linux 的权限分三组:属主(owner)、属组(group)、其他人(other),每组三位 rwx。

对文件:r 读内容,w 改内容,x 执行。 对目录:r 列出名字,x 进入并访问里面的条目,w 增删文件。

目录的 x 最容易被忽略。 没有它,即使文件本身是 644,也打不开——因为你连"进去"的资格都没有。

还有一个更隐蔽的版本:父目录的 x 被去掉了。/var/www/dudao 是 755,但有人把 /var/www 改成了 700,www-data 同样进不去。namei -l 的价值就在于它看的是整条路径,不是最后一级。

Nginx 的工作进程以 www-data 身份运行。它要读到 /var/www/dudao/index.html,需要对沿途每一级目录都有 x,对文件有 r。

数字 符号 含义 常见用途
644 rw-r--r-- 属主读写,其他人只读 普通网页、图片
755 rwxr-xr-x 属主全权,其他人读+进入 目录、可执行脚本
600 rw------- 只有属主读写 私钥、.env
700 rwx------ 只有属主 ~/.ssh

排查权限最快的一条命令是 namei -l,它把路径上每一级的权限一次列出来:

namei -l /var/www/dudao/index.html

输出形如:

f: /var/www/dudao/index.html
drwxr-xr-x root   root   /
drwxr-xr-x root   root   var
drwxr-xr-x root   root   www
drwxr-xr-x ubuntu ubuntu dudao
-rw-r--r-- ubuntu ubuntu index.html

从上往下看,任何一行缺了 x(目录)或 r(文件),就是 403 的原因。

更直接的一招:以 Nginx 的身份去读一次。

sudo -u www-data cat /var/www/dudao/index.html

能打出来,权限就没问题;报 Permission denied,问题就在权限,跟 Nginx 配置无关。

③ 状态码:先分清是谁在说话

码 谁返回 含义 第一步查
200 Nginx 成功 —
301 Nginx 跳转(目录少了结尾斜杠、强制 HTTPS) 响应头的 Location
403 Nginx 有东西,但不许读 / 没有首页且禁止列目录 error.log + namei
404 Nginx 拼出来的路径下没有这个文件 root 拼出的真实路径
500 应用 后端代码崩了 应用日志(卷 5 起)
502 Nginx 连不上后端 后端进程与端口(卷 7)
504 Nginx 后端超时 后端耗时(卷 7)

这一卷只会遇到 200、301、403、404。能拿到任何一个三位数状态码,就说明网络层已经通了,剩下的是服务器内部的事。

顺带一个现象:访问 /notes(一个目录)时,Nginx 常会先回 301 跳到 /notes/,因为目录要带结尾斜杠才能正确拼上 index。看到 301 不是错,跟着响应头的 Location 走就行。

autoindex on; 能把目录变成文件列表,调试时方便,线上等于把目录结构公开。默认关闭是对的,别为了"看一眼有哪些文件"打开它。

④ 发布链路

本机编辑 index.html
  → scp 上传到 /var/www/dudao/
  → (改配置时)nginx -t 校验 + systemctl reload nginx
  → 服务器上 curl 127.0.0.1 自证
  → 自己电脑上 curl 公网 IP 自证
  → 浏览器看结果
  → 出问题看 access.log / error.log

顺序不能反。先在服务器本机验证,能把"公网可达性"排除掉;先验公网,一旦失败就同时有两个变量。

⑤ Nginx 的五个管理命令

命令 作用 什么时候用
sudo nginx -t 只检查语法,不改变运行状态 每次改配置后、reload 前
sudo nginx -T 打印合并后的完整配置 怀疑"到底加载了哪份配置"
sudo systemctl reload nginx 平滑重载,不断连接 改完配置且 -t 通过
sudo systemctl restart nginx 重启,会断开连接 进程卡死、reload 无效时
sudo journalctl -u nginx -n 50 --no-pager 看服务级日志 Nginx 起不来、启动即退出

判断顺序固定:先 -t,再 reload,最后才 restart。跳过 -t 直接 restart,是让线上站点整体挂掉的最快方式——配置有语法错误时,旧进程会被停掉,新进程起不来。

⑥ 更新文件之后,为什么浏览器还是旧的

把 index.html 重新 scp 上去,浏览器刷新,看到的还是旧内容。三种可能:

第一,浏览器缓存。普通刷新可能直接用本地副本,按 Ctrl+F5(macOS 是 Cmd+Shift+R)强制重新拉取。

第二,你传到了另一个目录。scp 的目标路径写错一层,文件就落在别处,Nginx 自然读不到。

第三,中间加了缓存。这一卷的配置没有缓存指令,所以暂时不会遇到;以后上了 CDN 或反向代理,这一条就会变成常客。

用命令行确认,不靠眼睛:

curl -I http://203.0.113.10/

看 Last-Modified 和 Content-Length 是不是刚才那次上传的。curl 不带缓存,它看到的就是服务器此刻的真实状态。

1.6.3 动手:发布 index.html 并用 curl -I 自证

第一步:装 Nginx,先看默认站

sudo apt update
sudo apt install -y nginx
sudo systemctl status nginx

status 里看到 active (running) 就行,按 q 退出。再验证:

curl -I http://127.0.0.1/

预期:

HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)
Content-Type: text/html
Content-Length: 615
Last-Modified: Mon, 17 Nov 2026 02:50:00 GMT
Connection: keep-alive
ETag: "6920f4a1-267"
Accept-Ranges: bytes

这一步证明"80 端口有人听、Nginx 能返回文件"。如果这里就失败,别往下走,先解决 Nginx 本身。

第二步:建目录,把属主交给自己

sudo mkdir -p /var/www/dudao
sudo chown -R "$USER:$USER" /var/www/dudao
chmod 755 /var/www/dudao

为什么属主是你自己而不是 www-data:这样你上传文件不需要 sudo,而 755 让 www-data 通过"其他人"的 r-x 读到内容。写的人和读的人分开,是更省事的权限模型。 后面 scp 命令里的 ubuntu 要换成你实例的默认用户。

为什么不直接用默认的 /var/www/html:那是系统装 Nginx 时建的地盘,升级或重装容易被覆盖,多个项目混在一起也分不清。一个站点一个目录,以后备份、迁移、回滚都只动一个文件夹。

还有一条安全底线:root 绝对不要指向家目录。Nginx 会把目录下的文件原样对外,~/.ssh、.env、私人笔记都可能被下载。专用目录里只放准备公开的文件,这是成本最低的隔离。

第三步:在本机准备首页

在 ~/code/dudao/index.html 写入:

<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>读到 · 已上线</title>
</head>
<body>
  <h1>读到</h1>
  <p>这个页面来自服务器的 /var/www/dudao/index.html。</p>
  <p>能看到它,说明 DNS、TCP、Nginx、文件权限四关都通了。</p>
</body>
</html>

这一卷不展开 HTML,只要求它能被浏览器显示。结构和样式是卷 2 的事。

第四步:上传

在本机、项目目录下执行:

scp index.html [email protected]:/var/www/dudao/

预期输出形如:

index.html                                    100%  312     8.2KB/s   00:00

到服务器上确认:

ls -l /var/www/dudao

应该是:

-rw-r--r-- 1 ubuntu ubuntu 312 Nov 17 02:55 index.html

scp 走的就是 SSH,和登录同一条加密通道,不需要额外装 FTP 服务。文件多、要增量同步时再换 rsync -av;这一卷只有一个文件,scp 足够。

第五步:写站点配置

在服务器上执行:

sudo tee /etc/nginx/sites-available/dudao >/dev/null <<'EOF'
server {
    listen 80;
    listen [::]:80;
    server_name _;

    root /var/www/dudao;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}
EOF

逐行解释:

行 作用
listen 80; 监听 IPv4 的 80 端口
listen [::]:80; 同时监听 IPv6
server_name _; 兜底,匹配任何 Host(这一卷还没有域名)
root /var/www/dudao; 把 URL 路径拼到这个目录下
index index.html; 请求目录时找 index.html
try_files $uri $uri/ =404; 先找文件,再找目录,都没有就返回 404

server_name _; 的意思是"没有匹配到具体域名时用我"。你用 IP 访问时,请求头里的 Host 就是这串 IP,匹配不上任何域名,于是落到这个兜底 server。所以这一卷不需要域名,也能让站点工作。

第六步:启用、校验、重载

sudo ln -s /etc/nginx/sites-available/dudao /etc/nginx/sites-enabled/dudao
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginx

nginx -t 预期:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

reload 是平滑重载,不会断开正在处理的连接;restart 会。改配置优先用 reload。

第七步:先在本机自证

curl -I http://127.0.0.1/

还是 HTTP/1.1 200 OK,但这次 Content-Length 应该变成你文件的大小。想确认返回的是不是你的内容:

curl -s http://127.0.0.1/ | head -n 5

看到 <!doctype html> 和 <title>读到 · 已上线</title>,说明目录、首页、权限全对。

顺手分清两个参数:curl -I 只发 HEAD,只要响应头;curl -i 发 GET,头和响应体都返回。验证"通不通"用 -I 更快,验证"内容对不对"用 -i 或直接 curl。

第八步:在自己电脑上访问公网

curl -I http://203.0.113.10/

再打开浏览器,输入 http://203.0.113.10/。看到"读到"两个大字,这一卷的核心目标就达成了。

不知道自己的公网 IP 时,看控制台实例列表,不要在服务器上 ip addr 里找——那里只有内网地址。

第九步:如果超时,去放行 80

在控制台的安全组里加入方向规则:协议 TCP、端口 80、来源 0.0.0.0/0。如果机器内启用了 ufw:

sudo ufw allow 'Nginx Full'
sudo ufw status

放行后仍超时,再核对两件事:规则加的是不是"入方向";这个安全组有没有真正绑到实例上(有的厂商按网卡绑定,换过网卡就会脱钩)。

第十步:学会看日志

sudo tail -n 5 /var/log/nginx/access.log
sudo tail -n 5 /var/log/nginx/error.log

access.log 一行形如:

203.0.113.77 - - [17/Nov/2026:02:58:31 +0800] "GET / HTTP/1.1" 200 312 "-" "curl/8.5.0"
字段 含义
203.0.113.77 访问者 IP(如果前面有代理,这里可能是代理 IP)
[17/Nov/2026:02:58:31 +0800] 时间与时区
"GET / HTTP/1.1" 方法、路径、协议
200 状态码
312 响应体字节数
"curl/8.5.0" User-Agent

排查顺序永远是:error.log 看原因,access.log 看事实。 前者告诉你哪一级权限被拒,后者告诉你请求到底有没有到。

日志会按天轮转,历史文件长成 access.log.1、access.log.2.gz 这样。大日志不要用 cat 打开,用 less 翻页,或者 tail -n 100 看最近一百行。

1.6.4 三个坑

坑 1:403 Forbidden,文件明明在

症状:浏览器显示 403 Forbidden,error.log 里是:

2026/11/17 02:15:03 [error] 812#812: *7 directory index of "/var/www/dudao/" is forbidden,
client: 203.0.113.77, server: _, request: "GET / HTTP/1.1", host: "203.0.113.10"

成因:三种。目录里没有 index.html(或名字大小写不对),同时 autoindex 默认关闭,Nginx 既没有首页也不许列目录;目录缺 x 权限,进不去;文件存在但 www-data 读不到(比如权限是 640 且属组不对)。

如果是权限问题,error.log 里的原文会更直接:

2026/11/17 02:15:03 [error] 812#812: *7 open() "/var/www/dudao/index.html" failed
(13: Permission denied), client: 203.0.113.77, server: _, request: "GET / HTTP/1.1"

13: Permission denied 就是内核在说"不许读",和 Nginx 配置无关。

修法:按顺序三招。ls -l /var/www/dudao 看文件名,Linux 区分大小写,Index.html 不等于 index.html;namei -l /var/www/dudao/index.html 看每一级;sudo -u www-data cat /var/www/dudao/index.html 直接以 Nginx 身份试读。第三招能一锤定音。

坑 2:改完配置没生效,还是默认页

症状:nginx -t 通过,reload 也执行了,浏览器还是欢迎页,或者还是旧内容。

成因:只改了 sites-available 没建链接;default 站点还在,且它的 listen 80 default_server 抢在前面;改完忘了 reload;浏览器用了本地缓存(收到 304)。

修法:先看开关目录:

ls -l /etc/nginx/sites-enabled/

应该只有 dudao -> /etc/nginx/sites-available/dudao,没有 default。再看 Nginx 真正加载的配置:

sudo nginx -T | grep -n "root /var/www"

-T 会打印合并后的完整配置,能直接看到生效的 root 是哪一行。最后用 curl -I 而不是浏览器验证,排除缓存干扰。

坑 3:安全组没放行 80,表现为超时

症状:服务器上 curl -I http://127.0.0.1/ 是 200;自己电脑上 curl --connect-timeout 10 -I http://203.0.113.10/ 等满十秒,最后:

curl: (28) Failed to connect to 203.0.113.10 port 80 after 10000 ms: Timeout was reached

成因:云安全组入方向没有 80 规则。包在机房边界被丢弃,服务器根本不知道有人来过,所以不会有任何日志。

修法:控制台加入方向 TCP 80。加完立刻重试,不用重启 Nginx——它一直在正常监听,只是外面的包进不来。

用报错区分这两件事:

输出 含义 该改哪
Connection refused,立刻返回 包到了机器,但 80 没有进程监听 systemctl status nginx、ss -lntp
Timeout was reached,等很久 包被丢在途中 安全组、ufw、路由
坑 关键现象 一句话修法
403 directory index of "/var/www/dudao/" is forbidden 补 index.html;namei -l;sudo -u www-data cat
配置没生效 还是默认页 看 sites-enabled,nginx -T 确认,reload
安全组未放行 超时,且服务器无访问日志 控制台放行 TCP 80

本章验收

  • 服务器上 curl -I http://127.0.0.1/ 返回 200,且 Content-Length 与你的文件一致
  • 自己电脑上 curl -I http://你的公网IP/ 返回 200
  • 浏览器能看到你自己写的页面内容,不是 Nginx 欢迎页
  • 能说清 403、404、超时分别对应四个条件里的哪一个
  • 会看 error.log 和 access.log,能说出各自的第一列是什么
  • 能解释为什么 sites-available 改了还要建链接

自测

Q1:403 和 404 的本质区别是什么?各自第一步查什么?

看答案 403 是"服务器找到了目标,但拒绝提供",404 是"按配置拼出来的路径下没有这个资源"。403 先查权限(`namei -l`、`sudo -u www-data cat`)和首页是否存在;404 先查 `root` 指令与真实文件路径是否一致,以及文件名大小写。

Q2:为什么服务器上 curl 127.0.0.1 是 200,公网却超时?

看答案 因为请求根本没到服务器。127.0.0.1 走本机回环,绕过了所有外部网络设备;公网请求要先穿过云安全组。超时说明包在边界被丢弃,Nginx 不会留下任何日志。去控制台放行 80 即可,不需要动 Nginx。

Q3:nginx -t 通过,是否代表配置已经生效?

看答案 不代表。`-t` 只做语法检查,不改变运行中的进程。要生效还需要:文件在 `sites-enabled` 里(或已被 include)、没有别的 server 块抢占、执行了 `systemctl reload nginx`。验证生效要用 `nginx -T` 看合并后的配置,再用 `curl -I` 看实际响应。

下一步

卷 1 到此结束:你有了一台服务器、一个公网 IP、一个能打开的页面。但它只有结构,没有样式,也没有任何交互。

卷 2 从零写 HTML、CSS、JavaScript,把这张占位页变成真正能用的「读到」界面。

→ 卷2-00-导读.md