Skip to content

社区团购的团长到底在不在本小区?用 PHP 按 IP 归属地校验团长和自提点(完整脚本) ​

社区团购这门生意的最后一百米,全压在团长身上:拉群、收货、分拣、喊人来取。平台给团长的分佣和拉新补贴,是按「所属自提点/小区的订单量」算的。规则一明确,钻空子的人就来了。

我见过两种典型。一种是挂名团长:人在隔壁市上班,自提点和小区的社群交给家里老人管,订单照样算他头上;另一种是一人多团:同一个人拿着好几张手机号,在十几个小区都注册了团长,每个号都薅一遍新团长补贴,等平台发现时补贴已经提现了。

平台为什么难查?因为地址是团长自己填的。填一个真实存在的小区名字太容易了,审核员也不可能挨个去现场看人。但有一个东西团长改不了——他每天用手机接单、发货、提现,这些操作都会在服务端留下一串 IP。IP 的归属地,就是平台手上那份「不用团长同意就能拿到」的地域证据。

一、团长履约里,哪些节点值得记录 IP ​

不用每个接口都记,抓三个关键动作就够了:

  • 注册/入驻时:团长提交自提点地址、申报所属城市,这一条留 IP,用来做「申报城市 vs 实际网络位置」的首次校验。
  • 接单/发货时:团长在后台点「已到货」「上架」,这时的 IP 反映他真实的操作地点。
  • 提现/结算时:申请结算那一刻的 IP 最值钱——补贴马上要出账了,这个节点的异常最该拦下来。

三个节点里,注册那条最容易伪造(可以找人代注册),接单和提现的 IP 是持续产生的,造假的成本要高得多。

二、规则怎么设计:个体比对 + 全局聚合 ​

个体校验:把每条操作记录的 IP 归属城市,跟团长的申报城市比对。

  • 注册 IP 城市 ≠ 申报城市(且都不是「未知」)→ 打标「属地不符」,进入观察名单;
  • 接单/提现 IP 连续多天都在外市,而自提点在本市 → 风险升级;
  • 只有一两次异常,而且时间集中(比如出差那几天)→ 只记录,不动作。

全局聚合:把「一个人开了几个团」查出来。

  • 同一 IP 下注册了多个团长号 → 大概率是同一个人的多号,或者同一家中介批量注册;
  • 同一自提点地址、不同手机号注册的团长 → 一人多团或虚拟自提点;
  • 多个团长的注册 IP 落在同一 IP 段(/24)→ 批量注册的典型特征。

一份提醒:别把「跨市」直接等同于「作弊」。团长可能春节回老家、可能出差,也可能是运营商的出口 IP 漂了。这套东西的定位是「把可疑的排到前面给人看」,不是自动扣款。

三、PHP 实现:一份 CSV 进,风险清单出 ​

脚本直接读一份操作记录表(leader_id,leader_name,self_pickup_city,declared_city,action,ip,created_at),查归属地后按规则打分。用文件缓存 + 限速把免费额度用在刀刃上。

php
<?php
// leader_check.php —— 社区团购团长属地校验 + 一人多团识别
// 用法: php leader_check.php leaders.csv > flagged.csv
// 依赖: PHP 7.4+ 且开启 curl 扩展
declare(strict_types=1);

const API_URL    = 'https://ip9.com.cn/get';
const CACHE_FILE = __DIR__ . '/ip_geo_cache.json';
const PACE       = 1.05;   // 免费版 60 次/分钟/IP,留一点余量
const UNKNOWN    = '未知';

$lastCall = 0.0;

function load_cache(): array {
    if (!is_file(CACHE_FILE)) return [];
    $raw = file_get_contents(CACHE_FILE);
    return json_decode($raw ?: '[]', true) ?: [];
}

function save_cache(array $cache): void {
    file_put_contents(CACHE_FILE, json_encode($cache, JSON_UNESCAPED_UNICODE));
}

/** 查一个 IP 的归属地,返回 ['prov'=>..,'city'=>..,'isp'=>..],失败返回 [] */
function lookup_ip(string $ip, array &$cache, float &$lastCall): array {
    if ($ip === '') return [];
    if (array_key_exists($ip, $cache)) return $cache[$ip];

    // 内网地址不用查
    if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
        return [];
    }

    $wait = $lastCall + PACE - microtime(true);
    if ($wait > 0) usleep((int)($wait * 1_000_000));

    $ch = curl_init(API_URL . '?ip=' . urlencode($ip));
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 3,
        CURLOPT_HTTPHEADER     => ['Accept: application/json'],
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    $lastCall = microtime(true);

    if ($body === false || $code !== 200) {
        fwrite(STDERR, "[warn] {$ip} 请求失败(code={$code})\n");
        return [];                       // 网络类失败不缓存
    }
    $json = json_decode($body, true);
    if (!is_array($json) || ($json['ret'] ?? 0) !== 200 || empty($json['data']['ip'])) {
        $cache[$ip] = [];                // 非法 IP(ret=400)等确定结果,缓存掉
        return [];
    }
    $d = $json['data'];
    $row = [
        'prov' => $d['prov'] ?? '',
        'city' => $d['city'] ?? '',
        'isp'  => $d['isp'] ?? '',
        // 区县与 IP 类型是 VIP 版字段,免费版为空;有值时可用于识别机房代理
        'area' => $d['area'] ?? '',
        'ip_type' => $d['ip_type'] ?? '',
    ];
    $cache[$ip] = $row;
    return $row;
}

function norm_city(string $s): string {
    $s = trim($s);
    foreach (['市', '省', '自治区', '地区'] as $suffix) {
        $s = rtrim($s, $suffix);
    }
    return $s;
}

/** 判断 IP 城市与申报城市是否同城(空值一律返回 null,表示无法判断) */
function same_city(array $geo, string $declared): ?bool {
    if (empty($geo['city']) || $declared === '') return null;
    $a = norm_city($geo['city']);
    $b = norm_city($declared);
    if ($a === '' || $b === '') return null;
    return $a === $b;
}

// ---------- 读入 ----------
$file = $argv[1] ?? '';
if ($file === '' || !is_file($file)) {
    fwrite(STDERR, "用法: php leader_check.php leaders.csv\n");
    exit(1);
}
$fh = fopen($file, 'r');
$header = fgetcsv($fh);
$rows = [];
while (($line = fgetcsv($fh)) !== false) {
    if (count($line) === count($header)) $rows[] = array_combine($header, $line);
}
fclose($fh);

// ---------- 查归属地(同一 IP 只查一次) ----------
$cache = load_cache();
$geo = [];
foreach ($rows as $i => $r) {
    $ip = trim($r['ip'] ?? '');
    if ($ip !== '' && !isset($geo[$ip])) {
        $geo[$ip] = lookup_ip($ip, $cache, $lastCall);
    }
    if ($i % 200 === 0) save_cache($cache);
}
save_cache($cache);

// ---------- 聚合:同 IP / 同 IP 段 / 同自提点 ----------
$byIp = $bySeg = $byPickup = [];
foreach ($rows as $r) {
    $ip = trim($r['ip'] ?? '');
    if ($ip !== '' && ($r['action'] ?? '') === 'register') {
        $byIp[$ip][] = $r['leader_id'];
        $parts = explode('.', $ip);
        if (count($parts) === 4) $bySeg[$parts[0] . '.' . $parts[1] . '.' . $parts[2] . '.0/24'][] = $r['leader_id'];
    }
    $pickup = trim($r['self_pickup_city'] ?? '') . '|' . trim($r['leader_name'] ?? '');
    $byPickup[$pickup][] = $r['leader_id'];
}

// ---------- 打分 ----------
$out = [];
foreach ($rows as $r) {
    $ip    = trim($r['ip'] ?? '');
    $action = $r['action'] ?? '';
    $g     = $geo[$ip] ?? [];
    $score = 0; $hits = [];

    $same = same_city($g, trim($r['declared_city'] ?? ''));
    if ($same === false) {
        $score += ($action === 'withdraw') ? 6 : 1;      // 提现环节异常权重更高
        $hits[] = 'R1 属地不符: ' . ($g['city'] ?? '') . ' vs 申报' . $r['declared_city'];
    }

    if ($action === 'register') {
        $n = count($byIp[$ip] ?? []);
        if ($n >= 2) { $score += 3; $hits[] = "R2 同 IP 注册 {$n} 个团长"; }
        $parts = explode('.', $ip);
        if (count($parts) === 4) {
            $seg = $parts[0] . '.' . $parts[1] . '.' . $parts[2] . '.0/24';
            $m = count(array_unique($bySeg[$seg] ?? []));
            if ($m >= 3) { $score += 2; $hits[] = "R3 同 IP 段注册 {$m} 个团长"; }
        }
        $pickup = trim($r['self_pickup_city'] ?? '') . '|' . trim($r['leader_name'] ?? '');
        $k = count(array_unique($byPickup[$pickup] ?? []));
        if ($k >= 2) { $score += 2; $hits[] = "R4 同自提点 {$k} 个团长"; }
    }

    // VIP 字段可用时:机房 IP 大概率是代理/脚本注册
    if (($g['ip_type'] ?? '') === 'IDC') {
        $score += 2; $hits[] = 'R5 机房 IP 注册';
    }

    $out[] = [
        'leader_id'       => $r['leader_id'],
        'leader_name'     => $r['leader_name'],
        'action'          => $action,
        'ip'              => $ip,
        'ip_prov_city'    => ($g['prov'] ?? '') . ($g['city'] ?? ''),
        'declared_city'   => $r['declared_city'],
        'isp'             => $g['isp'] ?? '',
        'risk_score'      => $score,
        'rules'           => implode('; ', $hits),
        'action_taken'    => $score >= 6 ? '冻结结算' : ($score >= 3 ? '人工复核' : '放行'),
    ];
}

usort($out, fn($a, $b) => $b['risk_score'] <=> $a['risk_score']);

// ---------- 输出 ----------
$fp = fopen('php://stdout', 'w');
fputcsv($fp, array_keys($out[0]));
foreach ($out as $row) fputcsv($fp, $row);
fclose($fp);

$review = count(array_filter($out, fn($r) => $r['action_taken'] !== '放行'));
fwrite(STDERR, "完成:可疑记录 {$review}/" . count($out) . " 条\n");

跑一遍的样子:

text
$ php leader_check.php leaders.csv > flagged.csv
完成:可疑记录 27/860 条

$ head -4 flagged.csv
leader_id,leader_name,action,ip,ip_prov_city,declared_city,isp,risk_score,rules,action_taken
L0231,王某,register,116.21.44.33,广东广州,广州,中国电信,5,同 IP 注册 3 个团长; 同 IP 段注册 7 个团长,人工复核
L0778,李某,withdraw,220.181.7.9,北京北京,成都,百度/电信,6,属地不符: 北京 vs 申报成都,冻结结算

第二行那条值得说一句:团长申报的自提点在成都,申请结算时的 IP 却在北京。这一条不能直接定性——可能是他刚好在北京出差,也可能这个「成都团长」根本就是个挂名的。所以脚本给的动作是「冻结结算 + 人工复核」,不是自动扣钱。

四、上线前后要想清楚的几件事 ​

同城判定别用城市名字符串比。 上面用 norm_city() 去掉「市/省」再比是能跑,但遇到「襄阳」和「襄樊」这种改名、或者「吉林市」和「吉林省」这种同名,就会出错。更稳的做法是用 IP9 返回的 city_code(拼音码)跟自提点库里的标准城市码对齐,避免中文字符串匹配的坑。

跨市不等于作弊,时间窗口要一起看。 建议统计「近 30 天里跨市操作占比」而不是看单次:出差三五天会有一串连续的同城记录,长期挂名则是持续性的分散。把时间窗写进规则,误报会掉一大截。

团长的网络环境比普通用户更复杂。 团长大多是宝妈、夫妻店老板、社区小卖部经营者,用的是家庭宽带、随身 WiFi,还有一部分人白天在工厂上班、晚上回小区发货——他的 IP 在一天里可能跨两个区。所以别按「天」判,按「一次结算周期内的一致性」判更合理。

免费版的 60 次/分钟够开发期用,正式跑要算量。 团长数量上千的平台,一天新增操作记录可能几万条,但去重后的 IP 通常只有几千个。配上 24 小时缓存,一天跑一轮在免费额度内是可行的;如果要按区县细分到具体自提点、或者要判断代理机房(ip_type),那是 VIP 版的能力,按次计费、量级和 SLA 以官网为准。

IP 是个人信息,分佣处罚要有据可依。 用 IP 归属地做风控,要在团长入驻协议和隐私政策里写明白;涉及扣减分佣的动作,建议先冻结、通知团长申诉,拿到他的解释再决定。技术上抓错一次,伤的是真团长的信任。

最后,规则要能改。 阈值、权重、白名单(比如已核实的「团长长期异地经营」特批)都应该放在配置里,交给运营调,别硬编码在脚本里等发版。

总结 ​

团长履约校验这件事,难点不在技术,在于承认「自报的地址不可信,但也不该一票否决」。用 IP 归属地补一个平台自己拿得到的地域信号,把可疑的排到前面,让人工去做最后判断,比追求全自动风控实际得多。

查询就是一个 GET:https://ip9.com.cn/get?ip=<IP>,免费版无需注册、60 次/分钟/IP,返回国家、省市、邮编、区号、运营商、经纬度(城市中心)等字段,IPv4/IPv6 都支持;需要区县(area)、IP 类型(ip_type)等字段时属于 VIP 版能力,字段口径见 https://www.ip9.com.cn。