Web 服务器

Web 服务器是一个会回答的程序

撇开机柜和云厂商的标志，Web 服务器就是一个反复做同一件事的程序：等人连上来，读他要什么，把文字送回去，然后接着等。

「服务器」这个词指两样东西，而人们总把它们混着说。机房里那台机器是服务器，在某个端口上侧耳倾听的那个程序也是服务器。这里说的是程序，而它在你面前这台笔记本上跑得一样好。

一次访问，四个步骤

1. 监听程序占住一个端口等着 —— 例子里是 8084。端口就是机器上编了号的门，所以两个程序不可能守着同一扇。
2. 读取请求浏览器连上来，送出几行文字。第一行说明它用哪种方法要哪个路径，比如「GET 路径 /」。
3. 做出判断服务器决定送什么：从磁盘读文件、跑一段代码、去查数据库。我们的例子永远只送同一个文件，这也正是它能塞进二十行的唯一原因。
4. 回应并关闭写下状态行、几个头部、一个空行和内容，然后关掉连接，回到开头等下一位访客。

一份 Shell 脚本做出的 Web 服务器

下面是一台用 bash 写成的完整 Web 服务器。它打开端口、读取请求行、留下日志，并把 index.html 作为一份规规矩矩的 HTTP 响应送回去。二十行，不用任何库，而浏览器分辨不出差别。

重活由两个命令承担：netcat（nc）负责说网络，mkfifo 造出一个命名管道，好让我们写出的答案回到 nc 正握着的那条连接上。

#!/bin/bash

PORT=8084
PIPE=simple-web-server-pipe

rm -f "$PIPE"
mkfifo "$PIPE"

response() {
    read -r method path _
    echo "[$(date)] $method $path" >&2
    index=$(cat index.html)
    printf 'HTTP/1.1 200 OK\r\nContent-Type: text/html; charset=utf-8\r\nConnection: close\r\n\r\n%s' \
      "$index"
}

while true; do
    response < "$PIPE" | nc -l "$PORT" > "$PIPE"
done

逐行来看

1. PORT=8084要监听的端口。大于 1024 的号码不需要管理员权限，8084 也不太会和你已经在跑的东西撞上。
2. PIPE=simple-web-server-pipe管道文件的名字。它在文件夹里看着像普通文件，但里面从不存东西 —— 它只是让数据在两个命令之间穿过去。
3. mkfifo "$PIPE"创建命名管道（FIFO）。上一行之所以先删掉上次残留的文件，是因为 mkfifo 拒绝覆盖已经存在的文件。
4. read -r method path _读取请求的第一行，拆成方法、路径和其余部分。之后浏览器送来的那些头部，这台服务器一概不看。
5. echo "[$(date)] $method $path" >&2打印一行日志。重定向把它送去标准错误，所以它出现在你的终端上，而不会混进送给浏览器的页面里。
6. index=$(cat index.html)把当前文件夹里的 index.html 读进变量。这正是必须在那个文件所在的目录里启动服务器的原因。
7. printf 'HTTP/1.1 200 OK\r\n…'写出响应：状态行、内容类型、一个说明连接到此为止的头部，然后是空行和页面。分隔头部与内容的正是那个空行，而 HTTP 要求每一行都以回车加换行结束。
8. response < "$PIPE" | nc -l "$PORT" > "$PIPE"让它跑得起来的诀窍。nc 接过 | 前面的 response 写出的响应，发给浏览器，再把浏览器的请求写进 FIFO 文件（$PIPE）。response 从那个 FIFO 里读出请求，两头互相喂给对方。
9. while true; do … done循环。nc 处理完一条连接就退出，没有这一行，服务器接待完一位访客就停了。

自己跑一遍

把脚本存成 server.sh，旁边放一份 index.html，然后启动它。让那个终端一直开着，再开第二个终端去发请求。

# 1. create an index.html in the same folder
echo '<h1>Hello</h1>' > index.html

# 2. save the script above as server.sh and start it
bash server.sh

# 3. open it in a browser (or check from a second terminal)
open http://localhost:8084
curl http://localhost:8084

一边刷新浏览器一边看第一个终端：每来一次请求就多一行日志。用 Control-C 停下，之后如果管道文件还在就删掉它。Linux 上的 nc 可能需要在端口前多加一个 -p；macOS 自带的版本按写好的样子就能跑。

线上真正流过去的东西

把连接打开一看，流过去的是你自己也打得出来的普通文字。Shell 服务器之所以成立就靠这一点，而你能靠「读」而不是「猜」来排查 Web 故障，靠的也是这一点。

浏览器送出的请求

GET / HTTP/1.1
Host: localhost:8084
User-Agent: Mozilla/5.0
Accept: text/html

• 第一行是我们这台服务器唯一读的部分：方法（GET 是取回，POST 是送出）、路径，以及协议版本。
• Host 说明想要哪个站点。一台服务器可以在同一个地址上放几百个域名，靠的就是这个头部来分辨。
• 其余是浏览器的自我介绍：自己是什么软件、能读哪些格式、偏好哪种语言。服务器可以采用，也可以无视。

服务器送出的响应

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Connection: close

<h1>Hello</h1>

• 状态行：协议版本，加上一个说明结果如何的数字。200 表示请求成功。
• Content-Type 告诉浏览器该怎么读接下来的内容。把 HTML 标成错误的类型，浏览器就会把你的标签当文字显示，而不是渲染成页面。
• charset 那一段在实践中不是可选项。少了它，中文很可能到达时已经是乱码。
• 然后是一个空行，它之后的一切都是内容。头部与页面之间的全部边界，就是那一个空行。

值得记住的状态码

这台服务器做不到的事

这个例子是诚实的教材，也是糟糕的服务。把它究竟差在哪里弄清楚，就等于弄清楚了真正的服务器替你解决了什么。

• 一次只接待一个人。nc 只处理一条连接，它忙着的时候其他人只能排队。
• 它无视路径。你要什么它都只给 index.html —— 没有路由，也没有第二个页面。
• 什么都当 HTML 送。图片、样式表、下载文件各自需要自己的内容类型，而这台服务器只认识一种。
• 没有 HTTPS。一切都是裸着走的，沿途任何一段网络都能读，也能改。
• 完全没有防护。它不检查请求大小，没有超时，你要是随手扩展一下，它会老老实实去读别人指定的文件路径。

Caddy：一台仍然读得懂的真服务器

Caddy 是一个只有单个可执行文件的现代 Web 服务器。它值得紧接着 Shell 例子来学，因为它保留了同样的手感 —— 几行读得懂的配置就跑起来 —— 又解决了 Shell 版做不到的事（多人同时访问、HTTPS、按路径分流）。

它最拿得出手的是自动 HTTPS。给它一个真实域名，它就会申请证书、装好、在过期前续期，并把 http 访客转去 https。在别的服务器上，这是每隔几个月就得重来一次的杂活。

安装

# macOS
brew install caddy

# Ubuntu / Debian — add Caddy's own package list first (official steps)
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install caddy

# with Docker (covered in the Docker tab): serve this folder on port 8080
docker run -p 8080:80 -v "$PWD":/usr/share/caddy caddy:2

一行命令把文件夹送出去

不需要配置文件。进到放着 index.html 的文件夹，敲一行命令就好 —— 这是把页面给同一网络里的人看的最快办法。

# serve this folder's index.html on port 8080
caddy file-server --listen :8080

# add a directory listing for folders without an index.html
caddy file-server --listen :8080 --browse

Caddyfile

要长期放着的，就写一份 Caddyfile。它就是纯文本，一个完整站点四行就够。

example.com {
	root * /var/www/html
	file_server
	encode gzip zstd
}

1. example.com {站点地址。这里写真实域名，Caddy 会自己张罗 HTTPS 证书。就算写 localhost，Caddy 也会用它自己生成的证书走 HTTPS。只想要普通的 http，就写成 http://localhost 或 :80 这样。
2. root * /var/www/html文件在磁盘上的位置。星号表示这条规则适用于本站点的所有路径。
3. file_server真正把那些文件送出去的一行。少了它，Caddy 会对请求什么都不给。
4. encode gzip zstd送出前先压缩响应。就一个词，慢速网络下页面到达得明显更快。

反向代理：把请求转交出去

大多数站点不是磁盘上的文件，而是某个在本地端口上倾听的应用程序。反向代理就是接下外部请求、转交给那个应用、再把答案送回去的服务器。一行就够。

example.com {
	reverse_proxy 127.0.0.1:8080
}

files.example.com {
	root * /srv/files
	file_server browse
}

一台机器承载多个站点靠的也是它。443 端口只能由一个程序占住，于是让 Caddy 占着，它读出访客要的是哪个域名，再把每一个转给背后不同的应用。

需要掌握的命令

Docker：把 Caddy 装进盒子，再把真正的站点放上互联网

Docker 把一个程序连同它运行所需的一切，打包成一个 Docker 镜像。库、配置，甚至一个小小的操作系统都装在里面。然后把这个镜像作为容器运行。容器在你的笔记本上和在租来的服务器上表现完全一样。于是那句老借口「可在我电脑上是好的啊」就不复存在了。

Caddy 本来就只是一个文件，何必多此一举？因为真正的服务器很快就要同时跑好几样东西 —— 一个站点、一个应用、一个数据库。Docker 给每一样东西一个自己的盒子，用同样几条命令就能启动、停止、更新和删除，既不用在服务器上另装别的，也不会打扰左邻右舍。

先认识四个词

1. 镜像把一个程序和它所需的一切冻结起来的包。可以直接下载（caddy:2），也可以用一份叫 Dockerfile 的配方文件自己构建。运行期间它从不改变。
2. 容器正在运行的镜像。一个镜像可以启动许多个容器，删掉容器也碰不到镜像 —— 下次启动又是全新的。
3. 端口映射容器有自己的端口，外面谁也看不见。-p 8080:80 把你电脑的 8080 端口接到容器里的 80 端口，浏览器才能连得上。
4. 数据卷容器写在自己内部的文件，会随着容器被删而消失。数据卷，或者挂载进去的你自己的文件夹，才是能留下来的存储 —— 你的页面、配置和 Caddy 的证书都住在那里。

安装 Docker

在 Mac 或 Windows 电脑上，从 docker.com 安装 Docker Desktop 并启动一次，之后终端里的 docker 命令就能用了。在 Linux 服务器上，Docker 官方脚本一行就能装好一切。继续往下之前，两条检查命令都应该有回应。

# macOS · Windows: install Docker Desktop from docker.com and start it once

# Ubuntu / Debian server: Docker's official install script
curl -fsSL https://get.docker.com | sh

# check that both commands answer
docker --version
docker compose version

一条命令跑起 Caddy

进到放着 index.html 的文件夹，运行下面这一行。第一次 Docker 会下载 Caddy 镜像，之后大约一秒就能启动。打开 http://localhost:8080，你的页面就在那儿。

# serve this folder at http://localhost:8080 (Control-C stops it)
docker run --rm -p 8080:80 -v "$PWD":/usr/share/caddy caddy:2

1. docker run用镜像创建一个容器并启动它。
2. --rm容器一停就删掉它，免得停下的容器越积越多。镜像还在，所以下次运行一样快。
3. -p 8080:80把你电脑的 8080 端口接到容器里 Caddy 监听的 80 端口。左边的数字随你挑，右边的数字由镜像定好。
4. -v "$PWD":/usr/share/caddy让当前文件夹（$PWD）在容器里显示为 /usr/share/caddy —— 官方镜像默认对外提供的就是这个文件夹。在这里改一个文件，下次刷新就能看到变化。
5. caddy:2要运行的镜像：官方 Caddy 镜像，任意 2.x 版本。不带 :2 标签的话，Docker 会取 latest，而它哪天可能就在你脚下跳到一个新的大版本。

按 Control-C 停止。临时看一眼再合适不过，但命令很长，终端一关就忘了。凡是要长期放着的，就把它写进文件 —— 这就是下一个项目。

你会用到的命令