第 16 章：微型服务器——在手机里开一个网站
微型服务器 = 在你手机里开一个小型网站服务器。最典型的用途：预览你自己做的网站 / 文档站 / 前端项目，改完立刻看效果。
预计阅读 10 分钟。
16.1 这是什么？——用大白话理解
- 它的"根目录"是当前工作区文件夹；
- 启动后，你（或局域网里的设备）可以通过浏览器访问手机上的网页；
- 用于调试 html / javascript / css 网站项目，支持局域网访问。
16.2 使用流程：五步走
- 让 AI 启动服务器：对 AI 说「启动微型服务器，端口 8080」（它会调用内置工具，可能弹确认）；
- 获取地址：AI 会返回本机地址（如
http://127.0.0.1:8080/）和局域网地址（如http://192.168.x.x:8080/）； - 打开预览：在手机浏览器里打开地址，就能看到你的网站；
- 出问题看日志：让 AI「看看服务器日志」，排查 404、加载失败、JS 报错；
- 用完关闭：对 AI 说「关闭微型服务器」。
新手示例
你刚用 AI 做了一个 index.html 放在工作区，就可以说： 「启动微型服务器，然后我预览一下 index.html」
提示
复杂网站推荐让 AI 在 Termux 中配置环境和服务器启动（见第 13 章「命令执行」）。
16.3 配置项一览（先不用背，看懂就行）
| 配置 | 作用 | 安全提醒 |
|---|---|---|
| host | 127.0.0.1=只有本机能访问；0.0.0.0=局域网都能访问 | 暴露后别人能访问你的网页 |
| port | 服务器端口（如 8080） | 端口冲突会启动失败 |
| username/password | 访问密码（Basic 认证） | 不设密码 = 谁都能打开 |
| protocol | HTTP 或 HTTPS | HTTP 是明文，别放敏感信息 |
| TLS 证书/私钥 | HTTPS 需要的证书 | 自签证书浏览器会警告 |
| force_https | 强制跳转 HTTPS | 需先配好证书 |
| spa_fallback | 单页应用（Vue/React）刷新 404 时回退首页 | 适合前端项目 |
| mdns | 局域网自动发现名称 | 方便同网设备找到 |
16.4 出问题怎么排查？
- 404（页面找不到）：先看日志里的请求路径，确认文件存在、大小写一致；
- 认证失败：检查用户名密码是否和设置一致；
- JS 报错：日志会记录页面脚本错误，先修脚本问题；
- 改动不生效：浏览器缓存了旧页面，强制刷新（清除缓存/重新加载）；
- SPA 刷新 404：开启
spa_fallback； - 预览 VitePress/Vite 项目：先构建出静态文件（
build），再启动服务器指向产物目录。
安全红线
把服务器绑定到 0.0.0.0、内网穿透或公网之前，务必检查：服务目录里有没有敏感文件？设密码了吗？开 HTTPS 了吗？没有就绑 127.0.0.1。
16.5 新手 FAQ
Q：为什么局域网设备打不开？ A：① 服务器绑定的是 0.0.0.0 吗（127.0.0.1 只允许本机）；② 两台设备在同一 WiFi 吗；③ 手机防火墙/路由器拦截了吗。
Q：服务器启动失败/端口被占用？ A：换一个端口（比如 8080 换成 9000）再启动。
Q：能拿它做正式网站吗？ A：它是本地预览工具，不是生产服务器。正式上线请用云服务器。
本章完 · 下一章：定时任务与后台任务——让 AI 到点自动干活