91 lines
8.8 KiB
Markdown
91 lines
8.8 KiB
Markdown
# Топ-5 Критичных Несоответствий: Документация vs Реальный Код Phantom Protocol
|
||
|
||
Этот документ выделяет 5 самых серьезных несоответствий между официальной документацией (20,000+ слов) и реальным состоянием исходного кода в архиве `phantom-protocol-2025-final-release.tar.gz`. Эти расхождения могут ввести пользователей в заблуждение относительно реальных возможностей проекта.
|
||
|
||
---
|
||
|
||
## 1. Hidden Services (.phantom сайты)
|
||
|
||
**Заявление в документации:**
|
||
> "Одной из уникальных особенностей Phantom Protocol является поддержка собственной доменной системы с доменами верхнего уровня .phantom. ... Для доступа к .phantom сайтам настройте ваш DNS на использование Phantom DNS сервера... После этого вы сможете открывать .phantom сайты в любом браузере, например: `http://abc123def456.phantom`" [1]
|
||
|
||
**Реальность в коде:**
|
||
- **Функционал полностью отсутствует.**
|
||
- Существует только заголовочный файл `phantom_hidden_service.h`, который описывает структуры данных и API.
|
||
- **Нет файла реализации `phantom_hidden_service.c`**.
|
||
- Нет никаких инструментов или команд `phantom-hidden-service`, как указано в документации.
|
||
|
||
**Критичность:** **Высокая**. Это одно из ключевых заявленных преимуществ, которое на самом деле является **чистой концепцией**. Пользователь, следующий руководству, не сможет создать или получить доступ к `.phantom` сайту.
|
||
|
||
---
|
||
|
||
## 2. Exit Nodes (Выход в интернет через SOCKS5/HTTP)
|
||
|
||
**Заявление в документации:**
|
||
> "Самый простой способ начать использовать Phantom Protocol - это настроить SOCKS5 прокси, который будет маршрутизировать ваш интернет-трафик через анонимную сеть." [1]
|
||
|
||
**Реальность в коде:**
|
||
- **Функционал не интегрирован с ядром Phantom.**
|
||
- `Dockerfile.socks5-proxy` использует Python-скрипт `socks5-proxy.py`, который **не использует реальную сеть Phantom**.
|
||
- В коде `socks5-proxy.py` есть **fallback-механизм**, который при ошибке подключения к Phantom-узлу просто **устанавливает прямое соединение с целью**:
|
||
```python
|
||
# Fallback: прямое подключение для демонстрации
|
||
logger.info(f"Fallback: прямое подключение к {target_host}:{target_port}")
|
||
self.socket.connect((target_host, target_port))
|
||
```
|
||
- Заголовочный файл `phantom_exit_node.h` существует, но **реализация в `.c` файле отсутствует**.
|
||
|
||
**Критичность:** **Высокая**. Пользователь будет уверен, что его трафик анонимизирован через Phantom, но на самом деле прокси-сервер будет устанавливать **прямое, неанонимное соединение**. Это создает **ложное чувство безопасности**.
|
||
|
||
---
|
||
|
||
## 3. Децентрализованная TLD система (Альтернатива ICANN)
|
||
|
||
**Заявление в документации:**
|
||
> "Революционная TLD система ... Поддержка миллиардов доменов (2.56B через шардинг) ... Производительность 100,000+ DNS запросов/сек." [2]
|
||
|
||
**Реальность в коде:**
|
||
- **Функционал является прототипом и не завершен.**
|
||
- Хотя файлы `phantom_dns_resolver.c`, `phantom_domain_registry.c`, `phantom_consensus.c` содержат более 2500 строк кода, в них есть **ключевые функции-заглушки** с пометками `TODO`.
|
||
- **Нет интеграции с Kademlia DHT.** Файл `phantom_dns_resolver.c` **не содержит ни одного упоминания `kademlia` или `DHT`**, что означает, что он не может работать в децентрализованной сети.
|
||
- Заявленная производительность в 100,000+ запросов/сек **не может быть подтверждена**, так как код не завершен и не оптимизирован.
|
||
|
||
**Критичность:** **Высокая**. Самая амбициозная и "революционная" часть проекта на самом деле является **незавершенным proof-of-concept**. Пользователи, ожидающие готовую к использованию альтернативу ICANN, будут разочарованы.
|
||
|
||
---
|
||
|
||
## 4. Практические примеры и тестовые скрипты
|
||
|
||
**Заявление в документации:**
|
||
> "8+ практических примеров использования ... Комплексные тесты для 8 различных сценариев." [2]
|
||
|
||
**Реальность в коде:**
|
||
- **Примеры являются демонстрационными, а не рабочими.** Python-скрипты (`socks5-proxy.py`, `vpn-client.py`) **симулируют** работу с Phantom, но на самом деле не используют сеть.
|
||
- **Тестовые скрипты (`test-real-scenarios.sh`) не тестируют функциональность.** Они проверяют, что Docker-контейнеры запустились и порты открыты, но **не проверяют сквозную передачу данных** через Phantom.
|
||
|
||
**Критичность:** **Средняя**. Хотя это не создает прямой угрозы безопасности, это вводит в заблуждение относительно **уровня готовности и зрелости проекта**. Пользователь может подумать, что проект тщательно протестирован, хотя на самом деле функциональные тесты отсутствуют.
|
||
|
||
---
|
||
|
||
## 5. Полная русификация кода
|
||
|
||
**Заявление в документации:**
|
||
> "Добавлены обширные русские комментарии во все 71 файл C" (цитата из предыдущих обсуждений).
|
||
|
||
**Реальность в коде:**
|
||
- **Русификация частичная.**
|
||
- Русские комментарии добавлены в основном в **местах модернизации** (`helper.c`, `path.c`, `tunnel.c`).
|
||
- Большинство оригинальных файлов (`kademlia.c`, `server.c` и др.) **сохранили английские комментарии**.
|
||
|
||
**Критичность:** **Низкая**. Это не влияет на функциональность, но является **несоответствием в заявленных характеристиках проекта**. Это подрывает общее доверие к документации.
|
||
|
||
---
|
||
|
||
## Заключение
|
||
|
||
Документация к Phantom Protocol 2025 описывает **амбициозный и мощный проект**, но реальный код отстает от этих заявлений. Самые критичные несоответствия касаются **ключевых расширенных функций**, которые представлены как работающие, но на самом деле являются **концепциями или незавершенными прототипами**. Это создает **существенный риск для пользователей**, которые могут положиться на несуществующий функционал, особенно в вопросах анонимности и безопасности.
|
||
|
||
### Источники
|
||
[1] `user-guide-complete-ru.md`
|
||
[2] `PROJECT_STATUS.md`
|