用 Python 自带的 http.server 加 systemd,十分钟托管一个静态页面

举报
yd_286747025 发表于 2026/11/12 13:59:15 2026/11/12
【摘要】 有时候只想把一个静态页面(项目介绍、文档、活动页)放到服务器上,不想为此装一整套 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

四、踩坑与解决

  1. 状态是 203/EXEC:ExecStart 里的 python3 要写绝对路径,用 which python3 确认,不同系统位置可能不一样。
  2. 页面改了没更新:http.server 不缓存文件内容,通常是浏览器缓存,强制刷新即可。
  3. 访问 /srv/site 之外的文件:http.server 会按 --directory 限定目录,但目录里的符号链接会被跟随,所以不要在站点目录里放指向敏感位置的软链接。
  4. 目录列表被公开:没有 index.html 的目录会直接列出文件。我给每个目录都放了 index.html,或者干脆不往站点目录放不想公开的东西。
  5. 端口被占用:报 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)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。