解析V3洋葱域名:技术指南与PHP实现

胖丽君_4353

胖丽君_4353

2025-11-20

1120人浏览

原创

解析V3洋葱域名:技术指南与PHP实现

本教程详细阐述了如何解析v3洋葱域名,以提取其核心组成部分:公钥、校验和及版本号。文章首先介绍了v3洋葱域名的结构规范,随后提供了基于php的编程实现步骤,包括base32解码、字节截取和校验和验证。通过具体示例代码,读者将学习如何从`.onion`地址中安全有效地提取这些关键信息,并理解校验和在确保域名完整性中的重要作用。

V3洋葱域名结构概述

V3洋葱域名(.onion地址)是Tor网络中隐藏服务的一种标识符,其设计旨在提供更高的安全性和可扩展性。一个V3洋葱地址并非随机字符串,而是由隐藏服务的身份公钥、一个版本字段和一个基本校验和经过Base32编码后生成。理解其内部结构是进行程序化解析的基础。

根据Tor项目规范(rend-spec-v3.txt,第4.3.6节),V3洋葱地址的结构定义如下:

onion_address = base32(PUBKEY | CHECKSUM | VERSION) + ".onion"

其中各组成部分的含义及长度为:

  • PUBKEY (公钥):32字节的Ed25519主公钥,用于标识隐藏服务。
  • CHECKSUM (校验和):2字节的校验和,用于验证地址的完整性。它的计算方式为 H(".onion checksum" | PUBKEY | VERSION) 的前两个字节。这里的 H 是一个哈希函数(在Tor的实现中通常是SHA3-256)。
  • VERSION (版本):1字节的版本字段,当前V3地址的默认值为 \x03。

将这三个部分按顺序连接(PUBKEY | CHECKSUM | VERSION)形成一个35字节的二进制串,然后对该串进行Base32编码,最后加上.onion后缀,便构成了完整的V3洋葱地址。

Bruno Git-Native API Client for Testing and Exploration
Bruno Git-Native API Client for Testing and Exploration

Bruno 是一个开源的、离线优先的 API 客户端,它将集合存储为文件系统上的纯文本 .bru 文件。它提供了一种注重隐私、与 Git 友好的替代方案,可用于替代 Postman 和 Insomnia,无需云同步且无需账户。

下载

解析V3洋葱域名的步骤

要从一个V3洋葱域名中提取公钥、校验和和版本号,主要需要经过以下几个步骤:

  1. 移除.onion后缀:首先从完整的洋葱地址中去除末尾的.onion字符串,得到Base32编码的核心部分。
  2. Base32解码:对剩余的Base32编码字符串进行解码,将其转换回原始的二进制数据。解码后的数据长度应为35字节。
  3. 字节截取:根据V3洋葱地址的结构定义,从解码后的35字节二进制数据中截取各个组成部分:
    • 公钥 (PUBKEY):前32个字节。
    • 校验和 (CHECKSUM):第33和第34个字节。
    • 版本 (VERSION):最后一个字节(即第35个字节)。
  4. 校验和验证(可选但推荐):为了确保解析出的数据是有效的且地址未被篡改,强烈建议重新计算校验和并与提取出的校验和进行比对。

PHP实现示例

以下PHP代码演示了如何解析V3洋葱域名并提取其组成部分。本示例假设您已经有一个可用的Base32解码器。

<?php // 假设这里有一个Base32解码器类或函数
// 实际应用中,您需要引入一个成熟的Base32库,例如 https://github.com/base32/base32
class Base32
{
    private static $map = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';

    public static function decode(string $input): string
    {
        $input = strtoupper($input);
        $buffer = '';
        $bits = 0;
        $value = 0;

        for ($i = 0; $i < strlen($input); $i++) {
            $char = $input[$i];
            $pos = strpos(self::$map, $char);

            if ($pos === false) {
                // Skip invalid characters, or throw an error
                continue;
            }

            $value = ($value << 5) | $pos;
            $bits += 5;

            if ($bits >= 8) {
                $bits -= 8;
                $buffer .= chr(($value >> $bits) & 0xFF);
            }
        }
        return $buffer;
    }
}

/**
 * 解析V3洋葱域名,提取公钥、校验和和版本号。
 *
 * @param string $onionAddress 完整的V3洋葱域名,例如 "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion"
 * @return array|null 包含 'publicKey', 'checksum', 'version' 的关联数组,或在解析失败时返回 null。
 */
function parseV3OnionDomain(string $onionAddress): ?array
{
    // 1. 移除 .onion 后缀
    if (!str_ends_with($onionAddress, '.onion')) {
        echo "错误: 无效的洋葱地址格式,缺少 '.onion' 后缀。\n";
        return null;
    }
    $domainBase32 = str_replace(".onion", "", $onionAddress);

    // 2. Base32 解码
    $decodedBinary = Base32::decode($domainBase32);

    // 检查解码后的长度,V3地址应为35字节
    if (strlen($decodedBinary) !== 35) {
        echo "错误: Base32解码后的数据长度不正确,期望35字节,实际为 " . strlen($decodedBinary) . " 字节。\n";
        return null;
    }

    // 3. 字节截取
    $publicKey = substr($decodedBinary, 0, 32);      // 前32字节是公钥
    $checksum  = substr($decodedBinary, 32, 2);      // 紧随公钥的2字节是校验和
    $version   = substr($decodedBinary, 34, 1);      // 最后一个字节是版本号

    // 将二进制数据转换为可读的十六进制字符串
    $publicKeyHex = bin2hex($publicKey);
    $checksumHex  = bin2hex($checksum);
    $versionHex   = bin2hex($version);

    return [
        'publicKey' => $publicKeyHex,
        'checksum'  => $checksumHex,
        'version'   => $versionHex,
        'versionDecimal' => hexdec($versionHex) // 版本号的十进制表示
    ];
}

// 示例用法
$onionUrl = "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion";
$parsedData = parseV3OnionDomain($onionUrl);

if ($parsedData) {
    echo "成功解析V3洋葱域名: {$onionUrl}\n";
    echo "公钥 (HEX): " . $parsedData['publicKey'] . "\n";
    echo "校验和 (HEX): " . $parsedData['checksum'] . "\n";
    echo "版本 (HEX): " . $parsedData['version'] . "\n";
    echo "版本 (DEC): " . $parsedData['versionDecimal'] . "\n";

    // 验证版本号是否为3
    if ($parsedData['versionDecimal'] === 3) {
        echo "版本号验证成功:为V3地址。\n";
    } else {
        echo "警告:版本号不是预期的V3。\n";
    }

    // --- 校验和验证示例 (需要一个SHA3-256库) ---
    // 注意:PHP内置的hash函数不支持SHA3-256,需要引入第三方库或PECL扩展
    // 例如:composer require phpseclib/phpseclib
    // use phpseclib3\Crypt\Hash;
    // $hash = new Hash('sha3-256');
    // $inputForChecksum = ".onion checksum" . hex2bin($parsedData['publicKey']) . hex2bin($parsedData['version']);
    // $calculatedChecksum = substr($hash->hash($inputForChecksum), 0, 2); // 取前两个字节
    // if ($calculatedChecksum === hex2bin($parsedData['checksum'])) {
    //     echo "校验和验证成功!\n";
    // } else {
    //     echo "校验和验证失败!地址可能无效或被篡改。\n";
    // }
}

?>

注意事项

  • Base32解码器:上述代码包含了一个简化的Base32类,用于演示目的。在生产环境中,强烈建议使用经过充分测试和优化的第三方Base32解码库,以确保正确性和安全性。
  • 校验和算法:Tor V3地址的校验和计算使用了特定的哈希函数 H。在Tor的C语言实现中,这个哈希函数是SHA3-256。PHP标准库目前不直接支持SHA3-256,您可能需要使用PECL扩展(如hash扩展的hash_algos()列表里如果包含sha3-256)或第三方密码学库(例如 phpseclib)来实现校验和的重新计算和验证。校验和验证是确保洋葱地址完整性和有效性的关键步骤。
  • 错误处理:在实际应用中,需要更健壮的错误处理机制,例如处理无效的Base32字符串、不正确的长度或格式等。

总结

通过上述解析过程和PHP示例,我们能够准确地从V3洋葱域名中提取出其核心组件:公钥、校验和以及版本号。这一能力对于构建Tor相关的工具、分析隐藏服务信息或验证洋葱地址的合法性至关重要。理解并正确实现这些解析步骤,是与Tor网络进行更深层次交互的基础。务必注意在生产环境中使用可靠的Base32解码库和正确的哈希算法进行校验和验证,以确保数据的准确性和安全性。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mysql标识符无效错误怎么解决
mysql标识符无效错误怎么解决

mysql标识符无效错误的解决办法:1、检查标识符是否被其他表或数据库使用;2、检查标识符是否包含特殊字符;3、使用引号包裹标识符;4、使用反引号包裹标识符;5、检查MySQL的配置文件等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.04

18480

5

Python标识符有哪些
Python标识符有哪些

Python标识符有变量标识符、函数标识符、类标识符、模块标识符、下划线开头的标识符、双下划线开头、双下划线结尾的标识符、整型标识符、浮点型标识符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1283

5

java标识符合集
java标识符合集

本专题整合了java标识符相关内容,想了解更多详细内容,请阅读下面的文章。

2025.06.11

9850

9

c++标识符介绍
c++标识符介绍

本专题整合了c++标识符相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.07

3922

7

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1958

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3244

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6424

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

6669

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

8174

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习