Termux搭建HTML服务器教程

想在Termux里快速搭建本地HTML服务器却卡在“ModuleNotFoundError: No module named 'http.server'”？别折腾过时的termux-web-server或被Node版本兼容性坑到——本文直击核心：教你用pkg install python补全Python标准库，或更轻量地启用Termux自带的busybox httpd（注意绝对路径、index.html必备和前台运行），并强调关键细节：必须绑定0.0.0.0而非localhost、用手机真实IP访问、避开storage权限陷阱，三分钟搞定静态页预览，稳定、省资源、零依赖。

Termux 里没有 python -m http.server 怎么办

Termux 默认不带 Python 的 http.server 模块（尤其低版本或精简安装），直接运行会报 ModuleNotFoundError: No module named 'http.server'。这不是你少装了什么，而是 Termux 的 Python 包默认不含标准库的网络模块——得手动补全。

实操建议：

• 先确认 Python 是否完整：pkg install python（不是 python2）；如果已装过，再执行一次确保更新到最新版
• 装完后验证：python -c "import http.server; print('ok')"，输出 ok 才算真正可用
• 若仍失败，可能是架构问题（如 aarch64 设备装了 x86 包），换源重装：pkg clean && pkg update && pkg install python

用 busybox httpd 启一个轻量 HTML 服务器

比 Python 更快、更省资源，适合纯静态页预览，且 Termux 自带 busybox（或可一键装）。

常见错误现象：运行 busybox httpd -f -p 8080 -h /data/data/com.termux/files/home 后访问空白页或 404——根本原因是路径权限或默认首页缺失。

使用场景：快速看 index.html，不需后端、不改代码、不想等 Python 启动。

实操建议：

• 确保目标目录下有 index.html，busybox httpd 不自动索引目录，没这个文件就返回 404
• 端口选 8080 以上（Termux 普通用户不能绑定 1024 以下端口），且避免和 termux-api 或其他服务冲突
• 启动命令必须加 -f（前台运行），否则进程后台化后终端一关就停
• 路径要用绝对路径，~/ 或 . 会被忽略，正确写法是 /data/data/com.termux/files/home/www

Python http.server 在 Termux 的真实行为差异

即使 Python 装好了，python -m http.server 8080 在 Termux 和桌面系统表现不同：它默认只监听 127.0.0.1，手机浏览器无法通过 localhost:8080 访问（Android 限制 loopback 外部不可达）。

性能影响：Python 服务在 Termux 下内存占用略高，但对单页 HTML 几乎无感；兼容性上，它支持 Content-Type 自动识别，比 busybox 更稳。

实操建议：

• 必须显式绑定到 0.0.0.0：python -m http.server -b 0.0.0.0:8080 8080
• 如果提示 Address already in use，先查端口占用：lsof -i :8080 或 pidof python 杀掉残留进程
• 浏览器访问请用手机 IP（非 localhost）：在 Termux 里运行 ip addr | grep 'inet ' | grep -v '127.0.0.1'，取 wlan0 的 IPv4 地址，比如 192.168.1.12，然后在浏览器输 http://192.168.1.12:8080

为什么用 termux-web-server 插件反而容易翻车

有人搜到 termux-web-server 这个第三方插件，但它依赖老旧 Node.js 版本（v14 以下），而 Termux 当前 nodejs 是 v20+，装上就报 ERR_REQUIRE_ESM 或 Cannot find module 'fs/promises'。

这不是配置问题，是生态断层。Node.js 升级后大量 API 变更，该插件两年没维护，npm install 直接失败。

实操建议：

• 跳过 termux-web-server，别试 npm install -g 那套
• 真要 Node 方案，用 npx serve（需先 pkg install nodejs，再 npm install -g serve），但注意 serve 默认也只绑 localhost，启动时加 -l 0.0.0.0:8080
• 优先选 busybox 或 Python，它们不依赖外部包管理器，启动即用

最常被忽略的一点：Termux 的 storage 权限没开，www 文件夹若放在 ~/storage/shared 下，busybox 或 Python 会因权限拒绝读取——务必把 HTML 文件放 ~/ 或子目录，别跨 storage 分区。

到这里，我们也就讲完了《Termux搭建HTML服务器教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！