让世界看到你的文件
本合集目录
本章目录
单册说明:本文件是卷 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 / 为例:
- 找到匹配的
server块(按listen端口和server_name)。 - 把
root和请求路径拼起来:/var/www/dudao+/。 - 路径以
/结尾,于是找index指令列出的文件:index.html。 - 读文件,按扩展名查
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,把这张占位页变成真正能用的「读到」界面。