OpenBSD 静态网站搭建入门指南

OpenBSD 静态网站搭建入门指南

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

内容提要

文章介绍在OpenBSD上使用系统自带工具搭建静态网站:用httpd托管静态文件,relayd作反向代理,pf控制防火墙放行80/443端口,acme-client申请Let's Encrypt证书。因chroot限制,网站文件须放在/var/www下,并配置/etc/httpd.conf。作者还说明用cron定期续期证书,并提醒排查DNS、pf规则等常见问题。

🔎

延伸解读

chroot 如何影响网站文件存放

OpenBSD 的 httpd 默认将 /var/www 作为 chroot 根目录,这意味着进程只能访问该目录内的文件。因此,网站文件必须放在 /var/www 下,否则 httpd 无法找到。配置中的 root 路径也是相对于 chroot 的,例如 root /coolsite 实际指向 /var/www/coolsite。理解这一点可以避免因路径错误导致的 404 问题。

httpd 与 relayd 的分工

文章指出,纯静态站点只需 httpd 即可托管 HTML、CSS 和可选的 JavaScript,httpd 也支持 FastCGI。如果需要反向代理,将请求转发到后端服务,则更适合使用 relayd。两者可以配合工作,此时 httpd 作为常规后端,由 relayd 转发特定请求。选择哪种方案取决于是否需要代理层。

证书申请与续期的关键步骤

使用 acme-client 申请 Let's Encrypt 证书前,需确保 DNS 记录指向服务器,并让 httpd 通过 HTTP 提供 /.well-known/acme-challenge/ 路径的验证文件。首次申请时使用 -v 参数便于观察过程。证书生成后,在 httpd 的 TLS 配置中引用证书和私钥路径。文章建议用 cron 每 3 个月自动续期并重载 httpd,避免证书过期。

排查常见问题的顺序

文章提到,acme-client 失败时首先用 dig 检查 DNS 记录是否指向服务器。若 DNS 正常但流量不通,则可能是 pf 防火墙丢弃了数据包,需在 /etc/pf.conf 中放行 80 和 443 端口。修改 pf 规则后,务必先用 pfctl -nf 检查语法,确认无误再加载,以免误阻断 SSH 连接。

❓

Q&A

在OpenBSD上搭建静态网站需要安装nginx吗?

不需要。OpenBSD系统自带的httpd、relayd、pf和acme-client等工具就足以托管静态网站,无需额外安装nginx。

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

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

如何用acme-client申请Let's Encrypt证书?

首先创建/etc/acme-client.conf,配置域名和密钥路径,并确保/.well-known/acme-challenge可通过HTTP访问;然后运行doas acme-client -v 你的域名,证书和私钥会生成在/etc/ssl和/etc/ssl/private下。

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

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

acme-client申请证书失败,常见原因有哪些?

常见原因包括DNS记录未指向服务器,或pf防火墙未放行80和443端口。可以用dig检查DNS,并编辑/etc/pf.conf确保允许相应端口。

如何设置证书自动续期?

使用cron定期运行acme-client并重载httpd。例如在crontab中添加:3 * * * acme-client cool.site && rcctl reload httpd,每3个月执行一次。

🏷️

标签

➡️

继续阅读