如何用PHP解析v3版Tor洋葱地址提取公钥、校验和与版本信息

v3版Tor洋葱地址是Tor网络目前主流的服务标识格式，采用56位Base32编码字符串，末尾固定为.onion后缀，内部编码了服务的公钥、校验和以及版本信息。解析这类地址需要先了解其编码结构，再通过PHP实现解码和提取逻辑。

v3版洋葱地址结构说明

完整的v3洋葱地址去掉.onion后缀后，剩余56位Base32字符，解码后得到35字节的二进制数据，各部分结构如下：

PHP解析实现步骤

1. 地址格式校验

首先校验输入的地址是否符合v3洋葱地址的基本格式，包括后缀是否为.onion，去掉后缀后的长度是否为56位。

<?php
function validateV3OnionAddress($address) {
    // 检查是否以.onion结尾
    if (substr($address, -6) !== '.onion') {
        return false;
    }
    // 提取地址主体部分
    $body = substr($address, 0, -6);
    // v3版本主体长度为56
    if (strlen($body) !== 56) {
        return false;
    }
    // 检查是否为合法Base32字符（A-Z2-7）
    if (!preg_match('/^[A-Z2-7]+$/', $body)) {
        return false;
    }
    return $body;
}
?>

2. Base32解码

v3洋葱地址使用标准的Base32编码，需要将56位Base32字符串解码为35字节的二进制数据，PHP没有内置Base32解码函数，需要手动实现。

<?php
function base32Decode($input) {
    $base32Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
    $charMap = array_flip(str_split($base32Chars));
    $input = strtoupper($input);
    $binary = '';
    $buffer = 0;
    $bufferBits = 0;
    for ($i = 0; $i < strlen($input); $i++) {
        $char = $input[$i];
        if (!isset($charMap[$char])) {
            return false;
        }
        $buffer = ($buffer << 5) | $charMap[$char];
        $bufferBits += 5;
        while ($bufferBits >= 8) {
            $bufferBits -= 8;
            $binary .= chr(($buffer >> $bufferBits) & 0xFF);
        }
    }
    return $binary;
}
?>

3. 提取各部分数据

解码得到35字节数据后，按照结构分段提取公钥、校验和和版本信息。

<?php
function parseV3Onion($address) {
    $body = validateV3OnionAddress($address);
    if (!$body) {
        return ['error' => '无效的v3洋葱地址格式'];
    }
    // Base32解码
    $binary = base32Decode($body);
    if ($binary === false || strlen($binary) !== 35) {
        return ['error' => '地址解码失败'];
    }
    // 提取公钥（前32字节）
    $publicKey = substr($binary, 0, 32);
    // 提取校验和（第33-34字节）
    $checksum = substr($binary, 32, 2);
    // 提取版本信息（第35字节）
    $version = ord(substr($binary, 34, 1));
    return [
        'public_key' => bin2hex($publicKey),
        'checksum' => bin2hex($checksum),
        'version' => $version,
        'is_valid_version' => $version === 3
    ];
}
?>

4. 校验和验证

校验和的计算规则是对公钥和固定字符串".onion checksum"以及版本号进行SHA3-256哈希，取前两个字节。可以通过计算验证地址的合法性。

<?php
function verifyOnionChecksum($publicKeyBinary, $version, $checksumBinary) {
    // 构造校验用字符串：公钥 + ".onion checksum" + 版本字节
    $checkStr = $publicKeyBinary . '.onion checksum' . chr($version);
    // 计算SHA3-256哈希（需要PHP 7.1+支持sha3算法）
    $hash = hash('sha3-256', $checkStr, true);
    // 取哈希的前两个字节与校验和对比
    $calcChecksum = substr($hash, 0, 2);
    return $calcChecksum === $checksumBinary;
}
?>

完整使用示例

将上述函数组合使用，即可完成完整的解析和校验流程。

<?php
$onionAddress = '2gzyxa5ihm7nsggfxnu52rck2vv4rvmdlkiu3zzui5du4xyclen53wid.onion';
$result = parseV3Onion($onionAddress);
if (isset($result['error'])) {
    echo "解析失败：" . $result['error'];
} else {
    echo "公钥（十六进制）：" . $result['public_key'] . "<br/>";
    echo "校验和（十六进制）：" . $result['checksum'] . "<br/>";
    echo "版本号：" . $result['version'] . "<br/>";
    echo "是否为v3版本：" . ($result['is_valid_version'] ? '是' : '否') . "<br/>";
    // 验证校验和
    $publicKeyBinary = hex2bin($result['public_key']);
    $checksumBinary = hex2bin($result['checksum']);
    $isValid = verifyOnionChecksum($publicKeyBinary, $result['version'], $checksumBinary);
    echo "校验和验证结果：" . ($isValid ? '合法' : '不合法');
}
?>

注意事项

• PHP环境需要支持SHA3-256哈希算法，若不支持可以自行实现或使用第三方扩展
• Base32解码时需要注意处理填充字符，v3洋葱地址无填充，无需处理=号
• 提取的公钥为原始二进制数据，可根据需要转换为十六进制或其他格式存储

PHPTor_v3洋葱地址公钥提取校验和计算版本信息解析修改时间：2026-06-04 06:50:43