用 Python 自带的 http.server 加 systemd,十分钟托管一个静态页面
【摘要】 有时候只想把一个静态页面(项目介绍、文档、活动页)放到服务器上,不想为此装一整套 Web 服务。Python 自带的 http.server 其实够用,只要用 systemd 托管好,就能稳定地跑起来。这篇记录我的做法和几个踩过的坑。需要先说明:它没有 HTTPS、没有限速,适合内部或临时使用,对外正式访问建议前面再加 nginx。 一、准备目录和专用用户不要用 root 跑服务。先建一个没...
有时候只想把一个静态页面(项目介绍、文档、活动页)放到服务器上,不想为此装一整套 Web 服务。Python 自带的 http.server 其实够用,只要用 systemd 托管好,就能稳定地跑起来。这篇记录我的做法和几个踩过的坑。需要先说明:它没有 HTTPS、没有限速,适合内部或临时使用,对外正式访问建议前面再加 nginx。
一、准备目录和专用用户
不要用 root 跑服务。先建一个没有登录权限的用户和站点目录:
sudo useradd --system --no-create-home --shell /usr/sbin/nologin appuser
sudo mkdir -p /srv/site
echo '<h1>hello</h1>' | sudo tee /srv/site/index.html
sudo chown -R appuser:appuser /srv/site
二、先手动跑一下
python3 -m http.server 8080 --bind 127.0.0.1 --directory /srv/site
--bind 很关键:默认监听 0.0.0.0,也就是所有网卡。我只想让本机的 nginx 访问,所以绑定到 127.0.0.1。另一个终端 curl 127.0.0.1:8080 能看到页面就说明没问题。
三、写 systemd 服务
新建 /etc/systemd/system/static-site.service:
[Unit]
Description=Static site via python http.server
After=network.target
[Service]
User=appuser
Group=appuser
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /srv/site
Restart=on-failure
RestartSec=3
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
MemoryMax=100M
[Install]
WantedBy=multi-user.target
启用并查看状态:
sudo systemctl daemon-reload
sudo systemctl enable --now static-site
systemctl status static-site --no-pager
journalctl -u static-site -n 20 --no-pager
四、踩坑与解决
- 状态是 203/EXEC:ExecStart 里的 python3 要写绝对路径,用 which python3 确认,不同系统位置可能不一样。
- 页面改了没更新:
http.server不缓存文件内容,通常是浏览器缓存,强制刷新即可。 - 访问 /srv/site 之外的文件:
http.server会按 --directory 限定目录,但目录里的符号链接会被跟随,所以不要在站点目录里放指向敏感位置的软链接。 - 目录列表被公开:没有 index.html 的目录会直接列出文件。我给每个目录都放了 index.html,或者干脆不往站点目录放不想公开的东西。
- 端口被占用:报 Address already in use 时用 ss -ltnp | grep 8080 找到占用的进程。
五、前面接 nginx 反代(可选)
需要域名和 HTTPS 时,nginx 里加一段:
location / {
proxy_pass 127.0.0.1:8080; # 实际配置里前面要加协议头
proxy_set_header Host $host;
}
安全组只放行 80/443,8080 不对外开放,这样 http.server 只被本机访问。
六、小结
这套方案的好处是几乎零依赖:一个用户、一个目录、一个 unit 文件。关键点是三个:绑定到 127.0.0.1、用非 root 用户运行、用 Restart 和 MemoryMax 兜底。如果之后访问量上来,或者需要压缩、缓存头、限速,再换成 nginx 直接托管静态文件就行,目录结构不用动。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)