在 OpenBSD 上搭建静态网站(入门篇)

在 OpenBSD 上搭建静态网站(入门篇)

💡 原文英文,约1800词,阅读约需7分钟。
📝

内容提要

本文介绍在OpenBSD上使用系统自带工具搭建静态网站:httpd提供HTTP服务,relayd作反向代理,pf控制防火墙,acme-client申请Let's Encrypt证书。网站文件须放在/var/www下(受chroot限制),通过/etc/httpd.conf配置80端口跳转HTTPS、443端口提供TLS服务。需在pf.conf放行80和443端口,并用cron定期续期证书后重载httpd。作者认为不用Docker和Caddy虽繁琐,但能了解底层细节。

🔎

延伸解读

chroot 决定了网站文件必须放在 /var/www 下

文章强调,OpenBSD 的 httpd 默认以 chroot 方式运行,根目录被限制在 /var/www。这意味着 httpd 进程无法读取该目录之外的文件,因此网站文件必须放在 /var/www 内,否则即使配置正确也会找不到页面。理解这一点有助于避免把文件放到其他路径后反复排查配置错误。

80 端口先处理 ACME 验证再跳转 HTTPS

示例配置中,80 端口的 server 块专门为 /.well-known/acme-challenge/* 设置 location,将请求指向 /acme 目录并剥离路径前缀,其余请求则返回 302 跳转到 HTTPS。这样 acme-client 才能通过 HTTP 完成域名验证,同时普通访问仍被引导至加密连接。配置顺序和路径匹配规则需要留意。

pf 默认丢弃流量,放行端口前先检查语法

OpenBSD 的 pf 默认会丢弃大部分流量,因此即使 httpd 和证书都配置好,外部仍可能无法访问。文章建议在 /etc/pf.conf 中放行 80 和 443 端口,并先用 pfctl -nf 检查语法,确认无误后再加载,以免错误规则阻断 SSH 连接。这是部署过程中容易被忽略但影响直接的一步。

证书续期靠 cron 定期执行并重载 httpd

文章给出的续期方式是用 cron 定期运行 acme-client 获取新证书,然后重载 httpd 使新证书生效。示例中写的是每 3 个月执行一次。读者需要注意,续期依赖 acme-client 能再次完成验证,因此 80 端口的 ACME 路径配置和 DNS 记录应保持可用,否则自动续期可能失败。

❓

Q&A

在 OpenBSD 上搭建静态网站需要安装哪些软件?

不需要额外安装软件,使用系统自带的工具即可:httpd 提供 HTTP 服务,relayd 作反向代理,pf 控制防火墙,acme-client 申请 Let's Encrypt 证书。

为什么 OpenBSD 上网站文件必须放在 /var/www 下?

因为 httpd 默认使用 chroot 隔离,将根目录改为 /var/www,httpd 进程无法访问该目录之外的文件,所以网站文件必须放在 /var/www 下才能被读取。

如何配置 httpd 将 HTTP 请求重定向到 HTTPS?

在监听 80 端口的 server 块中,使用 location * { block return 302 "https://$HTTP_HOST$REQUEST_URI" } 即可将所有 HTTP 请求重定向到 HTTPS。

使用 acme-client 申请证书时需要注意什么?

需要确保 DNS 记录指向服务器,并配置 httpd 使 /.well-known/acme-challenge/* 通过 HTTP 可访问,以便证书颁发机构验证域名所有权。首次申请时使用 -v 参数查看详细过程。

网站无法访问,可能是什么原因?

常见原因有两个:一是 DNS 记录未正确指向服务器,可用 dig 命令检查;二是 pf 防火墙默认丢弃流量,需在 /etc/pf.conf 中放行 80 和 443 端口。修改后先用 pfctl -nf 检查语法再重载。

如何自动续期 Let's Encrypt 证书?

使用 cron 定期执行:编辑 crontab 添加 `3 * * * acme-client cool.site && rcctl reload httpd`,每 3 个月自动续期并重载 httpd。

🏷️

标签

➡️

继续阅读