Документация по декодеру PHP
Декодер ionCube и декодер SourceGuardian для PHP — приватный, офлайн и готовый для команд. Используйте графический интерфейс (GUI) или CLI.
Кратко
- Офлайн и приватно — ваш код никогда не покидает ваш компьютер.
- Два способа работы — графический интерфейс для простоты, CLI для автоматизации.
- Удобно для пакетов — декодируйте папки, автоматизируйте в CI, получайте журналы и контрольные суммы.
- Читаемый вывод — таблицы символов восстанавливаются и распространённые слои обфускации удаляются, где это возможно.
- Кроссплатформенность — Windows и Linux (64-бит).
- Готов для команд — практичные процессы для агентств и внутренних команд.
Поддерживаемые версии
| Движок | Версии |
|---|---|
| ionCube Loader | 10–14 |
| SourceGuardian | 11–15 |
| PHP | 5.6–8.3 |
Содержание
- Быстрый старт
- Установка
- Системные требования
- Графический интерфейс (GUI)
- Справочник по CLI
- Рабочие процессы и CI
- Читаемый вывод
- Журналы и контрольные суммы
- Советы по производительности
- Безопасность и конфиденциальность
- Правовые вопросы и допустимое использование
- Лицензирование и обновления
- Покупка и оплата
- Устранение неполадок
- Вопросы и ответы
- Поддержка
Быстрый старт
UnZend работает полностью офлайн на вашей машине. Начните с GUI для пошагового режима или используйте CLI для скриптов. Проверьте установку, затем декодируйте один файл и небольшую папку.
1) Проверьте установку
unzend --version
```
unzend --help
2) Декодировать один файл (CLI, ionCube)
unzend decode --engine ioncube \
```
--input /path/to/locked.php
--out ./decoded/
3) Декодировать папку (CLI, рекурсивно)
Укажите каталог в параметре --input. UnZend обработает поддерживаемые файлы и сохранит относительную структуру в --out.
unzend decode --engine sourceguardian \
```
--input ./project-locked/
--out ./project-decoded/
Установка
Windows (64-бит)
- Запустите установщик или распакуйте предоставленный архив в любое удобное место.
- Откройте Windows Terminal или PowerShell.
- При желании добавьте каталог установки в переменную окружения
PATHдля глобального доступа. - Проверьте через
unzend --version.
Linux (64-бит)
- Распакуйте архив в подходящий путь (например, в
/opt/unzendили домашний каталог). - Добавьте папку с бинарником
unzendв переменнуюPATHв~/.bashrcили~/.zshrc. - Убедитесь, что файл исполняемый:
chmod +x unzend. - Проверьте через
unzend --version.
Примечание: В зависимости от вашего плана при первом запуске может потребоваться активация. Следуйте инструкциям на экране или из письма Welcome, полученного после покупки.
Системные требования
- Windows или Linux (64-бит)
- Современный CPU; рекомендуется 8 ГБ ОЗУ
- Достаточно места на диске для результатов и журналов
- Полностью работает офлайн на вашей машине
Графический интерфейс (GUI)
Опыт программирования не требуется. GUI позволяет запускать задания, выбирать файлы или папки, выбрать движок декодирования, задать папку вывода и просматривать результаты и журналы — всё офлайн на вашей машине.
Запуск нового задания
- Откройте UnZend и выберите New Decode.
- Выберите Engine: ionCube или SourceGuardian.
- Установите Input на файл или папку.
- Задайте каталог Output (UnZend сохраняет структуру).
- При необходимости включите журналы и контрольные суммы.
- Нажмите Start для запуска.
Мониторинг и просмотр
- Смотрите прогресс в реальном времени с счётчиками файлов.
- Откройте Job Log, чтобы просмотреть сводки, предупреждения и пропущенные файлы.
- Используйте Open Output, чтобы перейти к декодированной папке.
- Запустите New Job с другими настройками при необходимости.
Совет: Для смешанных проектов (и ionCube, и SourceGuardian) запускайте отдельные задания для каждого движка.
Справочник по CLI
UnZend — CLI-в первую очередь. Запустите unzend --help, чтобы увидеть полный список команд и флагов. Ниже приведены распространённые шаблоны.
Декодировать один файл
unzend decode --engine ioncube \
```
--input /path/locked.php
--out ./decoded/
«`
Декодировать папку
unzend decode --engine sourceguardian \
```
--input ./locked-src/
--out ./decoded-src/
«`
Пробный запуск и логирование (рекомендуется)
Перед большими заданиями выполните короткий прогон и проверьте журналы. Используйте параметры логирования из --help, чтобы сохранять сводки и контрольные суммы.
Рабочие процессы и CI
UnZend разработан для повторяемых инженерных процессов. Примеры ниже демонстрируют типичные шаблоны автоматизации.
Простой Bash-скрипт
#!/usr/bin/env bash
```
set -euo pipefail
INPUT=${1:-./locked}
OUTPUT=${2:-./decoded}
# Предпросмотр
unzend --version
# Декодирование
unzend decode --engine ioncube --input "$INPUT" --out "$OUTPUT"
# Базовая проверка корректности
php -l $(find "$OUTPUT" -type f -name '*.php') | tee decode-php-lint.log
«`
GitHub Actions (пример)
name: Декодирование с UnZend
```
on: [workflow_dispatch]
jobs:
decode:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Установить PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.2'
- name: Запустить UnZend
run: |
unzend --version
unzend decode --engine ioncube
--input ./locked
--out ./decoded
- name: Проверить синтаксис декодированного PHP
run: |
find ./decoded -name "*.php" -print0 | xargs -0 -n1 php -l
«`
Читаемый вывод
- Восстанавливает таблицы символов, где это возможно, чтобы вернуть удобные для разработчика имена.
- Удаляет типичные слои обфускации для долгосрочной поддерживаемости.
- Сохраняет структуру проекта, чтобы уменьшить «шум» в диффах.
- Генерирует журналы и контрольные суммы для аудита.
Журналы и контрольные суммы
- Сводка задания: количество обработанных, декодированных и пропущенных файлов.
- Предупреждения и причины: пометки для файлов, которые не удалось декодировать (например, неподдерживаемая версия).
- Контрольные суммы: необязательные хэши для проверки целостности наборов входа и выхода.
- Хранение: журналы сохраняются рядом с выводом или в указанном вами пути.
Советы по производительности
- Используйте локальный SSD для каталогов входа и выхода.
- Исключайте из путей ввода большие каталоги, не относящиеся к PHP.
- Сначала запускайте небольшие выборки, чтобы проверить настройки перед полноформатным запуском.
- Держите ОС актуальной; обеспечьте достаточный свободный диск для вывода и журналов.
Безопасность и конфиденциальность
UnZend работает локально на вашей машине. Ваш код остаётся на вашем устройстве, а задания выполняются офлайн. Просматривайте журналы на своей системе и сохраняйте результаты там, где требуют политики вашей команды.
- Только локально: нет необходимости загружать исходники куда-либо для декодирования.
- Структура проекта сохраняется: изменения остаются обозримыми и аудируемыми.
- Командные процессы: сохраняйте журналы рядом с результатами для соблюдения внутренних требований аудита.
Правовые вопросы и допустимое использование
Прочитайте перед декодированием
Используйте UnZend только для декодирования программного обеспечения, которым вы владеете, или по которому у вас есть письменное разрешение владельца на восстановление. Вы несёте ответственность за соблюдение авторского права и местных правил.
Лицензирование и обновления
- Включает лицензию на ПО для UnZend v3.x (устройства и окно обновлений зависят от плана).
- Документация и руководства по быстрому старту предоставляются при покупке.
- Email-поддержка от инженеров, которые разрабатывают декодер.
Покупка и оплата
UnZend принимает только криптоплатежи. Пошаговые инструкции по оплате показываются на оформлении заказа после выбора плана.
Устранение неполадок
Распространённые проблемы
- Неподдерживаемый загрузчик или версия PHP: проверьте таблицу Поддерживаемые версии выше.
- Отказано в доступе: убедитесь, что каталог вывода доступен для записи, а бинарные файлы исполняемы.
- Смешанные движки: если проект сочетает ionCube и SourceGuardian, запускайте отдельные проходы или укажите
--engineсоответствующим образом. - Предупреждения синтаксиса PHP: запустите
php -lпо декодированным файлам и исправьте специфичные для проекта моменты.
Шаги самопроверки
- Подтвердите, что ваша загрузка соответствует ожидаемой контрольной сумме (если предоставлена).
- Запустите на небольшом примере перед полным пакетом.
- Проверьте журналы на предмет пропущенных файлов и причин.
- Убедитесь, что декодируете только то, чем владеете, или на что есть разрешение.
Вопросы и ответы
Нужны ли знания программирования для использования UnZend?
Опыт кодирования не нужен. UnZend включает графический интерфейс (GUI), который проведёт вас через процесс декодирования без единой команды.
- В GUI вы можете: выбрать ionCube или SourceGuardian, выбрать файлы или папки в качестве входа, указать каталог вывода, включить журналы/контрольные суммы и запустить задание. Прогресс и результаты отображаются на экране, можно открыть папку вывода напрямую.
- Для продвинутых пользователей: интерфейс командной строки (CLI) повторяет GUI и идеально подходит для скриптов автоматизации и CI-конвейеров.
При желании начните с GUI, чтобы проверить настройки, затем скопируйте эквивалентную команду CLI в свои скрипты для повторяемых рабочих процессов.
UnZend работает офлайн?
Да. UnZend полностью работает на вашей машине. Ваш код остаётся приватным.
Какие платформы поддерживаются?
Windows и Linux (64-бит).
Какие версии PHP поддерживаются?
PHP с 5.6 по 8.3.
Как оплатить?
Только криптоплатежи. Пошаговые инструкции предоставляются при оформлении заказа.
Где узнать о средах PHP?
См. официальный сайт PHP для информации о версиях и окружениях, актуальной для декодированных проектов.
Поддержка
Ваша покупка включает документацию, руководства по быстрому старту и email-поддержку от инженеров, работающих над декодером. Используйте контактный способ, указанный после оформления заказа, или форму обратной связи на нашем сайте.
«`