Appearance
社区团购的团长到底在不在本小区?用 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。