Streamlit MVP局域网访问 Ngrok 公网穿透 综合操作手册适用 MVP项目本地v11.py端口 8501局域网用于同 WiFi 手机快速测试Ngrok 公网 HTTPS 用于微信小程序 web-view前置条件Python 环境正常streamlit run v11.py本地127.0.0.1:8501可打开一、启动 Streamlit 服务固定命令局域网 / 公网共用这个服务打开普通 PowerShell非管理员进入项目目录powershellcd F:\MVP\tourguideMVP\v3 streamlit run v11.py --server.address 0.0.0.0 --server.port 8501--server.address 0.0.0.0允许局域网内其他设备连接本机端口关键参数只写 127.0.0.1 则只能本机访问保持这个窗口全程不要关闭关闭服务立刻停止✅ 验证端口监听新开 PowerShell 执行powershellnetstat -ano | findstr :8501出现TCP 0.0.0.0:8501 LISTENING→ 服务就绪二、局域网访问配置同 WiFi 手机 / 电脑访问仅内网可用小程序不能直接用内网 IP步骤 1Windows 防火墙放行 8501 端口入站规则方式 1图形界面推荐规避管理员权限报错Win 搜索Windows Defender防火墙→ 高级设置 →入站规则→ 新建规则类型端口 → TCP → 特定本地端口8501操作允许连接配置文件域、专用、公网全部勾选名称Streamlit-8501完成方式 2管理员 PowerShell 命令右键开始菜单 → Windows PowerShell (管理员)UAC 点是执行powershellNew-NetFirewallRule -DisplayName Streamlit-8501 -Direction Inbound -LocalPort 8501 -Protocol TCP -Action Allow步骤 2获取本机局域网 IPpowershellipconfig找到WLAN 无线网卡下的IPv4地址是第一个示例192.168.1.106步骤 3局域网访问地址电脑局域网访问http://192.168.1.106:8501手机连接同一个 WiFi打开手机自带浏览器输入上面地址❗注意微信内置浏览器 / 夸克会拦截内网地址手机测试用系统自带浏览器。 ⚠️ 限制内网 IP只能在同一个 WiFi 下使用外网 / 微信小程序 web-view 无法访问内网地址小程序必须公网 HTTPS 链接。三、Ngrok 公网穿透生成 HTTPS 公网地址用于微信小程序 web-view作用把本地 8501 端口暴露到公网自动生成 HTTPS 链接满足小程序 web-view 强制 HTTPS 要求 前置下载 ngrok把 ngrok.exe 放到项目目录注册 ngrok 账号配置 authtoken1. 一次性配置 authtoken只需要做一次powershellngrok config add-authtoken 【你的ngrok授权令牌】2. 新开独立 PowerShell 窗口⚠️不要关掉 streamlit 那个窗口进入项目目录执行穿透命令powershellcd 项目目录 ngrok http 8501启动成功后控制台会输出类似内容plaintextForwarding https://abc123.ngrok.io - http://localhost:8501https://abc123.ngrok.io就是小程序 web-view 要用的公网 HTTPS 地址两个窗口都必须保持打开①streamlit 窗口②ngrok 窗口任意关闭一个公网链接失效Ngrok 重要限制小程序开发必看免费版 ngrok 域名每次重启都会变如果长期使用需要付费固定子域名免费版带宽、并发有限适合 MVP 原型测试不适合正式上线交付客户小程序后台【开发管理 - 开发设置 - 业务域名】需要添加 ngrok 域名否则 web-view 打不开四、两套环境快速切换使用说明表格模式地址可用范围用途小程序是否可用局域网http://192.168.x.x:8501同一 WiFi 内设备手机快速原型测试、调 UI❌ 不可用Ngrok 公网 HTTPShttps://xxx.ngrok.io全网任何网络微信小程序 web-view 调试、外网演示✅ 可用五、小程序 web-view 基础代码片段微信开发者工具wxmlweb-view srchttps://abc123.ngrok.io/web-view配套操作微信小程序后台业务域名填入 ngrok 域名校验域名。六、故障排查清单局域网打不开检查防火墙入站规则、电脑手机同 WiFi、streamlit 启动参数--server.address 0.0.0.0ngrok 页面打不开确认 streamlit 窗口存活检查本地 127.0.0.1:8501 可访问小程序 web-view 空白①域名没加到小程序业务域名②http 协议不行必须 ngrok 的 https 链接七、后续升级路线MVP 商业化备选Ngrok 仅适合原型测试正式上线方案把 v11 部署到云服务器阿里云 / 腾讯云安装 streamlitdocker云服务器开放 8501配置域名 SSL 证书获得永久 HTTPS 地址替代 ngrok 临时隧道。