更新记录

1.0.1（2026-08-08） 下载此版本

修复打包失败问题

1.0.0（2026-08-06） 下载此版本

检测APP是否开启代理的功能插件

平台兼容性

uni-app(4.56)

uni-app x(4.57)

losfer-capture 抓包/代理检测插件

检测客户端是否存在抓包行为或代理设置，帮助应用识别潜在的安全风险。

平台兼容性

检测能力

引入方式

import { detectCapture, detectCaptureSync, CaptureDetectResult } from '@/uni_modules/losfer-capture'

API

detectCaptureSync()

同步执行检测，直接返回结果。

返回值

示例

import { detectCaptureSync } from '@/uni_modules/losfer-capture'

const result = detectCaptureSync()
console.log('风险等级: ' + result.riskLevel)
console.log('风险描述: ' + result.riskDesc)
console.log('是否有代理: ' + result.hasProxy)
console.log('是否有VPN: ' + result.hasVpn)
console.log('是否有抓包工具: ' + result.hasCaptureTool)

detectCapture(options)

异步执行检测，通过回调返回结果。

参数

示例

import { detectCapture } from '@/uni_modules/losfer-capture'

detectCapture({
  checkVpn: true,
  checkDebuggable: true,
  checkCaptureTool: true,
  success: (res) => {
    console.log('风险等级: ' + res.riskLevel)
    console.log('风险描述: ' + res.riskDesc)
    if (res.riskLevel >= 2) {
      // 中高风险处理
      uni.showModal({
        title: '安全警告',
        content: res.riskDesc,
        showCancel: false
      })
    }
  },
  fail: (err) => {
    console.log('检测失败: ' + err.errMsg)
  },
  complete: () => {
    console.log('检测完成')
  }
})

风险等级说明

实际使用示例

应用启动时检测

import { detectCaptureSync } from '@/uni_modules/losfer-capture'

onLaunch(() => {
  // #ifdef APP
  const result = detectCaptureSync()
  if (result.riskLevel >= 3) {
    // 高风险：检测到抓包工具，退出应用
    uni.showModal({
      title: '安全警告',
      content: '检测到抓包工具，应用无法继续运行',
      showCancel: false,
      success: () => {
        plus.runtime.quit()
      }
    })
  }
  // #endif
})

页面中按需检测

import { detectCaptureSync } from '@/uni_modules/losfer-capture'

function checkSecurity() {
  // #ifdef APP
  const result = detectCaptureSync()
  if (result.hasProxy) {
    console.log('代理地址: ' + result.proxyHost + ':' + result.proxyPort)
  }
  if (result.hasVpn) {
    console.log('检测到VPN连接')
  }
  // #endif
  // #ifndef APP
  console.log('仅APP端支持抓包检测')
  // #endif
}

错误码

注意事项

1. 本插件仅支持 APP 端（Android/iOS），Web 和小程序端不支持。
2. VPN检测在iOS上能力有限，因系统沙盒限制无法直接访问网络接口信息。
3. 抓包工具检测基于已知包名/URL Scheme列表，无法覆盖所有工具。
4. 检测结果仅供参考，无法100%防止抓包，建议配合SSL Pinning等方案使用。
5. detectCaptureSync 为同步方法，检测过程很快，可在主线程直接调用。