Termux 中缺少 python -m http.server 是因 Python 包未完整安装,需执行 pkg install python 并验证 import http.server;若仍失败可换源重装,或改用 busybox httpd(需确保有 index.html 且路径为绝对路径);注意绑定 0.0.0.0:8080 并用手机 IP 访问,避免使用已废弃的 termux-web-server。

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 分区。











