Repolode
提交项目
HuolalaTech

HuolalaTech/page-spy-web

可自托管的远程调试网页端，用于查看远程设备上页面的控制台输出与数据，需配合 PageSpy SDK 使用。

在 GitHub 查看官网
Star
5,635
Fork
357
未关闭 Issue
53
最近提交
2个月前

这是什么？

PageSpy 是一款远程调试工具，适用于 Web 页面、React Native、小程序和鸿蒙应用。客户端 SDK 封装原生的 console 等接口，对传入参数进行过滤和序列化后发送给调试端，调试端以类似本地浏览器开发者工具控制台的界面展示数据。

本仓库是该系统的网页端与服务端。可通过 @huolala-tech/page-spy-api 包在本地用 Node.js 直接启动，也可以使用 Docker 部署，服务默认监听 6752 端口。日志和数据保存在挂载的目录中，服务可以部署在自有服务器上。

适合本地开发者工具无法使用的场景，例如在移动端 WebView 中调试、跨地区协作复现问题，或排查终端用户设备上的白屏问题。

核心功能

  • 01通过 SDK 封装原生 console 等接口，支持 Web、React Native、小程序和鸿蒙应用。
  • 02以类似本地开发者工具控制台的界面展示远程日志。
  • 03支持通过 npm 安装的 Node.js 方式或 Docker 方式部署。
  • 04日志与数据保存在自有服务器上。

适用场景

  • 在手机上调试 H5 页面或 WebView，本地开发者工具不便使用时。
  • 跨地区协作时，让远程同事复现并查看问题细节。
  • 排查用户终端上报的白屏问题。

快速上手

  1. 1

    使用 npm 或 yarn 全局安装 API 服务

    npm install -g @huolala-tech/page-spy-api@latest
  2. 2

    在终端中启动服务

    page-spy-api
  3. 3

    在浏览器中打开 localhost 的 6752 端口

使用前须知

  • 自托管需要自行运行 Node.js 服务或 Docker 容器。
  • 远程调试需要在被调试的页面或应用中接入对应的 PageSpy SDK。

收录于专题

自托管应用

标签

#remote-debugging#console#devtools#webview#self-hosted#javascript#mini-program#debugger#remote-control

常见问题

page-spy-web 是什么？
可自托管的远程调试网页端，用于查看远程设备上页面的控制台输出与数据，需配合 PageSpy SDK 使用。 PageSpy 是一款远程调试工具，适用于 Web 页面、React Native、小程序和鸿蒙应用。客户端 SDK 封装原生的 console 等接口，对传入参数进行过滤和序列化后发送给调试端，调试端以类似本地浏览器开发者工具控制台的界面展示数据。
page-spy-web 可以免费使用吗？用的什么许可证？
page-spy-web 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
page-spy-web 还在维护吗？
半年内有更新。page-spy-web 最近一次提交是在 2026年9月18日。
page-spy-web 适合用来做什么？
在手机上调试 H5 页面或 WebView，本地开发者工具不便使用时。 跨地区协作时，让远程同事复现并查看问题细节。 排查用户终端上报的白屏问题。
page-spy-web 怎么安装和运行？
使用 npm 或 yarn 全局安装 API 服务: npm install -g @huolala-tech/page-spy-api@latest 在终端中启动服务: page-spy-api 在浏览器中打开 localhost 的 6752 端口
在哪里获取 page-spy-web？
源代码和安装说明在 GitHub 上：https://github.com/HuolalaTech/page-spy-web

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目