如何让手机连上服务器

用 uvx、pip 或源码运行时，服务器默认只在本机的 127.0.0.1:8770 上监听；用 Docker Compose 时端口发布在所有网卡上。手机要上传录音，就得能访问到它。这篇按网络情况分两种做法。

App 版本

App 从 apk-v1.5.1 起能连 http:// 地址：在 Tailscale 或局域网里直接填 http:// 地址即可（iOS 自己构建的 App 同样，见如何安装并连接手机 App）。更早的 APK（1.5.0 及之前）只能连 https://，请升级，或按下面的手机要从公网访问做。

手机和服务器在同一个 Tailscale 网络或局域网里

1. 让服务器在 Tailscale 或局域网地址上可访问。

   • Docker：docker-compose.yml 已经把端口发布在所有网卡上，不用改。只想发布在 Tailscale 地址上时，把端口那一行改成下面这样，再 docker compose up -d：

     ports:
       - "100.x.y.z:8770:8770"  # 只在这台机器的 Tailscale 地址上

   • 不用 Docker：在 .env 里设 HOST=0.0.0.0，重启服务器。

2. 在电脑浏览器里，用手机将要用的地址打开网页，比如 http://100.x.y.z:8770/?token=<你的 token>（Tailscale 地址）或 http://192.168.1.10:8770/?token=<你的 token>（局域网地址）。

3. 打开 连接手机（/connect），用 App 扫码。二维码里的服务器地址是「手机用哪个地址」里选中的那个：用 127.0.0.1 打开网页时，默认选服务器找到的第一个 Tailscale 或局域网地址。服务器跑在 Docker 里时看不到电脑的网卡，列表里只有这个页面自己的地址：用电脑的局域网或 Tailscale 地址打开网页，或者选「自己填」。

手机要从公网访问

1. 在 8770 端口前面放一个带 TLS 的反向代理，比如 Caddy、nginx、Cloudflare Tunnel 或 Tailscale Serve。代理要转发 WebSocket（网页用 /ws 接收推送）。
2. 代理的健康检查用 GET /api/health：它不需要 token，返回 {"ok":true}。
3. 用 https://<你的域名>/?token=<你的 token> 打开网页，再到 连接手机 扫码。

不要把 token 为空的服务器暴露出去：那样任何人都能读写你的数据。

用 nginx 时，它默认只收 1 MB 以内的请求体（client_max_body_size），导入较大的录音文件会被拒绝（413），需要调大。