🕷️ Crawler Inspector

URL Lookup

Direct Parameter Lookup

Raw Queries and Responses

1. Shard Calculation

Query:

Response:

Calculated Shard: 75 (from laksa021)

2. Crawled Status Check

Query:

curl -X POST \
  'http://laksa075.int.ahrefs:8124/' \
  -H 'Content-Type: text/plain' \
  -H 'X-ClickHouse-Database: crawler3' \
  -H 'Authorization: Basic YXBpOg==' \
  -d 'SELECT getAhrefsURLFromUnparsed(src_unparsed) AS found_url, ifNull(toUnixTimestamp(download_stamp), 0) AS crawl_time, ifNull(toUnixTimestamp(props_url_first_seen), 0) AS first_indexed_time, download_http_code AS http_code, src_unparsed AS src_unparsed, src_root_hash AS src_root_hash, history_drop_reason AS history_drop_reason, meta_title AS meta_title, meta_descriptions AS meta_descriptions, attrs_boilerpipe_text AS attrs_boilerpipe_text, attrs_markdown AS attrs_markdown, attrs_readable_markdown AS attrs_readable_markdown, meta_canonical AS meta_canonical FROM crawler3.page_info_local FINAL PREWHERE (src_root_hash, src_unparsed) IN ((getAhrefsRootHashFromUnparsed(getAhrefsUnparsedNoserviceFromURL(\'https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/\')), getAhrefsUnparsedNoserviceFromURL(\'https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/\'))) FORMAT JSONEachRow'

Response:

{"found_url":"https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/","crawl_time":1776439819,"first_indexed_time":1732188625,"http_code":200,"src_unparsed":"ru,pressanybutton!\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/ s443","src_root_hash":"3052112393321575475","history_drop_reason":null,"meta_title":"Python-проект в EXE-файл и обфускация кода","meta_descriptions":["<p>В этом посте познакомимся с инструментами, позволяющими превратить Python-проект в exe-файл, а также узнаем, что такое обфускация кода.<\/p>"],"attrs_boilerpipe_text":"Работая на фрилансе, помимо выполнения своей задачи, не стоит забывать и о сохранности своего труда. Что я имею в виду? Вам скорее всего известны риски фриланса, когда исполнитель отправляет работу заказчику, а тот пропадает не оплачивая её. Не будем вдаваться в специфику фриланса, а поговорим о безопасных способах передачи \"демо версии\".\nСуществует несколько способов безопасно продемонстрировать выполненную работу заказчику, минимизируя риски неоплаты:\nДемонстрация результата через удаленный доступ.\nСамый простой и очевидный способ - запустить проект на своём компьютере или сервере, предоставив доступ заказчику только к результату (например, запустить Telegram-бота или веб-сервис).\nСборка исполняемого файла (exe)\nТакой способ подойдёт, если проект не требует дополнительных зависимостей, таких как база данных (которую можно запустить и у себя, прописав подключение к ней) или, например, когда задача представляет собой GUI-приложение.\nСборка exe-файла с обфускацией кода\nЭтот метод похож на предыдущий, но включает дополнительный уровень защиты: обфускация усложняет чтение и анализ исходного кода. Хотя она не делает код полностью неуязвимым для опытных разработчиков, ее использование может существенно затруднить обратную разработку (\nreverse engeneering\n).\nЕсли первый способ понятен интуитивно, то второй и третий требуют более детального объяснения.\nЕсли вам интересны подобные материалы, подписывайтесь на Telegram-канал\n«Код на салфетке»\n. Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.\nЧто такое сборка исполняемого файла (exe)?\nСборка в исполняемый (\nexe\n) файл представляет собой преобразование Python-проекта в файл\/файлы, пригодные для запуска в окружении, где может не быть предустановлен интерпретатор Python.\nМне известны два способа сборки:\nЗапаковка средствами PyInstaller\n— это инструмент для упаковки Python-приложений в исполняемые файлы. Он собирает Python-скрипт вместе с необходимыми библиотеками, модулями и интерпретатором Python в один файл или папку, удобные для распространения.\nСайт проекта\n.\nПример команды для создания\nexe\n-файла:\npyinstaller --onefile script.py\nКомпиляция средствами Nuitka\n— это компилятор для языка Python, который преобразует исходный код Python в машинный код или промежуточный байт-код (в зависимости от настроек), что ускоряет выполнение программ и делает их независимыми от интерпретатора Python. Nuitka также может генерировать исполняемые файлы, которые могут быть запущены без необходимости наличия интерпретатора Python.\nСайт проекта\n.\nПример команды для компиляции с использованием Nuitka:\nnuitka --standalone script.py\nКаждый из способов обладает своими плюсами и минусами, о которых мы поговорим далее в статье.\nЧто такое обфускация кода?\nОбфускация кода\n— это процесс изменения исходного кода программы таким образом, чтобы затруднить понимание для человека, при сохранении работоспособности программы.\nОбычно обфускация применяется для защиты программного обеспечения от несанкционированного доступа и копирования, а также для усложнения процесса обратной разработки (\nreverse engeneering\n).\nСтоит отметить, что обфускация не защищает полностью от реверс-инженеринга. Однако, для полной защиты нужно обладать специально обученными людьми. В контексте фриланса, это отличная защита.\nПомимо ручного способа, о котором говорить не будем, поскольку это весьма трудозатратное занятие, существует несколько инструментов, вот некоторые из них:\nPyArmor\n— это инструмент для защиты Python скриптов от копирования. Он работает путем шифрования исходного кода и его динамической расшифровки во время выполнения.\nРепозиторий библиотеки\n.\nПример команды для обфускации с использованием PyArmor:\npyarmor pack script.py\nNuitka\n— несмотря на то что Nuitka это компилятор Python, он также может использоваться для обфускации кода. Он компилирует исходный код в промежуточный байт-код или машинный код, что затрудняет его понимание.\nСайт проекта\n.\n \nPython Minifier\n— это инструмент для минификации и обфускации Python кода. Он удаляет пробелы, комментарии и документацию из исходного кода, а также может переименовывать переменные и функции в случайные названия.\nРепозиторий библиотеки\n.\nПример команды для минификации с использованием Python Minifier:\npyminify example.py --output example.min.py\nЧто будет рассматриваться в посте?\nВариантов для применения и комбинирования методов достаточно много, но мы остановимся на двух:\nРассмотрим процесс обфускации кода библиотекой\nPython Minifier\n, а затем запакуем его в исполняемый файл библиотекой\nPyInstaller\n.\nСкомпилируем исполняемый файл библиотекой\nNuitka\n.\nОба варианты будут независимы и выбор будет за вами.\nДля большей наглядности мы проведем описанные выше процессы на пррограмме\nMPF Tools Converter\n, которую я написал приятелю год назад (написал не лучшим образом, но сейчас не об этом). Для тех, кто хочет ознакомиться:\nрепозиторий на GitHub\n.\nПриступим!\n⚠️Обратите внимание!⚠️\nРезультат выполнения сборки зависит от используемой системы! То есть: запустив сборку на Linux, вы получите исполняемый файл для Linux, соответственно, запустив сборку на Windows, вы получите исполняемый файл для Windows.\nРабочего способа, собрать из Linux версию для Windows, не прибегая к виртуальной машине я не нашёл. Если вам известен способ, пожалуйста, напишите в комментариях!\nPython Minifier + PyInstaller\nС\nPython Minifier\nвсё понятно по предыдущему блоку: он выполняет минификацию — процесс оптимизации, при котором содержимое файлов сокращается за счёт удаления пробелов, комментариев и других необязательных элементов. Кроме того, инструмент переименовывает переменные и изменяет структуру кода, что делает его сложным для чтения, но позволяет уменьшить размер файлов и повысить их эффективность.\nПрименение Python Minifier\nДля начала нужно установить библиотеку. Сделаем это выполнив команду:\npip install python-minifier\nПо умолчанию он использует \"полный набор\" минификации, но, если вам что-то не нужно, то в документации указан подробный перечень аргументов запуска:\nhttps:\/\/dflook.github.io\/python-minifier\/command_usage.html\nВ моём случае, проект состоит из\nmain.py-файла\nи пакета\napp\nс ещё двумя\n.py-файлами\n. Следовательно их нужно или обработать вручную каждый отдельно, либо использовать команду для пакетного изменения.\npyminify main.py app\/ --in-place\nВот так выглядел\nmain.py\nдо применения:\nА вот так после:\nДругие файлы:\nПример может показаться не очень наглядным и читаемым, т.к. используется многое из библиотеки Flet и на более независимом от библиотек коде картина будет лучше. Тем не менее, разбор всего этого займёт много времени и сил.\nМожно убедиться, что всё работает корректно запустив программу:\nПрименение PyInstaller\nПрежде чем приступим, давайте познакомимся с\nPyInstaller\nпоближе.\nОсновные особенности PyInstaller:\nАвтоматическое обнаружение и включение всех необходимых зависимостей и модулей.\nПоддержка различных платформ (Windows, macOS, Linux).\nВозможность создания оконных приложений с использованием библиотек GUI.\nКак работает PyInstaller?\nPyInstaller анализирует код Python, определяет зависимости (модули и библиотеки) и включает их в итоговый пакет.\nРезультат может быть представлен:\nодним большим исполняемым файлом (режим\nonefile\n).\nпапкой с отдельным исполняемым файлом и всеми зависимостями (режим\nonedir\n).\nPyInstaller использует системный интерпретатор Python, добавляя его в пакет, а затем запускает программу как обычный Python-скрипт внутри скомпилированного окружения.\nУстановка и применение\nДля установки библиотеки, необходимо выполнить следующую команду:\npip install -U pyinstaller\nУ PyInstaller много параметров запуска, позволяющих настроить сборку исполняемого файла \"под себя\". Полный перечень параметров доступен в документации:\nhttps:\/\/pyinstaller.org\/en\/stable\/usage.html\nВ моём случае команда будет выглядеть так:\npyinstaller --noconfirm --onefile --noconsole \\                                                   \r\n--name 'MPF Converting Tool' --icon '.\/favicon.ico' \\\r\n--add-data '.\/app:app\/' \\\r\n'main.py'\nРазберём параметры:\n--noconfirm\n- Этот параметр отключает запрос подтверждения при перезаписи существующих файлов сборки. PyInstaller без дополнительных вопросов заменит ранее созданные файлы.\n--onefile\n- Объединяет все зависимости и саму программу в один исполняемый файл. Это удобно для распространения, так как итоговый файл не требует дополнительных папок или библиотек рядом.\n--noconsole\n- Убирает отображение консольного окна при запуске программы. Полезно для графических приложений, где консоль не нужна.\n--name 'MPF Converting Tool'\n- Задаёт имя для создаваемого исполняемого файла. В данном случае выходной файл будет называться\nMPF Converting Tool.exe\n(на Windows) или просто\nMPF Converting Tool\n(на Linux\/MacOS).\n--icon '.\/favicon.ico'\n- Указывает путь к файлу иконки, которая будет использоваться для созданного исполняемого файла. Здесь используется\nfavicon.ico\n.\n--add-data '.\/app:app\/'\n- Добавляет дополнительные данные в сборку. В данном случае папка\n.\/app\nдобавляется и будет доступна в приложении как\napp\/\n. Формат записи:\nsource:destination\n.\n'main.py'\n- Основной файл программы, который PyInstaller должен обработать и собрать в исполняемый файл.\nРезультат выполнения\nВыполнив команду начнётся процесс сборки. Если всё прошло успешно, вы увидите в терминале запись \"27927 INFO: Building EXE from EXE-00.toc completed successfully.\".\nВ директории из которой был вызван PyInstaller появится две директории:\nbuild\nи\ndist\n.\nВ директории\nbuild\nсодержатся временные файлы, необходимые для сборки, а в директории\ndist\nитоговый исполняемый файл.\nОткроем директорию\ndist\nв файловом менеджере. Там находится исполняемый файл.\nЗапустим его, чтобы удостовериться, что всё работает:\nЯ получил ошибку, что не может найти необходимые файлы. Это нормально, просто положим их рядом:\nИ запустим снова:\nСлетели размеры окна приложения, но это, скорее всего связанно с запуском на Linux. В остальном программа запустилась и работает корректно.\nИтог по использованию Python Minifier + PyInstaller\nПроцесс достаточно прост и не вызывает трудностей. \nPython Minifier неплохо справляется со своей задачей - усложнить чтение кода. Отмечу ещё раз, что это не панацея и есть более продвинутые инструменты, например, тот же PyArmor, который ещё и шифрует файлы, но он куда более сложен в применении и в разрезе задач для фриланса, это кажется излишним.\nЧто касается PyInstaller, то это живая классика. Обратите внимание на размер итогового файла: почти 40 мегабайт! И это всего три\n.py-файла\n+ несколько библиотек. Всё дело в том, что внутри файла также находится и интерпретатор Python.\nКомпилируем проект в Nuitka\nТеперь давайте разберёмся, как можно скомпилировать проект с помощью\nNuitka\nи чем этот процесс отличается от использования\nPyInstaller\nи обфускации с\nPython Minifier\n.\nОсновные особенности Nuitka:\nВысокая производительность, так как код компилируется в машинный код или промежуточный байт-код.\nПоддержка большинства функций языка Python и некоторых дополнений.\nВозможность создания независимых исполняемых файлов.\nПроцесс работы Nuitka:\nАнализ исходного кода Python для определения всех зависимостей и возможных оптимизаций.\nКомпиляция исходного кода в промежуточный байт-код или машинный код.\nСоздание исполняемого файла, который может быть запущен без необходимости наличия Python.\nКак Nuitka отличается от PyInstaller?\nХарактеристика\nPyInstaller\nNuitka\nТип упаковки\nСобирает Python-скрипт с интерпретатором и модулями\nКомпилирует Python-код в бинарный файл через C\nРазмер файла\nОбычно больше, так как включает интерпретатор\nМеньше, поскольку компилирует код\nПроизводительность\nПроизводительность такая же, как у исходного кода\nВыше за счёт оптимизации и машинного кода\nСовместимость\nПоддерживает большинство библиотек Python\nМожет возникнуть сложность с модулями C API\nЦель\nБыстрая упаковка для распространения\nУлучшение производительности и компиляция\nКак видно из таблицы,\nNuitka\nимеет много преимуществ перед\nPyInstaller\n, в том числе повышение скорости работы и уменьшение размера исполняемого файла.\nНужно ли использовать Python Minifier перед Nuitka?\nВ отличие от сценария с\nPyInstaller\n, дополнительная минификация или обфускация кода перед использованием\nNuitka\nобычно не требуется. Сам процесс компиляции уже затрудняет восстановление читаемого кода. Если же вы хотите усилить защиту,\nNuitka\nпредлагает платные и бесплатные версии:\nБесплатная версия\nвключает базовый функционал компиляции Python-кода в машинный, обеспечивая защиту от простого чтения исходного кода.\nПлатная версия\n(Commercial Edition) добавляет расширенные возможности, такие как встроенная обфускация, шифрование строковых литералов и дополнительная оптимизация для повышения безопасности.\nЕсли вам нужны улучшенные средства защиты, имеет смысл рассмотреть использование коммерческой версии, которая интегрирует функции обфускации прямо в процесс компиляции.\nУстановка Nuitka\nДля установки необходимо выполнить команду:\npip install -U nuitka\nДля работы, Nuitka требует наличие в системе C-компилятора.\nДля Windows:\nVisual Studio 2022\nили выше.\nНе путать с VisualStudio Code \/ VSCode!\nИспользуйте Английский язык в Visual Studio, чтобы Nuitka корректнее фильтровала вывод компилятора.\nКомпилятор\nMinGW64\n. Используется с параметром\n--mingw64\n.\nNuitka\nпредложит скачать его, если не найдёт Visual Studio.\nНекоторые другие компиляторы, предоставляемые пакетами Visual Studio и MinGW64.\nДля Lunux:\nиспользуется\nGCC-компилятор\nили установленный\nclang\n.\nДля macOS:\nиспользуется системный Clang. Чтобы получить к нему доступ, установите\nXCode\nиз\nApple Store\n.\nЗапуск сборки\nДля запуска выполним следующую команду:\nnuitka --standalone --onefile --output-filename=\"MPF Converting Tool\" \\\r\n--windows-disable-console --windows-icon-from-ico=.\/favicon.ico \\\r\nmain.py\nРазберём параметры:\n--standalone\n- Собирает приложение с зависимостями, создавая автономный исполняемый файл.\n--onefile\n- Упаковывает всё в один файл.\n--output-filename=\"MPF Converting Tool\"\n- Указывает имя выходного файла. (Для\nWindows\nв конец необходимо добавить\n.exe\n!)\n--windows-disable-console\n- Отключает консольное окно для графических приложений.\n--windows-icon-from-ico=.\/favicon.ico\n- Добавляет иконку для исполняемого файла.\nmain.py\n- указывает точку входа в проект.\nРезультат выполнения\nПроцесс компиляции может быть неторопливым и занять какое-то время. В процессе будет создано три директории:\nmain.build\n,\nmain.dist\nи\nmain.onefile-build\n, содержащие временные файлы.\nПо окончании в корне проекта появится нужный нам исполняемый файл:\nТочно также запустим, чтобы убедиться в работоспособности:\nИтог по использованию Nuitka\nПри беглом знакомстве,\nNuitka\nкажется отличным инструментом для создания исполняемых файлов, включаем в себя компиляцию и усложнение \"разбора\" файла на исходный код.\nПо результату, мы получили файл размером 31 мегабайт, что меньше результата\nPyInstaller\nна 10 мегабайт, но не кажется выдающимся успехом. Вероятно, зависит от проекта.\nЗаключение\nБыло интересно в процессе написания поста пробовать разное и разбираться, как всё это работает.\nЧто лучше — PyInstaller или Nuitka?\nЕсли ваша основная цель — быстро собрать исполняемый файл для передачи заказчику,\nPyInstaller\nподойдёт лучше: он проще в использовании и не требует дополнительных инструментов.\nЕсли вы хотите повысить производительность и затруднить разбор программы, выбирайте\nNuitka\n.\nВсё описанное выше, не призыв к действию, а лишь описание способов защиты своего труда. Способов на самом деле куда больше и каждый следующий сложнее и комплектнее предыдущего. Выбор какой именно применять, остаётся за вами.\nЕсли вам интересны подобные материалы, подписывайтесь на Telegram-канал\n«Код на салфетке»\n. Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.","attrs_markdown":"![](https:\/\/mc.yandex.ru\/watch\/94235360)\n\n[Перейти к контенту](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#content)\n\n[Код на салфетке](https:\/\/pressanybutton.ru\/)\n\n##### Меню\n- [Категории](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/)\n  - [Гайды](https:\/\/pressanybutton.ru\/category\/gajdy\/)\n  - [Путь в IT](https:\/\/pressanybutton.ru\/category\/put-v-it\/)\n  - [Новости](https:\/\/pressanybutton.ru\/category\/novosti\/)\n  - [Код в мешке](https:\/\/pressanybutton.ru\/category\/kod-v-meshke\/)\n  - [Видео](https:\/\/pressanybutton.ru\/category\/video\/)\n  - [Obsidian для пользователя](https:\/\/pressanybutton.ru\/category\/obsidian-dlya-polzovatelya\/)\n  - [Open Source](https:\/\/pressanybutton.ru\/category\/nashi-open-source-proekty\/)\n  - [База-знаний](https:\/\/pressanybutton.ru\/category\/baza-znanij\/)\n  - [Сравнение Python и С\/C++](https:\/\/pressanybutton.ru\/category\/sravnenie-python-i-s-cpp\/)\n  - [Эксперименты с ИИ](https:\/\/pressanybutton.ru\/category\/eksperimenty-s-ii\/)\n\nТема\n\n[Вход](https:\/\/pressanybutton.ru\/user\/login\/) [Регистрация](https:\/\/pressanybutton.ru\/user\/signup\/)\n\n1. [Главная](https:\/\/pressanybutton.ru\/)\n2. [Полезные инструменты](https:\/\/pressanybutton.ru\/category\/poleznye-instrumenty\/)\n3. Python-проект в EXE-файл и обфускация кода\n\n# Python-проект в EXE-файл и обфускация кода\n[Полезные инструменты](https:\/\/pressanybutton.ru\/category\/poleznye-instrumenty\/) •  [Иван Ашихмин](https:\/\/pressanybutton.ru\/user\/proDream\/)  •\n\n21 Ноябрь 2024\n\n•  6046\n\n[Гайды](https:\/\/pressanybutton.ru\/tag\/%D0%B3%D0%B0%D0%B9%D0%B4%D1%8B\/) [Полезные инструменты](https:\/\/pressanybutton.ru\/tag\/%D0%BF%D0%BE%D0%BB%D0%B5%D0%B7%D0%BD%D1%8B%D0%B5-%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B\/) [защита](https:\/\/pressanybutton.ru\/tag\/%D0%B7%D0%B0%D1%89%D0%B8%D1%82%D0%B0\/) [pyinstaller](https:\/\/pressanybutton.ru\/tag\/pyinstaller\/) [python minifier](https:\/\/pressanybutton.ru\/tag\/python-minifier\/) [обфускация](https:\/\/pressanybutton.ru\/tag\/%D0%BE%D0%B1%D1%84%D1%83%D1%81%D0%BA%D0%B0%D1%86%D0%B8%D1%8F\/) [компиляция](https:\/\/pressanybutton.ru\/tag\/%D0%BA%D0%BE%D0%BC%D0%BF%D0%B8%D0%BB%D1%8F%D1%86%D0%B8%D1%8F\/) [nuitka](https:\/\/pressanybutton.ru\/tag\/nuitka\/) [pyarmor](https:\/\/pressanybutton.ru\/tag\/pyarmor\/) [exe](https:\/\/pressanybutton.ru\/tag\/exe\/)\n\nВ этом посте познакомимся с инструментами, позволяющими превратить Python-проект в exe-файл, а также узнаем, что такое обфускация кода.\n\n![Python-проект в EXE-файл и обфускация кода](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/21\/%D0%BE%D0%B1%D0%BB%D0%BE%D0%B6%D0%BA%D0%B0_6.png)\n\n[Полезные инструменты](https:\/\/pressanybutton.ru\/category\/poleznye-instrumenty\/) •  [Иван Ашихмин](https:\/\/pressanybutton.ru\/user\/proDream\/)  •\n\n21 Ноябрь 2024\n\n•  6046\n\n[← Предыдущая](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/obsidian-livesync-sovmestnaya-rabota-nad-proektnoj\/)\n\n[Следующая →](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/besplatnyj-analog-chatgpt-na-svoyom-pk\/)\n\nРаботая на фрилансе, помимо выполнения своей задачи, не стоит забывать и о сохранности своего труда. Что я имею в виду? Вам скорее всего известны риски фриланса, когда исполнитель отправляет работу заказчику, а тот пропадает не оплачивая её. Не будем вдаваться в специфику фриланса, а поговорим о безопасных способах передачи \"демо версии\".\n\nСуществует несколько способов безопасно продемонстрировать выполненную работу заказчику, минимизируя риски неоплаты:\n\n1. **Демонстрация результата через удаленный доступ.**  \n   Самый простой и очевидный способ - запустить проект на своём компьютере или сервере, предоставив доступ заказчику только к результату (например, запустить Telegram-бота или веб-сервис).\n2. **Сборка исполняемого файла (exe)**  \n   Такой способ подойдёт, если проект не требует дополнительных зависимостей, таких как база данных (которую можно запустить и у себя, прописав подключение к ней) или, например, когда задача представляет собой GUI-приложение.\n3. **Сборка exe-файла с обфускацией кода**  \n   Этот метод похож на предыдущий, но включает дополнительный уровень защиты: обфускация усложняет чтение и анализ исходного кода. Хотя она не делает код полностью неуязвимым для опытных разработчиков, ее использование может существенно затруднить обратную разработку (`reverse engeneering`).\n\nЕсли первый способ понятен интуитивно, то второй и третий требуют более детального объяснения.\n\nЕсли вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https:\/\/t.me\/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.\n\n## Что такое сборка исполняемого файла (exe)?\nСборка в исполняемый (`exe`) файл представляет собой преобразование Python-проекта в файл\/файлы, пригодные для запуска в окружении, где может не быть предустановлен интерпретатор Python.\n\nМне известны два способа сборки:\n\n1. **Запаковка средствами PyInstaller** — это инструмент для упаковки Python-приложений в исполняемые файлы. Он собирает Python-скрипт вместе с необходимыми библиотеками, модулями и интерпретатором Python в один файл или папку, удобные для распространения.  \n   [Сайт проекта](https:\/\/pyinstaller.org\/en\/stable\/).  \n     \n   Пример команды для создания `exe`\\-файла:\n```\n   pyinstaller --onefile script.py\n```\n1. **Компиляция средствами Nuitka** — это компилятор для языка Python, который преобразует исходный код Python в машинный код или промежуточный байт-код (в зависимости от настроек), что ускоряет выполнение программ и делает их независимыми от интерпретатора Python. Nuitka также может генерировать исполняемые файлы, которые могут быть запущены без необходимости наличия интерпретатора Python.  \n   [Сайт проекта](https:\/\/nuitka.net\/).  \n     \n   Пример команды для компиляции с использованием Nuitka:\n```\n   nuitka --standalone script.py\n```\nКаждый из способов обладает своими плюсами и минусами, о которых мы поговорим далее в статье.\n\n## Что такое обфускация кода?\n**Обфускация кода** — это процесс изменения исходного кода программы таким образом, чтобы затруднить понимание для человека, при сохранении работоспособности программы.\n\nОбычно обфускация применяется для защиты программного обеспечения от несанкционированного доступа и копирования, а также для усложнения процесса обратной разработки (`reverse engeneering`).\n\nСтоит отметить, что обфускация не защищает полностью от реверс-инженеринга. Однако, для полной защиты нужно обладать специально обученными людьми. В контексте фриланса, это отличная защита.\n\nПомимо ручного способа, о котором говорить не будем, поскольку это весьма трудозатратное занятие, существует несколько инструментов, вот некоторые из них:\n\n1. **PyArmor** — это инструмент для защиты Python скриптов от копирования. Он работает путем шифрования исходного кода и его динамической расшифровки во время выполнения.  \n   [Репозиторий библиотеки](https:\/\/github.com\/dashingsoft\/pyarmor).  \n     \n   Пример команды для обфускации с использованием PyArmor:\n```\n   pyarmor pack script.py\n```\n1. **Nuitka** — несмотря на то что Nuitka это компилятор Python, он также может использоваться для обфускации кода. Он компилирует исходный код в промежуточный байт-код или машинный код, что затрудняет его понимание.  \n   [Сайт проекта](https:\/\/nuitka.net\/).\n2. **Python Minifier** — это инструмент для минификации и обфускации Python кода. Он удаляет пробелы, комментарии и документацию из исходного кода, а также может переименовывать переменные и функции в случайные названия.  \n   [Репозиторий библиотеки](https:\/\/github.com\/dflook\/python-minifier).  \n     \n   Пример команды для минификации с использованием Python Minifier:\n```\n   pyminify example.py --output example.min.py\n```\n## Что будет рассматриваться в посте?\nВариантов для применения и комбинирования методов достаточно много, но мы остановимся на двух:\n\n1. Рассмотрим процесс обфускации кода библиотекой `Python Minifier`, а затем запакуем его в исполняемый файл библиотекой `PyInstaller`.\n2. Скомпилируем исполняемый файл библиотекой `Nuitka`.\n\nОба варианты будут независимы и выбор будет за вами.\n\nДля большей наглядности мы проведем описанные выше процессы на пррограмме `MPF Tools Converter`, которую я написал приятелю год назад (написал не лучшим образом, но сейчас не об этом). Для тех, кто хочет ознакомиться: [репозиторий на GitHub](https:\/\/github.com\/proDreams\/mpf_tools_converter).\n\nПриступим\\!\n\n### ⚠️Обратите внимание!⚠️\nРезультат выполнения сборки зависит от используемой системы! То есть: запустив сборку на Linux, вы получите исполняемый файл для Linux, соответственно, запустив сборку на Windows, вы получите исполняемый файл для Windows.\n\nРабочего способа, собрать из Linux версию для Windows, не прибегая к виртуальной машине я не нашёл. Если вам известен способ, пожалуйста, напишите в комментариях\\!\n\n## Python Minifier + PyInstaller\nС `Python Minifier` всё понятно по предыдущему блоку: он выполняет минификацию — процесс оптимизации, при котором содержимое файлов сокращается за счёт удаления пробелов, комментариев и других необязательных элементов. Кроме того, инструмент переименовывает переменные и изменяет структуру кода, что делает его сложным для чтения, но позволяет уменьшить размер файлов и повысить их эффективность.\n\n### Применение Python Minifier\nДля начала нужно установить библиотеку. Сделаем это выполнив команду:\n```\npip install python-minifier\n```\nПо умолчанию он использует \"полный набор\" минификации, но, если вам что-то не нужно, то в документации указан подробный перечень аргументов запуска: <https:\/\/dflook.github.io\/python-minifier\/command_usage.html>\n\nВ моём случае, проект состоит из `main.py-файла` и пакета `app` с ещё двумя `.py-файлами`. Следовательно их нужно или обработать вручную каждый отдельно, либо использовать команду для пакетного изменения.\n```\npyminify main.py app\/ --in-place\n```\nВот так выглядел `main.py` до применения:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134649520.png)\n\nА вот так после:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134726037.png)\n\nДругие файлы:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134749102.png)\n\n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134809732.png)\n\nПример может показаться не очень наглядным и читаемым, т.к. используется многое из библиотеки Flet и на более независимом от библиотек коде картина будет лучше. Тем не менее, разбор всего этого займёт много времени и сил.\n\nМожно убедиться, что всё работает корректно запустив программу:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119135016799.png)\n\n### Применение PyInstaller\nПрежде чем приступим, давайте познакомимся с `PyInstaller` поближе.\n\n#### Основные особенности PyInstaller:\n- Автоматическое обнаружение и включение всех необходимых зависимостей и модулей.\n- Поддержка различных платформ (Windows, macOS, Linux).\n- Возможность создания оконных приложений с использованием библиотек GUI.\n#### Как работает PyInstaller?\nPyInstaller анализирует код Python, определяет зависимости (модули и библиотеки) и включает их в итоговый пакет.\n\nРезультат может быть представлен:\n\n- одним большим исполняемым файлом (режим `onefile`).\n- папкой с отдельным исполняемым файлом и всеми зависимостями (режим `onedir`).\n\nPyInstaller использует системный интерпретатор Python, добавляя его в пакет, а затем запускает программу как обычный Python-скрипт внутри скомпилированного окружения.\n\n#### Установка и применение\nДля установки библиотеки, необходимо выполнить следующую команду:\n```\npip install -U pyinstaller\n```\nУ PyInstaller много параметров запуска, позволяющих настроить сборку исполняемого файла \"под себя\". Полный перечень параметров доступен в документации: <https:\/\/pyinstaller.org\/en\/stable\/usage.html>\n\nВ моём случае команда будет выглядеть так:\n```\npyinstaller --noconfirm --onefile --noconsole \\                                                   \r\n--name 'MPF Converting Tool' --icon '.\/favicon.ico' \\\r\n--add-data '.\/app:app\/' \\\r\n'main.py'\n```\nРазберём параметры:\n\n- `--noconfirm` - Этот параметр отключает запрос подтверждения при перезаписи существующих файлов сборки. PyInstaller без дополнительных вопросов заменит ранее созданные файлы.\n- `--onefile` - Объединяет все зависимости и саму программу в один исполняемый файл. Это удобно для распространения, так как итоговый файл не требует дополнительных папок или библиотек рядом.\n- `--noconsole` - Убирает отображение консольного окна при запуске программы. Полезно для графических приложений, где консоль не нужна.\n- `--name 'MPF Converting Tool'` - Задаёт имя для создаваемого исполняемого файла. В данном случае выходной файл будет называться `MPF Converting Tool.exe` (на Windows) или просто `MPF Converting Tool` (на Linux\/MacOS).\n- `--icon '.\/favicon.ico'` - Указывает путь к файлу иконки, которая будет использоваться для созданного исполняемого файла. Здесь используется `favicon.ico`.\n- `--add-data '.\/app:app\/'` - Добавляет дополнительные данные в сборку. В данном случае папка `.\/app` добавляется и будет доступна в приложении как `app\/`. Формат записи: `source:destination`.\n- `'main.py'` - Основной файл программы, который PyInstaller должен обработать и собрать в исполняемый файл.\n#### Результат выполнения\nВыполнив команду начнётся процесс сборки. Если всё прошло успешно, вы увидите в терминале запись \"27927 INFO: Building EXE from EXE-00.toc completed successfully.\".\n\nВ директории из которой был вызван PyInstaller появится две директории: `build` и `dist`.  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142053005.png)\n\nВ директории `build` содержатся временные файлы, необходимые для сборки, а в директории `dist` итоговый исполняемый файл.\n\nОткроем директорию `dist` в файловом менеджере. Там находится исполняемый файл.  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142153175.png)\n\nЗапустим его, чтобы удостовериться, что всё работает:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142232500.png)\n\nЯ получил ошибку, что не может найти необходимые файлы. Это нормально, просто положим их рядом:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142320092.png)\n\nИ запустим снова:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142346840.png)\n\nСлетели размеры окна приложения, но это, скорее всего связанно с запуском на Linux. В остальном программа запустилась и работает корректно.\n\n### Итог по использованию Python Minifier + PyInstaller\nПроцесс достаточно прост и не вызывает трудностей.   \nPython Minifier неплохо справляется со своей задачей - усложнить чтение кода. Отмечу ещё раз, что это не панацея и есть более продвинутые инструменты, например, тот же PyArmor, который ещё и шифрует файлы, но он куда более сложен в применении и в разрезе задач для фриланса, это кажется излишним.\n\nЧто касается PyInstaller, то это живая классика. Обратите внимание на размер итогового файла: почти 40 мегабайт! И это всего три `.py-файла` + несколько библиотек. Всё дело в том, что внутри файла также находится и интерпретатор Python.\n\n## Компилируем проект в Nuitka\nТеперь давайте разберёмся, как можно скомпилировать проект с помощью **Nuitka** и чем этот процесс отличается от использования **PyInstaller** и обфускации с **Python Minifier**.\n\n### Основные особенности Nuitka:\n- Высокая производительность, так как код компилируется в машинный код или промежуточный байт-код.\n- Поддержка большинства функций языка Python и некоторых дополнений.\n- Возможность создания независимых исполняемых файлов.\n### Процесс работы Nuitka:\n1. Анализ исходного кода Python для определения всех зависимостей и возможных оптимизаций.\n2. Компиляция исходного кода в промежуточный байт-код или машинный код.\n3. Создание исполняемого файла, который может быть запущен без необходимости наличия Python.\n### Как Nuitka отличается от PyInstaller?\n| **Характеристика** | **PyInstaller** | **Nuitka** |\n|---|---|---|\n| **Тип упаковки** | Собирает Python-скрипт с интерпретатором и модулями | Компилирует Python-код в бинарный файл через C |\n| **Размер файла** | Обычно больше, так как включает интерпретатор | Меньше, поскольку компилирует код |\n| **Производительность** | Производительность такая же, как у исходного кода | Выше за счёт оптимизации и машинного кода |\n| **Совместимость** | Поддерживает большинство библиотек Python | Может возникнуть сложность с модулями C API |\n| **Цель** | Быстрая упаковка для распространения | Улучшение производительности и компиляция |\n\nКак видно из таблицы, `Nuitka` имеет много преимуществ перед `PyInstaller`, в том числе повышение скорости работы и уменьшение размера исполняемого файла.\n\n### Нужно ли использовать Python Minifier перед Nuitka?\nВ отличие от сценария с `PyInstaller`, дополнительная минификация или обфускация кода перед использованием `Nuitka` обычно не требуется. Сам процесс компиляции уже затрудняет восстановление читаемого кода. Если же вы хотите усилить защиту, `Nuitka` предлагает платные и бесплатные версии:\n\n- **Бесплатная версия** включает базовый функционал компиляции Python-кода в машинный, обеспечивая защиту от простого чтения исходного кода.\n- **Платная версия** (Commercial Edition) добавляет расширенные возможности, такие как встроенная обфускация, шифрование строковых литералов и дополнительная оптимизация для повышения безопасности.\n\nЕсли вам нужны улучшенные средства защиты, имеет смысл рассмотреть использование коммерческой версии, которая интегрирует функции обфускации прямо в процесс компиляции.\n\n### Установка Nuitka\nДля установки необходимо выполнить команду:\n```\npip install -U nuitka\n```\nДля работы, Nuitka требует наличие в системе C-компилятора.\n\n- **Для Windows:**\n  - [Visual Studio 2022](https:\/\/www.visualstudio.com\/en-us\/downloads\/download-visual-studio-vs.aspx) или выше. **Не путать с VisualStudio Code \/ VSCode\\!** Используйте Английский язык в Visual Studio, чтобы Nuitka корректнее фильтровала вывод компилятора.\n  - Компилятор `MinGW64`. Используется с параметром `--mingw64`. `Nuitka` предложит скачать его, если не найдёт Visual Studio.\n  - Некоторые другие компиляторы, предоставляемые пакетами Visual Studio и MinGW64.\n- **Для Lunux:** используется `GCC-компилятор` или установленный `clang`.\n- **Для macOS:** используется системный Clang. Чтобы получить к нему доступ, установите `XCode` из `Apple Store`.\n### Запуск сборки\nДля запуска выполним следующую команду:\n```\nnuitka --standalone --onefile --output-filename=\"MPF Converting Tool\" \\\r\n--windows-disable-console --windows-icon-from-ico=.\/favicon.ico \\\r\nmain.py\n```\nРазберём параметры:\n\n1. `--standalone` - Собирает приложение с зависимостями, создавая автономный исполняемый файл.\n2. `--onefile` - Упаковывает всё в один файл.\n3. `--output-filename=\"MPF Converting Tool\"` - Указывает имя выходного файла. (Для **Windows** в конец необходимо добавить `.exe`!)\n4. `--windows-disable-console` - Отключает консольное окно для графических приложений.\n5. `--windows-icon-from-ico=.\/favicon.ico` - Добавляет иконку для исполняемого файла.\n6. `main.py` - указывает точку входа в проект.\n### Результат выполнения\nПроцесс компиляции может быть неторопливым и занять какое-то время. В процессе будет создано три директории: `main.build`, `main.dist` и `main.onefile-build`, содержащие временные файлы.\n\nПо окончании в корне проекта появится нужный нам исполняемый файл:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119160648051.png)\n\nТочно также запустим, чтобы убедиться в работоспособности:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119160735127.png)\n\n### Итог по использованию Nuitka\nПри беглом знакомстве, `Nuitka` кажется отличным инструментом для создания исполняемых файлов, включаем в себя компиляцию и усложнение \"разбора\" файла на исходный код.\n\nПо результату, мы получили файл размером 31 мегабайт, что меньше результата `PyInstaller` на 10 мегабайт, но не кажется выдающимся успехом. Вероятно, зависит от проекта.\n\n## Заключение\nБыло интересно в процессе написания поста пробовать разное и разбираться, как всё это работает.\n\n### Что лучше — PyInstaller или Nuitka?\n- Если ваша основная цель — быстро собрать исполняемый файл для передачи заказчику, **PyInstaller** подойдёт лучше: он проще в использовании и не требует дополнительных инструментов.\n- Если вы хотите повысить производительность и затруднить разбор программы, выбирайте **Nuitka**.\n\nВсё описанное выше, не призыв к действию, а лишь описание способов защиты своего труда. Способов на самом деле куда больше и каждый следующий сложнее и комплектнее предыдущего. Выбор какой именно применять, остаётся за вами.\n\nЕсли вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https:\/\/t.me\/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.\n\nЕсли заметили ошибку — напишите в Telegram автора.\n\n![Аватар автора](https:\/\/pressanybutton.ru\/media\/user\/avatars\/proDreamss.png)\n\n### Автор\n#### [Иван Ашихмин](https:\/\/pressanybutton.ru\/user\/proDream\/)\nПрограммист, фрилансер и автор гайдов. Занимаюсь разработкой ботов, сайтов и не только.\n\n[Telegram](https:\/\/t.me\/proDreams)   [GitHub](https:\/\/github.com\/proDreams)   [Сайт](https:\/\/pressanybutton.ru\/)   [Поддержать](https:\/\/boosty.to\/prodream)\n## Комментарии\n⬆️ Наверх\n\n## Все статьи\n×\n\n- [Selectolax: быстрая альтернатива Beautiful Soup](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/selectolax-bystraya-alternativa-beautiful-soup\/)\n  \n  30 Октябрь 2025\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/selectolax-bystraya-alternativa-beautiful-soup\/#comments)\n- [Обзор WSGI, ASGI и RSGI: лидеры среди веб-серверов в 2025 году](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/obzor-wsgi-asgi-i-rsgi-lidery-sredi-veb-serverov-v-2025-godu\/)\n  \n  18 Сентябрь 2025\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/obzor-wsgi-asgi-i-rsgi-lidery-sredi-veb-serverov-v-2025-godu\/#comments)\n- [Napkin Random Bot: как мы создали бота для честных розыгрышей](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/napkin-random-bot-kak-my-sozdali-bota-dlya-chestnyh-rozygryshej\/)\n  \n  04 Сентябрь 2025\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/napkin-random-bot-kak-my-sozdali-bota-dlya-chestnyh-rozygryshej\/#comments)\n- [Uptime Kuma 2 установка и мониторинг сервисов без VPS](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/uptime-kuma-2-ustanovka-i-monitoring-servisov-bez-vps\/)\n  \n  28 Август 2025\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/uptime-kuma-2-ustanovka-i-monitoring-servisov-bez-vps\/#comments)\n- [Бесплатный аналог ChatGPT на своём ПК](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/besplatnyj-analog-chatgpt-na-svoyom-pk\/)\n  \n  28 Ноябрь 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/besplatnyj-analog-chatgpt-na-svoyom-pk\/#comments)\n- [Python-проект в EXE-файл и обфускация кода](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/)\n  \n  21 Ноябрь 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#comments)  Вы читаете\n- [Obsidian LiveSync - совместная работа над проектной документацией](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/obsidian-livesync-sovmestnaya-rabota-nad-proektnoj\/)\n  \n  10 Октябрь 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/obsidian-livesync-sovmestnaya-rabota-nad-proektnoj\/#comments)\n- [Веб-сервер Caddy - Альтернатива NGINX и Apache](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/veb-server-caddy-alternativa-nginx-i-apache\/)\n  \n  15 Август 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/veb-server-caddy-alternativa-nginx-i-apache\/#comments)\n- [Создание резервных копий VPS на Яндекс Диск](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/sozdanie-rezervnyh-kopij-vps-na-yandeks-disk\/)\n  \n  27 Март 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/sozdanie-rezervnyh-kopij-vps-na-yandeks-disk\/#comments)\n- [Разворачивание Django-проекта на Replit](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/razvorachivanie-django-proekta-na-replit\/)\n  \n  06 Март 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/razvorachivanie-django-proekta-na-replit\/#comments)\n- [Разворачивание Django-проекта на PythonAnyWhere](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/razvorachivanie-django-proekta-na-pythonanywhere\/)\n  \n  08 Февраль 2024\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/razvorachivanie-django-proekta-na-pythonanywhere\/#comments)\n- [Cpp FreeGPT WebUI - Бесплатный GPT на вашем сервере](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/cpp-freegpt-webui-besplatnyj-gpt-na-vashem-servere\/)\n  \n  29 Сентябрь 2023\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/cpp-freegpt-webui-besplatnyj-gpt-na-vashem-servere\/#comments)\n- [Certbot - бесплатный SSL-сертификат для сайта](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/certbot-besplatnyj-ssl-sertifikat-dlya-sajta\/)\n  \n  22 Сентябрь 2023\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/certbot-besplatnyj-ssl-sertifikat-dlya-sajta\/#comments)\n- [Полезные инструменты. Переключатель цветовой темы в Bootstrap5](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/poleznye-instrumenty-pereklyuchatel-cvetovoj-temy\/)\n  \n  06 Сентябрь 2023\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/poleznye-instrumenty-pereklyuchatel-cvetovoj-temy\/#comments)\n- [Полезные инструменты. Jazzmin - шаблон панели администратора Django](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/poleznye-instrumenty-jazzmin-shablon-paneli-admini\/)\n  \n  06 Сентябрь 2023\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/poleznye-instrumenty-jazzmin-shablon-paneli-admini\/#comments)\n- [НЕ АКТУАЛЬНО! Бесплатный Chat-GPT4 на вашем ПК или сервере](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/besplatnyj-chat-gpt4-na-vashem-pk-ili-servere\/)\n  \n  02 Август 2023\n  \n  [Комментарии](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/besplatnyj-chat-gpt4-na-vashem-pk-ili-servere\/#comments)\n\nНичего не найдено. Измените запрос.\n\n### Ссылки\n- ![Поддержать проект](https:\/\/pressanybutton.ru\/media\/social-links\/Color.png) [Поддержать проект](https:\/\/boosty.to\/prodream)\n- ![RSS-лента последних постов](https:\/\/pressanybutton.ru\/media\/social-links\/icons8-rss-32.png) [RSS-лента последних постов](https:\/\/pressanybutton.ru\/feeds\/latest\/)\n- ![Telegram-канал](https:\/\/pressanybutton.ru\/media\/social-links\/icons8-%D1%82%D0%B5%D0%BB%D0%B5%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B0-app-32.png) [Telegram-канал](https:\/\/t.me\/napkincode)\n\n## Оглавление\n- [Что такое сборка исполняемого файла (exe)?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#chto-takoe-sborka-ispolnyaemogo-fajla-exe)\n- [Что такое обфускация кода?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#chto-takoe-obfuskatsiya-koda)\n- [Что будет рассматриваться в посте?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#chto-budet-rassmatrivatsya-v-poste)\n  - [⚠️Обратите внимание!⚠️](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#obratite-vnimanie)\n- [Python Minifier + PyInstaller](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#python-minifier--pyinstaller)\n  - [Применение Python Minifier](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#primenenie-python-minifier)\n  - [Применение PyInstaller](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#primenenie-pyinstaller)\n    - [Основные особенности PyInstaller:](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#osnovnyie-osobennosti-pyinstaller)\n    - [Как работает PyInstaller?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#kak-rabotaet-pyinstaller)\n    - [Установка и применение](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#ustanovka-i-primenenie)\n    - [Результат выполнения](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#rezultat-vyipolneniya)\n  - [Итог по использованию Python Minifier + PyInstaller](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#itog-po-ispolzovaniyu-python-minifier--pyinstaller)\n- [Компилируем проект в Nuitka](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#kompiliruem-proekt-v-nuitka)\n  - [Основные особенности Nuitka:](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#osnovnyie-osobennosti-nuitka)\n  - [Процесс работы Nuitka:](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#protsess-rabotyi-nuitka)\n  - [Как Nuitka отличается от PyInstaller?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#kak-nuitka-otlichaetsya-ot-pyinstaller)\n  - [Нужно ли использовать Python Minifier перед Nuitka?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#nuzhno-li-ispolzovat-python-minifier-pered-nuitka)\n  - [Установка Nuitka](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#ustanovka-nuitka)\n  - [Запуск сборки](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#zapusk-sborki)\n  - [Результат выполнения](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#rezultat-vyipolneniya)\n  - [Итог по использованию Nuitka](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#itog-po-ispolzovaniyu-nuitka)\n- [Заключение](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#zaklyuchenie)\n  - [Что лучше — PyInstaller или Nuitka?](https:\/\/pressanybutton.ru\/post\/poleznye-instrumenty\/python-proektav-exe-fajl-i-obfuskaciya-koda\/#chto-luchshe---pyinstaller-ili-nuitka)\n### Поделиться\n\n[Код на салфетке](https:\/\/pressanybutton.ru\/)\n\nГайды, статьи и проекты про разработку.\n\n###### Навигация\n- [Гайды](https:\/\/pressanybutton.ru\/category\/gajdy\/)\n- [Свежие статьи](https:\/\/pressanybutton.ru\/#latest)\n\n###### Правовая информация\n- [Политика обработки персональных данных](https:\/\/pressanybutton.ru\/privacy-policy\/)\n\nИспользование материалов сайта pressanybutton.ru разрешено только c письменного согласия авторов.\n***\n2023–2026 © «Код на салфетке»\n\n[Telegram](https:\/\/t.me\/press_any_button) [info@pressanybutton.ru](mailto:info@pressanybutton.ru)\n\n↑ Наверх\n\nЭтот сайт использует cookie для улучшения вашего опыта.\n\nСогласен","attrs_readable_markdown":"Работая на фрилансе, помимо выполнения своей задачи, не стоит забывать и о сохранности своего труда. Что я имею в виду? Вам скорее всего известны риски фриланса, когда исполнитель отправляет работу заказчику, а тот пропадает не оплачивая её. Не будем вдаваться в специфику фриланса, а поговорим о безопасных способах передачи \"демо версии\".\n\nСуществует несколько способов безопасно продемонстрировать выполненную работу заказчику, минимизируя риски неоплаты:\n\n1. **Демонстрация результата через удаленный доступ.**  \n   Самый простой и очевидный способ - запустить проект на своём компьютере или сервере, предоставив доступ заказчику только к результату (например, запустить Telegram-бота или веб-сервис).\n2. **Сборка исполняемого файла (exe)**  \n   Такой способ подойдёт, если проект не требует дополнительных зависимостей, таких как база данных (которую можно запустить и у себя, прописав подключение к ней) или, например, когда задача представляет собой GUI-приложение.\n3. **Сборка exe-файла с обфускацией кода**  \n   Этот метод похож на предыдущий, но включает дополнительный уровень защиты: обфускация усложняет чтение и анализ исходного кода. Хотя она не делает код полностью неуязвимым для опытных разработчиков, ее использование может существенно затруднить обратную разработку (`reverse engeneering`).\n\nЕсли первый способ понятен интуитивно, то второй и третий требуют более детального объяснения.\n\nЕсли вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https:\/\/t.me\/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.\n\n## Что такое сборка исполняемого файла (exe)?\nСборка в исполняемый (`exe`) файл представляет собой преобразование Python-проекта в файл\/файлы, пригодные для запуска в окружении, где может не быть предустановлен интерпретатор Python.\n\nМне известны два способа сборки:\n\n1. **Запаковка средствами PyInstaller** — это инструмент для упаковки Python-приложений в исполняемые файлы. Он собирает Python-скрипт вместе с необходимыми библиотеками, модулями и интерпретатором Python в один файл или папку, удобные для распространения.  \n   [Сайт проекта](https:\/\/pyinstaller.org\/en\/stable\/).\n   Пример команды для создания `exe`\\-файла:\n```\n   pyinstaller --onefile script.py\n```\n1. **Компиляция средствами Nuitka** — это компилятор для языка Python, который преобразует исходный код Python в машинный код или промежуточный байт-код (в зависимости от настроек), что ускоряет выполнение программ и делает их независимыми от интерпретатора Python. Nuitka также может генерировать исполняемые файлы, которые могут быть запущены без необходимости наличия интерпретатора Python.  \n   [Сайт проекта](https:\/\/nuitka.net\/).\n   Пример команды для компиляции с использованием Nuitka:\n```\n   nuitka --standalone script.py\n```\nКаждый из способов обладает своими плюсами и минусами, о которых мы поговорим далее в статье.\n\n## Что такое обфускация кода?\n**Обфускация кода** — это процесс изменения исходного кода программы таким образом, чтобы затруднить понимание для человека, при сохранении работоспособности программы.\n\nОбычно обфускация применяется для защиты программного обеспечения от несанкционированного доступа и копирования, а также для усложнения процесса обратной разработки (`reverse engeneering`).\n\nСтоит отметить, что обфускация не защищает полностью от реверс-инженеринга. Однако, для полной защиты нужно обладать специально обученными людьми. В контексте фриланса, это отличная защита.\n\nПомимо ручного способа, о котором говорить не будем, поскольку это весьма трудозатратное занятие, существует несколько инструментов, вот некоторые из них:\n\n1. **PyArmor** — это инструмент для защиты Python скриптов от копирования. Он работает путем шифрования исходного кода и его динамической расшифровки во время выполнения.  \n   [Репозиторий библиотеки](https:\/\/github.com\/dashingsoft\/pyarmor).\n   Пример команды для обфускации с использованием PyArmor:\n```\n   pyarmor pack script.py\n```\n1. **Nuitka** — несмотря на то что Nuitka это компилятор Python, он также может использоваться для обфускации кода. Он компилирует исходный код в промежуточный байт-код или машинный код, что затрудняет его понимание.  \n   [Сайт проекта](https:\/\/nuitka.net\/).\n2. **Python Minifier** — это инструмент для минификации и обфускации Python кода. Он удаляет пробелы, комментарии и документацию из исходного кода, а также может переименовывать переменные и функции в случайные названия.  \n   [Репозиторий библиотеки](https:\/\/github.com\/dflook\/python-minifier).\n   Пример команды для минификации с использованием Python Minifier:\n```\n   pyminify example.py --output example.min.py\n```\n## Что будет рассматриваться в посте?\nВариантов для применения и комбинирования методов достаточно много, но мы остановимся на двух:\n\n1. Рассмотрим процесс обфускации кода библиотекой `Python Minifier`, а затем запакуем его в исполняемый файл библиотекой `PyInstaller`.\n2. Скомпилируем исполняемый файл библиотекой `Nuitka`.\n\nОба варианты будут независимы и выбор будет за вами.\n\nДля большей наглядности мы проведем описанные выше процессы на пррограмме `MPF Tools Converter`, которую я написал приятелю год назад (написал не лучшим образом, но сейчас не об этом). Для тех, кто хочет ознакомиться: [репозиторий на GitHub](https:\/\/github.com\/proDreams\/mpf_tools_converter).\n\nПриступим\\!\n\n### ⚠️Обратите внимание!⚠️\nРезультат выполнения сборки зависит от используемой системы! То есть: запустив сборку на Linux, вы получите исполняемый файл для Linux, соответственно, запустив сборку на Windows, вы получите исполняемый файл для Windows.\n\nРабочего способа, собрать из Linux версию для Windows, не прибегая к виртуальной машине я не нашёл. Если вам известен способ, пожалуйста, напишите в комментариях\\!\n\n## Python Minifier + PyInstaller\nС `Python Minifier` всё понятно по предыдущему блоку: он выполняет минификацию — процесс оптимизации, при котором содержимое файлов сокращается за счёт удаления пробелов, комментариев и других необязательных элементов. Кроме того, инструмент переименовывает переменные и изменяет структуру кода, что делает его сложным для чтения, но позволяет уменьшить размер файлов и повысить их эффективность.\n\n### Применение Python Minifier\nДля начала нужно установить библиотеку. Сделаем это выполнив команду:\n```\npip install python-minifier\n```\nПо умолчанию он использует \"полный набор\" минификации, но, если вам что-то не нужно, то в документации указан подробный перечень аргументов запуска: <https:\/\/dflook.github.io\/python-minifier\/command_usage.html>\n\nВ моём случае, проект состоит из `main.py-файла` и пакета `app` с ещё двумя `.py-файлами`. Следовательно их нужно или обработать вручную каждый отдельно, либо использовать команду для пакетного изменения.\n```\npyminify main.py app\/ --in-place\n```\nВот так выглядел `main.py` до применения:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134649520.png)\n\nА вот так после:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134726037.png)\n\nДругие файлы:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134749102.png)\n\n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119134809732.png)\n\nПример может показаться не очень наглядным и читаемым, т.к. используется многое из библиотеки Flet и на более независимом от библиотек коде картина будет лучше. Тем не менее, разбор всего этого займёт много времени и сил.\n\nМожно убедиться, что всё работает корректно запустив программу:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119135016799.png)\n\n### Применение PyInstaller\nПрежде чем приступим, давайте познакомимся с `PyInstaller` поближе.\n\n#### Основные особенности PyInstaller:\n- Автоматическое обнаружение и включение всех необходимых зависимостей и модулей.\n- Поддержка различных платформ (Windows, macOS, Linux).\n- Возможность создания оконных приложений с использованием библиотек GUI.\n#### Как работает PyInstaller?\nPyInstaller анализирует код Python, определяет зависимости (модули и библиотеки) и включает их в итоговый пакет.\n\nРезультат может быть представлен:\n\n- одним большим исполняемым файлом (режим `onefile`).\n- папкой с отдельным исполняемым файлом и всеми зависимостями (режим `onedir`).\n\nPyInstaller использует системный интерпретатор Python, добавляя его в пакет, а затем запускает программу как обычный Python-скрипт внутри скомпилированного окружения.\n\n#### Установка и применение\nДля установки библиотеки, необходимо выполнить следующую команду:\n```\npip install -U pyinstaller\n```\nУ PyInstaller много параметров запуска, позволяющих настроить сборку исполняемого файла \"под себя\". Полный перечень параметров доступен в документации: <https:\/\/pyinstaller.org\/en\/stable\/usage.html>\n\nВ моём случае команда будет выглядеть так:\n```\npyinstaller --noconfirm --onefile --noconsole \\                                                   \r\n--name 'MPF Converting Tool' --icon '.\/favicon.ico' \\\r\n--add-data '.\/app:app\/' \\\r\n'main.py'\n```\nРазберём параметры:\n\n- `--noconfirm` - Этот параметр отключает запрос подтверждения при перезаписи существующих файлов сборки. PyInstaller без дополнительных вопросов заменит ранее созданные файлы.\n- `--onefile` - Объединяет все зависимости и саму программу в один исполняемый файл. Это удобно для распространения, так как итоговый файл не требует дополнительных папок или библиотек рядом.\n- `--noconsole` - Убирает отображение консольного окна при запуске программы. Полезно для графических приложений, где консоль не нужна.\n- `--name 'MPF Converting Tool'` - Задаёт имя для создаваемого исполняемого файла. В данном случае выходной файл будет называться `MPF Converting Tool.exe` (на Windows) или просто `MPF Converting Tool` (на Linux\/MacOS).\n- `--icon '.\/favicon.ico'` - Указывает путь к файлу иконки, которая будет использоваться для созданного исполняемого файла. Здесь используется `favicon.ico`.\n- `--add-data '.\/app:app\/'` - Добавляет дополнительные данные в сборку. В данном случае папка `.\/app` добавляется и будет доступна в приложении как `app\/`. Формат записи: `source:destination`.\n- `'main.py'` - Основной файл программы, который PyInstaller должен обработать и собрать в исполняемый файл.\n#### Результат выполнения\nВыполнив команду начнётся процесс сборки. Если всё прошло успешно, вы увидите в терминале запись \"27927 INFO: Building EXE from EXE-00.toc completed successfully.\".\n\nВ директории из которой был вызван PyInstaller появится две директории: `build` и `dist`.  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142053005.png)\n\nВ директории `build` содержатся временные файлы, необходимые для сборки, а в директории `dist` итоговый исполняемый файл.\n\nОткроем директорию `dist` в файловом менеджере. Там находится исполняемый файл.  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142153175.png)\n\nЗапустим его, чтобы удостовериться, что всё работает:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142232500.png)\n\nЯ получил ошибку, что не может найти необходимые файлы. Это нормально, просто положим их рядом:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142320092.png)\n\nИ запустим снова:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119142346840.png)\n\nСлетели размеры окна приложения, но это, скорее всего связанно с запуском на Linux. В остальном программа запустилась и работает корректно.\n\n### Итог по использованию Python Minifier + PyInstaller\nПроцесс достаточно прост и не вызывает трудностей.   \nPython Minifier неплохо справляется со своей задачей - усложнить чтение кода. Отмечу ещё раз, что это не панацея и есть более продвинутые инструменты, например, тот же PyArmor, который ещё и шифрует файлы, но он куда более сложен в применении и в разрезе задач для фриланса, это кажется излишним.\n\nЧто касается PyInstaller, то это живая классика. Обратите внимание на размер итогового файла: почти 40 мегабайт! И это всего три `.py-файла` + несколько библиотек. Всё дело в том, что внутри файла также находится и интерпретатор Python.\n\n## Компилируем проект в Nuitka\nТеперь давайте разберёмся, как можно скомпилировать проект с помощью **Nuitka** и чем этот процесс отличается от использования **PyInstaller** и обфускации с **Python Minifier**.\n\n### Основные особенности Nuitka:\n- Высокая производительность, так как код компилируется в машинный код или промежуточный байт-код.\n- Поддержка большинства функций языка Python и некоторых дополнений.\n- Возможность создания независимых исполняемых файлов.\n### Процесс работы Nuitka:\n1. Анализ исходного кода Python для определения всех зависимостей и возможных оптимизаций.\n2. Компиляция исходного кода в промежуточный байт-код или машинный код.\n3. Создание исполняемого файла, который может быть запущен без необходимости наличия Python.\n### Как Nuitka отличается от PyInstaller?\n| **Характеристика** | **PyInstaller** | **Nuitka** |\n|---|---|---|\n| **Тип упаковки** | Собирает Python-скрипт с интерпретатором и модулями | Компилирует Python-код в бинарный файл через C |\n| **Размер файла** | Обычно больше, так как включает интерпретатор | Меньше, поскольку компилирует код |\n| **Производительность** | Производительность такая же, как у исходного кода | Выше за счёт оптимизации и машинного кода |\n| **Совместимость** | Поддерживает большинство библиотек Python | Может возникнуть сложность с модулями C API |\n| **Цель** | Быстрая упаковка для распространения | Улучшение производительности и компиляция |\n\nКак видно из таблицы, `Nuitka` имеет много преимуществ перед `PyInstaller`, в том числе повышение скорости работы и уменьшение размера исполняемого файла.\n\n### Нужно ли использовать Python Minifier перед Nuitka?\nВ отличие от сценария с `PyInstaller`, дополнительная минификация или обфускация кода перед использованием `Nuitka` обычно не требуется. Сам процесс компиляции уже затрудняет восстановление читаемого кода. Если же вы хотите усилить защиту, `Nuitka` предлагает платные и бесплатные версии:\n\n- **Бесплатная версия** включает базовый функционал компиляции Python-кода в машинный, обеспечивая защиту от простого чтения исходного кода.\n- **Платная версия** (Commercial Edition) добавляет расширенные возможности, такие как встроенная обфускация, шифрование строковых литералов и дополнительная оптимизация для повышения безопасности.\n\nЕсли вам нужны улучшенные средства защиты, имеет смысл рассмотреть использование коммерческой версии, которая интегрирует функции обфускации прямо в процесс компиляции.\n\n### Установка Nuitka\nДля установки необходимо выполнить команду:\n```\npip install -U nuitka\n```\nДля работы, Nuitka требует наличие в системе C-компилятора.\n\n- **Для Windows:**\n  - [Visual Studio 2022](https:\/\/www.visualstudio.com\/en-us\/downloads\/download-visual-studio-vs.aspx) или выше. **Не путать с VisualStudio Code \/ VSCode\\!** Используйте Английский язык в Visual Studio, чтобы Nuitka корректнее фильтровала вывод компилятора.\n  - Компилятор `MinGW64`. Используется с параметром `--mingw64`. `Nuitka` предложит скачать его, если не найдёт Visual Studio.\n  - Некоторые другие компиляторы, предоставляемые пакетами Visual Studio и MinGW64.\n- **Для Lunux:** используется `GCC-компилятор` или установленный `clang`.\n- **Для macOS:** используется системный Clang. Чтобы получить к нему доступ, установите `XCode` из `Apple Store`.\n### Запуск сборки\nДля запуска выполним следующую команду:\n```\nnuitka --standalone --onefile --output-filename=\"MPF Converting Tool\" \\\r\n--windows-disable-console --windows-icon-from-ico=.\/favicon.ico \\\r\nmain.py\n```\nРазберём параметры:\n\n1. `--standalone` - Собирает приложение с зависимостями, создавая автономный исполняемый файл.\n2. `--onefile` - Упаковывает всё в один файл.\n3. `--output-filename=\"MPF Converting Tool\"` - Указывает имя выходного файла. (Для **Windows** в конец необходимо добавить `.exe`!)\n4. `--windows-disable-console` - Отключает консольное окно для графических приложений.\n5. `--windows-icon-from-ico=.\/favicon.ico` - Добавляет иконку для исполняемого файла.\n6. `main.py` - указывает точку входа в проект.\n### Результат выполнения\nПроцесс компиляции может быть неторопливым и занять какое-то время. В процессе будет создано три директории: `main.build`, `main.dist` и `main.onefile-build`, содержащие временные файлы.\n\nПо окончании в корне проекта появится нужный нам исполняемый файл:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119160648051.png)\n\nТочно также запустим, чтобы убедиться в работоспособности:  \n![](https:\/\/pressanybutton.ru\/media\/post\/2024\/11\/19\/image-20241119160735127.png)\n\n### Итог по использованию Nuitka\nПри беглом знакомстве, `Nuitka` кажется отличным инструментом для создания исполняемых файлов, включаем в себя компиляцию и усложнение \"разбора\" файла на исходный код.\n\nПо результату, мы получили файл размером 31 мегабайт, что меньше результата `PyInstaller` на 10 мегабайт, но не кажется выдающимся успехом. Вероятно, зависит от проекта.\n\n## Заключение\nБыло интересно в процессе написания поста пробовать разное и разбираться, как всё это работает.\n\n### Что лучше — PyInstaller или Nuitka?\n- Если ваша основная цель — быстро собрать исполняемый файл для передачи заказчику, **PyInstaller** подойдёт лучше: он проще в использовании и не требует дополнительных инструментов.\n- Если вы хотите повысить производительность и затруднить разбор программы, выбирайте **Nuitka**.\n\nВсё описанное выше, не призыв к действию, а лишь описание способов защиты своего труда. Способов на самом деле куда больше и каждый следующий сложнее и комплектнее предыдущего. Выбор какой именно применять, остаётся за вами.\n\nЕсли вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https:\/\/t.me\/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.","meta_canonical":null}

3. Robots.txt Check

Query:

Response:

4. Spam/Ban Check

Query:

Response:

5. Seen Status Check

ℹ️ Skipped - page is already crawled

📄

INDEXABLE

✅

CRAWLED

2 days ago

🤖

ROBOTS SERVER UNREACHABLE

Failed to connect to robots server: Operation timed out after 2002 milliseconds with 0 bytes received

Page Info Filters

Filter	Status	Condition	Details
HTTP status	PASS	`download_http_code = 200`	HTTP 200
Age cutoff	PASS	`download_stamp > now() - 6 MONTH`	0.1 months ago
History drop	PASS	`isNull(history_drop_reason)`	No drop reason
Spam/ban	PASS	`fh_dont_index != 1 AND ml_spam_score = 0`	ml_spam_score=0
Canonical	PASS	`meta_canonical IS NULL OR = '' OR = src_unparsed`	Not set

Page Details

Property	Value
URL	https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/
Last Crawled	2026-04-17 15:30:19 (2 days ago)
First Indexed	2024-11-21 11:30:25 (1 year ago)
HTTP Status Code	200
Meta Title	Python-проект в EXE-файл и обфускация кода
Meta Description	<p>В этом посте познакомимся с инструментами, позволяющими превратить Python-проект в exe-файл, а также узнаем, что такое обфускация кода.</p>
Meta Canonical	null
Boilerpipe Text	Работая на фрилансе, помимо выполнения своей задачи, не стоит забывать и о сохранности своего труда. Что я имею в виду? Вам скорее всего известны риски фриланса, когда исполнитель отправляет работу заказчику, а тот пропадает не оплачивая её. Не будем вдаваться в специфику фриланса, а поговорим о безопасных способах передачи "демо версии". Существует несколько способов безопасно продемонстрировать выполненную работу заказчику, минимизируя риски неоплаты: Демонстрация результата через удаленный доступ. Самый простой и очевидный способ - запустить проект на своём компьютере или сервере, предоставив доступ заказчику только к результату (например, запустить Telegram-бота или веб-сервис). Сборка исполняемого файла (exe) Такой способ подойдёт, если проект не требует дополнительных зависимостей, таких как база данных (которую можно запустить и у себя, прописав подключение к ней) или, например, когда задача представляет собой GUI-приложение. Сборка exe-файла с обфускацией кода Этот метод похож на предыдущий, но включает дополнительный уровень защиты: обфускация усложняет чтение и анализ исходного кода. Хотя она не делает код полностью неуязвимым для опытных разработчиков, ее использование может существенно затруднить обратную разработку ( reverse engeneering ). Если первый способ понятен интуитивно, то второй и третий требуют более детального объяснения. Если вам интересны подобные материалы, подписывайтесь на Telegram-канал «Код на салфетке» . Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов. Что такое сборка исполняемого файла (exe)? Сборка в исполняемый ( exe ) файл представляет собой преобразование Python-проекта в файл/файлы, пригодные для запуска в окружении, где может не быть предустановлен интерпретатор Python. Мне известны два способа сборки: Запаковка средствами PyInstaller — это инструмент для упаковки Python-приложений в исполняемые файлы. Он собирает Python-скрипт вместе с необходимыми библиотеками, модулями и интерпретатором Python в один файл или папку, удобные для распространения. Сайт проекта . Пример команды для создания exe -файла: pyinstaller --onefile script.py Компиляция средствами Nuitka — это компилятор для языка Python, который преобразует исходный код Python в машинный код или промежуточный байт-код (в зависимости от настроек), что ускоряет выполнение программ и делает их независимыми от интерпретатора Python. Nuitka также может генерировать исполняемые файлы, которые могут быть запущены без необходимости наличия интерпретатора Python. Сайт проекта . Пример команды для компиляции с использованием Nuitka: nuitka --standalone script.py Каждый из способов обладает своими плюсами и минусами, о которых мы поговорим далее в статье. Что такое обфускация кода? Обфускация кода — это процесс изменения исходного кода программы таким образом, чтобы затруднить понимание для человека, при сохранении работоспособности программы. Обычно обфускация применяется для защиты программного обеспечения от несанкционированного доступа и копирования, а также для усложнения процесса обратной разработки ( reverse engeneering ). Стоит отметить, что обфускация не защищает полностью от реверс-инженеринга. Однако, для полной защиты нужно обладать специально обученными людьми. В контексте фриланса, это отличная защита. Помимо ручного способа, о котором говорить не будем, поскольку это весьма трудозатратное занятие, существует несколько инструментов, вот некоторые из них: PyArmor — это инструмент для защиты Python скриптов от копирования. Он работает путем шифрования исходного кода и его динамической расшифровки во время выполнения. Репозиторий библиотеки . Пример команды для обфускации с использованием PyArmor: pyarmor pack script.py Nuitka — несмотря на то что Nuitka это компилятор Python, он также может использоваться для обфускации кода. Он компилирует исходный код в промежуточный байт-код или машинный код, что затрудняет его понимание. Сайт проекта . Python Minifier — это инструмент для минификации и обфускации Python кода. Он удаляет пробелы, комментарии и документацию из исходного кода, а также может переименовывать переменные и функции в случайные названия. Репозиторий библиотеки . Пример команды для минификации с использованием Python Minifier: pyminify example.py --output example.min.py Что будет рассматриваться в посте? Вариантов для применения и комбинирования методов достаточно много, но мы остановимся на двух: Рассмотрим процесс обфускации кода библиотекой Python Minifier , а затем запакуем его в исполняемый файл библиотекой PyInstaller . Скомпилируем исполняемый файл библиотекой Nuitka . Оба варианты будут независимы и выбор будет за вами. Для большей наглядности мы проведем описанные выше процессы на пррограмме MPF Tools Converter , которую я написал приятелю год назад (написал не лучшим образом, но сейчас не об этом). Для тех, кто хочет ознакомиться: репозиторий на GitHub . Приступим! ⚠️Обратите внимание!⚠️ Результат выполнения сборки зависит от используемой системы! То есть: запустив сборку на Linux, вы получите исполняемый файл для Linux, соответственно, запустив сборку на Windows, вы получите исполняемый файл для Windows. Рабочего способа, собрать из Linux версию для Windows, не прибегая к виртуальной машине я не нашёл. Если вам известен способ, пожалуйста, напишите в комментариях! Python Minifier + PyInstaller С Python Minifier всё понятно по предыдущему блоку: он выполняет минификацию — процесс оптимизации, при котором содержимое файлов сокращается за счёт удаления пробелов, комментариев и других необязательных элементов. Кроме того, инструмент переименовывает переменные и изменяет структуру кода, что делает его сложным для чтения, но позволяет уменьшить размер файлов и повысить их эффективность. Применение Python Minifier Для начала нужно установить библиотеку. Сделаем это выполнив команду: pip install python-minifier По умолчанию он использует "полный набор" минификации, но, если вам что-то не нужно, то в документации указан подробный перечень аргументов запуска: https://dflook.github.io/python-minifier/command_usage.html В моём случае, проект состоит из main.py-файла и пакета app с ещё двумя .py-файлами . Следовательно их нужно или обработать вручную каждый отдельно, либо использовать команду для пакетного изменения. pyminify main.py app/ --in-place Вот так выглядел main.py до применения: А вот так после: Другие файлы: Пример может показаться не очень наглядным и читаемым, т.к. используется многое из библиотеки Flet и на более независимом от библиотек коде картина будет лучше. Тем не менее, разбор всего этого займёт много времени и сил. Можно убедиться, что всё работает корректно запустив программу: Применение PyInstaller Прежде чем приступим, давайте познакомимся с PyInstaller поближе. Основные особенности PyInstaller: Автоматическое обнаружение и включение всех необходимых зависимостей и модулей. Поддержка различных платформ (Windows, macOS, Linux). Возможность создания оконных приложений с использованием библиотек GUI. Как работает PyInstaller? PyInstaller анализирует код Python, определяет зависимости (модули и библиотеки) и включает их в итоговый пакет. Результат может быть представлен: одним большим исполняемым файлом (режим onefile ). папкой с отдельным исполняемым файлом и всеми зависимостями (режим onedir ). PyInstaller использует системный интерпретатор Python, добавляя его в пакет, а затем запускает программу как обычный Python-скрипт внутри скомпилированного окружения. Установка и применение Для установки библиотеки, необходимо выполнить следующую команду: pip install -U pyinstaller У PyInstaller много параметров запуска, позволяющих настроить сборку исполняемого файла "под себя". Полный перечень параметров доступен в документации: https://pyinstaller.org/en/stable/usage.html В моём случае команда будет выглядеть так: pyinstaller --noconfirm --onefile --noconsole \ --name 'MPF Converting Tool' --icon './favicon.ico' \ --add-data './app:app/' \ 'main.py' Разберём параметры: --noconfirm - Этот параметр отключает запрос подтверждения при перезаписи существующих файлов сборки. PyInstaller без дополнительных вопросов заменит ранее созданные файлы. --onefile - Объединяет все зависимости и саму программу в один исполняемый файл. Это удобно для распространения, так как итоговый файл не требует дополнительных папок или библиотек рядом. --noconsole - Убирает отображение консольного окна при запуске программы. Полезно для графических приложений, где консоль не нужна. --name 'MPF Converting Tool' - Задаёт имя для создаваемого исполняемого файла. В данном случае выходной файл будет называться MPF Converting Tool.exe (на Windows) или просто MPF Converting Tool (на Linux/MacOS). --icon './favicon.ico' - Указывает путь к файлу иконки, которая будет использоваться для созданного исполняемого файла. Здесь используется favicon.ico . --add-data './app:app/' - Добавляет дополнительные данные в сборку. В данном случае папка ./app добавляется и будет доступна в приложении как app/ . Формат записи: source:destination . 'main.py' - Основной файл программы, который PyInstaller должен обработать и собрать в исполняемый файл. Результат выполнения Выполнив команду начнётся процесс сборки. Если всё прошло успешно, вы увидите в терминале запись "27927 INFO: Building EXE from EXE-00.toc completed successfully.". В директории из которой был вызван PyInstaller появится две директории: build и dist . В директории build содержатся временные файлы, необходимые для сборки, а в директории dist итоговый исполняемый файл. Откроем директорию dist в файловом менеджере. Там находится исполняемый файл. Запустим его, чтобы удостовериться, что всё работает: Я получил ошибку, что не может найти необходимые файлы. Это нормально, просто положим их рядом: И запустим снова: Слетели размеры окна приложения, но это, скорее всего связанно с запуском на Linux. В остальном программа запустилась и работает корректно. Итог по использованию Python Minifier + PyInstaller Процесс достаточно прост и не вызывает трудностей. Python Minifier неплохо справляется со своей задачей - усложнить чтение кода. Отмечу ещё раз, что это не панацея и есть более продвинутые инструменты, например, тот же PyArmor, который ещё и шифрует файлы, но он куда более сложен в применении и в разрезе задач для фриланса, это кажется излишним. Что касается PyInstaller, то это живая классика. Обратите внимание на размер итогового файла: почти 40 мегабайт! И это всего три .py-файла + несколько библиотек. Всё дело в том, что внутри файла также находится и интерпретатор Python. Компилируем проект в Nuitka Теперь давайте разберёмся, как можно скомпилировать проект с помощью Nuitka и чем этот процесс отличается от использования PyInstaller и обфускации с Python Minifier . Основные особенности Nuitka: Высокая производительность, так как код компилируется в машинный код или промежуточный байт-код. Поддержка большинства функций языка Python и некоторых дополнений. Возможность создания независимых исполняемых файлов. Процесс работы Nuitka: Анализ исходного кода Python для определения всех зависимостей и возможных оптимизаций. Компиляция исходного кода в промежуточный байт-код или машинный код. Создание исполняемого файла, который может быть запущен без необходимости наличия Python. Как Nuitka отличается от PyInstaller? Характеристика PyInstaller Nuitka Тип упаковки Собирает Python-скрипт с интерпретатором и модулями Компилирует Python-код в бинарный файл через C Размер файла Обычно больше, так как включает интерпретатор Меньше, поскольку компилирует код Производительность Производительность такая же, как у исходного кода Выше за счёт оптимизации и машинного кода Совместимость Поддерживает большинство библиотек Python Может возникнуть сложность с модулями C API Цель Быстрая упаковка для распространения Улучшение производительности и компиляция Как видно из таблицы, Nuitka имеет много преимуществ перед PyInstaller , в том числе повышение скорости работы и уменьшение размера исполняемого файла. Нужно ли использовать Python Minifier перед Nuitka? В отличие от сценария с PyInstaller , дополнительная минификация или обфускация кода перед использованием Nuitka обычно не требуется. Сам процесс компиляции уже затрудняет восстановление читаемого кода. Если же вы хотите усилить защиту, Nuitka предлагает платные и бесплатные версии: Бесплатная версия включает базовый функционал компиляции Python-кода в машинный, обеспечивая защиту от простого чтения исходного кода. Платная версия (Commercial Edition) добавляет расширенные возможности, такие как встроенная обфускация, шифрование строковых литералов и дополнительная оптимизация для повышения безопасности. Если вам нужны улучшенные средства защиты, имеет смысл рассмотреть использование коммерческой версии, которая интегрирует функции обфускации прямо в процесс компиляции. Установка Nuitka Для установки необходимо выполнить команду: pip install -U nuitka Для работы, Nuitka требует наличие в системе C-компилятора. Для Windows: Visual Studio 2022 или выше. Не путать с VisualStudio Code / VSCode! Используйте Английский язык в Visual Studio, чтобы Nuitka корректнее фильтровала вывод компилятора. Компилятор MinGW64 . Используется с параметром --mingw64 . Nuitka предложит скачать его, если не найдёт Visual Studio. Некоторые другие компиляторы, предоставляемые пакетами Visual Studio и MinGW64. Для Lunux: используется GCC-компилятор или установленный clang . Для macOS: используется системный Clang. Чтобы получить к нему доступ, установите XCode из Apple Store . Запуск сборки Для запуска выполним следующую команду: nuitka --standalone --onefile --output-filename="MPF Converting Tool" \ --windows-disable-console --windows-icon-from-ico=./favicon.ico \ main.py Разберём параметры: --standalone - Собирает приложение с зависимостями, создавая автономный исполняемый файл. --onefile - Упаковывает всё в один файл. --output-filename="MPF Converting Tool" - Указывает имя выходного файла. (Для Windows в конец необходимо добавить .exe !) --windows-disable-console - Отключает консольное окно для графических приложений. --windows-icon-from-ico=./favicon.ico - Добавляет иконку для исполняемого файла. main.py - указывает точку входа в проект. Результат выполнения Процесс компиляции может быть неторопливым и занять какое-то время. В процессе будет создано три директории: main.build , main.dist и main.onefile-build , содержащие временные файлы. По окончании в корне проекта появится нужный нам исполняемый файл: Точно также запустим, чтобы убедиться в работоспособности: Итог по использованию Nuitka При беглом знакомстве, Nuitka кажется отличным инструментом для создания исполняемых файлов, включаем в себя компиляцию и усложнение "разбора" файла на исходный код. По результату, мы получили файл размером 31 мегабайт, что меньше результата PyInstaller на 10 мегабайт, но не кажется выдающимся успехом. Вероятно, зависит от проекта. Заключение Было интересно в процессе написания поста пробовать разное и разбираться, как всё это работает. Что лучше — PyInstaller или Nuitka? Если ваша основная цель — быстро собрать исполняемый файл для передачи заказчику, PyInstaller подойдёт лучше: он проще в использовании и не требует дополнительных инструментов. Если вы хотите повысить производительность и затруднить разбор программы, выбирайте Nuitka . Всё описанное выше, не призыв к действию, а лишь описание способов защиты своего труда. Способов на самом деле куда больше и каждый следующий сложнее и комплектнее предыдущего. Выбор какой именно применять, остаётся за вами. Если вам интересны подобные материалы, подписывайтесь на Telegram-канал «Код на салфетке» . Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.
Markdown	![](https://mc.yandex.ru/watch/94235360) [Перейти к контенту](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#content) [Код на салфетке](https://pressanybutton.ru/) ##### Меню - [Категории](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/) - [Гайды](https://pressanybutton.ru/category/gajdy/) - [Путь в IT](https://pressanybutton.ru/category/put-v-it/) - [Новости](https://pressanybutton.ru/category/novosti/) - [Код в мешке](https://pressanybutton.ru/category/kod-v-meshke/) - [Видео](https://pressanybutton.ru/category/video/) - [Obsidian для пользователя](https://pressanybutton.ru/category/obsidian-dlya-polzovatelya/) - [Open Source](https://pressanybutton.ru/category/nashi-open-source-proekty/) - [База-знаний](https://pressanybutton.ru/category/baza-znanij/) - [Сравнение Python и С/C++](https://pressanybutton.ru/category/sravnenie-python-i-s-cpp/) - [Эксперименты с ИИ](https://pressanybutton.ru/category/eksperimenty-s-ii/) Тема [Вход](https://pressanybutton.ru/user/login/) [Регистрация](https://pressanybutton.ru/user/signup/) 1. [Главная](https://pressanybutton.ru/) 2. [Полезные инструменты](https://pressanybutton.ru/category/poleznye-instrumenty/) 3. Python-проект в EXE-файл и обфускация кода # Python-проект в EXE-файл и обфускация кода [Полезные инструменты](https://pressanybutton.ru/category/poleznye-instrumenty/) • [Иван Ашихмин](https://pressanybutton.ru/user/proDream/) • 21 Ноябрь 2024 • 6046 [Гайды](https://pressanybutton.ru/tag/%D0%B3%D0%B0%D0%B9%D0%B4%D1%8B/) [Полезные инструменты](https://pressanybutton.ru/tag/%D0%BF%D0%BE%D0%BB%D0%B5%D0%B7%D0%BD%D1%8B%D0%B5-%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B/) [защита](https://pressanybutton.ru/tag/%D0%B7%D0%B0%D1%89%D0%B8%D1%82%D0%B0/) [pyinstaller](https://pressanybutton.ru/tag/pyinstaller/) [python minifier](https://pressanybutton.ru/tag/python-minifier/) [обфускация](https://pressanybutton.ru/tag/%D0%BE%D0%B1%D1%84%D1%83%D1%81%D0%BA%D0%B0%D1%86%D0%B8%D1%8F/) [компиляция](https://pressanybutton.ru/tag/%D0%BA%D0%BE%D0%BC%D0%BF%D0%B8%D0%BB%D1%8F%D1%86%D0%B8%D1%8F/) [nuitka](https://pressanybutton.ru/tag/nuitka/) [pyarmor](https://pressanybutton.ru/tag/pyarmor/) [exe](https://pressanybutton.ru/tag/exe/) В этом посте познакомимся с инструментами, позволяющими превратить Python-проект в exe-файл, а также узнаем, что такое обфускация кода. ![Python-проект в EXE-файл и обфускация кода](https://pressanybutton.ru/media/post/2024/11/21/%D0%BE%D0%B1%D0%BB%D0%BE%D0%B6%D0%BA%D0%B0_6.png) [Полезные инструменты](https://pressanybutton.ru/category/poleznye-instrumenty/) • [Иван Ашихмин](https://pressanybutton.ru/user/proDream/) • 21 Ноябрь 2024 • 6046 [← Предыдущая](https://pressanybutton.ru/post/poleznye-instrumenty/obsidian-livesync-sovmestnaya-rabota-nad-proektnoj/) [Следующая →](https://pressanybutton.ru/post/poleznye-instrumenty/besplatnyj-analog-chatgpt-na-svoyom-pk/) Работая на фрилансе, помимо выполнения своей задачи, не стоит забывать и о сохранности своего труда. Что я имею в виду? Вам скорее всего известны риски фриланса, когда исполнитель отправляет работу заказчику, а тот пропадает не оплачивая её. Не будем вдаваться в специфику фриланса, а поговорим о безопасных способах передачи "демо версии". Существует несколько способов безопасно продемонстрировать выполненную работу заказчику, минимизируя риски неоплаты: 1. Демонстрация результата через удаленный доступ. Самый простой и очевидный способ - запустить проект на своём компьютере или сервере, предоставив доступ заказчику только к результату (например, запустить Telegram-бота или веб-сервис). 2. Сборка исполняемого файла (exe) Такой способ подойдёт, если проект не требует дополнительных зависимостей, таких как база данных (которую можно запустить и у себя, прописав подключение к ней) или, например, когда задача представляет собой GUI-приложение. 3. Сборка exe-файла с обфускацией кода Этот метод похож на предыдущий, но включает дополнительный уровень защиты: обфускация усложняет чтение и анализ исходного кода. Хотя она не делает код полностью неуязвимым для опытных разработчиков, ее использование может существенно затруднить обратную разработку (`reverse engeneering`). Если первый способ понятен интуитивно, то второй и третий требуют более детального объяснения. Если вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https://t.me/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов. ## Что такое сборка исполняемого файла (exe)? Сборка в исполняемый (`exe`) файл представляет собой преобразование Python-проекта в файл/файлы, пригодные для запуска в окружении, где может не быть предустановлен интерпретатор Python. Мне известны два способа сборки: 1. Запаковка средствами PyInstaller — это инструмент для упаковки Python-приложений в исполняемые файлы. Он собирает Python-скрипт вместе с необходимыми библиотеками, модулями и интерпретатором Python в один файл или папку, удобные для распространения. [Сайт проекта](https://pyinstaller.org/en/stable/). Пример команды для создания `exe`\-файла: ``` pyinstaller --onefile script.py ``` 1. Компиляция средствами Nuitka — это компилятор для языка Python, который преобразует исходный код Python в машинный код или промежуточный байт-код (в зависимости от настроек), что ускоряет выполнение программ и делает их независимыми от интерпретатора Python. Nuitka также может генерировать исполняемые файлы, которые могут быть запущены без необходимости наличия интерпретатора Python. [Сайт проекта](https://nuitka.net/). Пример команды для компиляции с использованием Nuitka: ``` nuitka --standalone script.py ``` Каждый из способов обладает своими плюсами и минусами, о которых мы поговорим далее в статье. ## Что такое обфускация кода? Обфускация кода — это процесс изменения исходного кода программы таким образом, чтобы затруднить понимание для человека, при сохранении работоспособности программы. Обычно обфускация применяется для защиты программного обеспечения от несанкционированного доступа и копирования, а также для усложнения процесса обратной разработки (`reverse engeneering`). Стоит отметить, что обфускация не защищает полностью от реверс-инженеринга. Однако, для полной защиты нужно обладать специально обученными людьми. В контексте фриланса, это отличная защита. Помимо ручного способа, о котором говорить не будем, поскольку это весьма трудозатратное занятие, существует несколько инструментов, вот некоторые из них: 1. PyArmor — это инструмент для защиты Python скриптов от копирования. Он работает путем шифрования исходного кода и его динамической расшифровки во время выполнения. [Репозиторий библиотеки](https://github.com/dashingsoft/pyarmor). Пример команды для обфускации с использованием PyArmor: ``` pyarmor pack script.py ``` 1. Nuitka — несмотря на то что Nuitka это компилятор Python, он также может использоваться для обфускации кода. Он компилирует исходный код в промежуточный байт-код или машинный код, что затрудняет его понимание. [Сайт проекта](https://nuitka.net/). 2. Python Minifier — это инструмент для минификации и обфускации Python кода. Он удаляет пробелы, комментарии и документацию из исходного кода, а также может переименовывать переменные и функции в случайные названия. [Репозиторий библиотеки](https://github.com/dflook/python-minifier). Пример команды для минификации с использованием Python Minifier: ``` pyminify example.py --output example.min.py ``` ## Что будет рассматриваться в посте? Вариантов для применения и комбинирования методов достаточно много, но мы остановимся на двух: 1. Рассмотрим процесс обфускации кода библиотекой `Python Minifier`, а затем запакуем его в исполняемый файл библиотекой `PyInstaller`. 2. Скомпилируем исполняемый файл библиотекой `Nuitka`. Оба варианты будут независимы и выбор будет за вами. Для большей наглядности мы проведем описанные выше процессы на пррограмме `MPF Tools Converter`, которую я написал приятелю год назад (написал не лучшим образом, но сейчас не об этом). Для тех, кто хочет ознакомиться: [репозиторий на GitHub](https://github.com/proDreams/mpf_tools_converter). Приступим\! ### ⚠️Обратите внимание!⚠️ Результат выполнения сборки зависит от используемой системы! То есть: запустив сборку на Linux, вы получите исполняемый файл для Linux, соответственно, запустив сборку на Windows, вы получите исполняемый файл для Windows. Рабочего способа, собрать из Linux версию для Windows, не прибегая к виртуальной машине я не нашёл. Если вам известен способ, пожалуйста, напишите в комментариях\! ## Python Minifier + PyInstaller С `Python Minifier` всё понятно по предыдущему блоку: он выполняет минификацию — процесс оптимизации, при котором содержимое файлов сокращается за счёт удаления пробелов, комментариев и других необязательных элементов. Кроме того, инструмент переименовывает переменные и изменяет структуру кода, что делает его сложным для чтения, но позволяет уменьшить размер файлов и повысить их эффективность. ### Применение Python Minifier Для начала нужно установить библиотеку. Сделаем это выполнив команду: ``` pip install python-minifier ``` По умолчанию он использует "полный набор" минификации, но, если вам что-то не нужно, то в документации указан подробный перечень аргументов запуска: <https://dflook.github.io/python-minifier/command_usage.html> В моём случае, проект состоит из `main.py-файла` и пакета `app` с ещё двумя `.py-файлами`. Следовательно их нужно или обработать вручную каждый отдельно, либо использовать команду для пакетного изменения. ``` pyminify main.py app/ --in-place ``` Вот так выглядел `main.py` до применения: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134649520.png) А вот так после: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134726037.png) Другие файлы: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134749102.png) ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134809732.png) Пример может показаться не очень наглядным и читаемым, т.к. используется многое из библиотеки Flet и на более независимом от библиотек коде картина будет лучше. Тем не менее, разбор всего этого займёт много времени и сил. Можно убедиться, что всё работает корректно запустив программу: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119135016799.png) ### Применение PyInstaller Прежде чем приступим, давайте познакомимся с `PyInstaller` поближе. #### Основные особенности PyInstaller: - Автоматическое обнаружение и включение всех необходимых зависимостей и модулей. - Поддержка различных платформ (Windows, macOS, Linux). - Возможность создания оконных приложений с использованием библиотек GUI. #### Как работает PyInstaller? PyInstaller анализирует код Python, определяет зависимости (модули и библиотеки) и включает их в итоговый пакет. Результат может быть представлен: - одним большим исполняемым файлом (режим `onefile`). - папкой с отдельным исполняемым файлом и всеми зависимостями (режим `onedir`). PyInstaller использует системный интерпретатор Python, добавляя его в пакет, а затем запускает программу как обычный Python-скрипт внутри скомпилированного окружения. #### Установка и применение Для установки библиотеки, необходимо выполнить следующую команду: ``` pip install -U pyinstaller ``` У PyInstaller много параметров запуска, позволяющих настроить сборку исполняемого файла "под себя". Полный перечень параметров доступен в документации: <https://pyinstaller.org/en/stable/usage.html> В моём случае команда будет выглядеть так: ``` pyinstaller --noconfirm --onefile --noconsole \ --name 'MPF Converting Tool' --icon './favicon.ico' \ --add-data './app:app/' \ 'main.py' ``` Разберём параметры: - `--noconfirm` - Этот параметр отключает запрос подтверждения при перезаписи существующих файлов сборки. PyInstaller без дополнительных вопросов заменит ранее созданные файлы. - `--onefile` - Объединяет все зависимости и саму программу в один исполняемый файл. Это удобно для распространения, так как итоговый файл не требует дополнительных папок или библиотек рядом. - `--noconsole` - Убирает отображение консольного окна при запуске программы. Полезно для графических приложений, где консоль не нужна. - `--name 'MPF Converting Tool'` - Задаёт имя для создаваемого исполняемого файла. В данном случае выходной файл будет называться `MPF Converting Tool.exe` (на Windows) или просто `MPF Converting Tool` (на Linux/MacOS). - `--icon './favicon.ico'` - Указывает путь к файлу иконки, которая будет использоваться для созданного исполняемого файла. Здесь используется `favicon.ico`. - `--add-data './app:app/'` - Добавляет дополнительные данные в сборку. В данном случае папка `./app` добавляется и будет доступна в приложении как `app/`. Формат записи: `source:destination`. - `'main.py'` - Основной файл программы, который PyInstaller должен обработать и собрать в исполняемый файл. #### Результат выполнения Выполнив команду начнётся процесс сборки. Если всё прошло успешно, вы увидите в терминале запись "27927 INFO: Building EXE from EXE-00.toc completed successfully.". В директории из которой был вызван PyInstaller появится две директории: `build` и `dist`. ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142053005.png) В директории `build` содержатся временные файлы, необходимые для сборки, а в директории `dist` итоговый исполняемый файл. Откроем директорию `dist` в файловом менеджере. Там находится исполняемый файл. ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142153175.png) Запустим его, чтобы удостовериться, что всё работает: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142232500.png) Я получил ошибку, что не может найти необходимые файлы. Это нормально, просто положим их рядом: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142320092.png) И запустим снова: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142346840.png) Слетели размеры окна приложения, но это, скорее всего связанно с запуском на Linux. В остальном программа запустилась и работает корректно. ### Итог по использованию Python Minifier + PyInstaller Процесс достаточно прост и не вызывает трудностей. Python Minifier неплохо справляется со своей задачей - усложнить чтение кода. Отмечу ещё раз, что это не панацея и есть более продвинутые инструменты, например, тот же PyArmor, который ещё и шифрует файлы, но он куда более сложен в применении и в разрезе задач для фриланса, это кажется излишним. Что касается PyInstaller, то это живая классика. Обратите внимание на размер итогового файла: почти 40 мегабайт! И это всего три `.py-файла` + несколько библиотек. Всё дело в том, что внутри файла также находится и интерпретатор Python. ## Компилируем проект в Nuitka Теперь давайте разберёмся, как можно скомпилировать проект с помощью Nuitka и чем этот процесс отличается от использования PyInstaller и обфускации с Python Minifier. ### Основные особенности Nuitka: - Высокая производительность, так как код компилируется в машинный код или промежуточный байт-код. - Поддержка большинства функций языка Python и некоторых дополнений. - Возможность создания независимых исполняемых файлов. ### Процесс работы Nuitka: 1. Анализ исходного кода Python для определения всех зависимостей и возможных оптимизаций. 2. Компиляция исходного кода в промежуточный байт-код или машинный код. 3. Создание исполняемого файла, который может быть запущен без необходимости наличия Python. ### Как Nuitka отличается от PyInstaller? \| Характеристика \| PyInstaller \| Nuitka \| \|---\|---\|---\| \| Тип упаковки \| Собирает Python-скрипт с интерпретатором и модулями \| Компилирует Python-код в бинарный файл через C \| \| Размер файла \| Обычно больше, так как включает интерпретатор \| Меньше, поскольку компилирует код \| \| Производительность \| Производительность такая же, как у исходного кода \| Выше за счёт оптимизации и машинного кода \| \| Совместимость \| Поддерживает большинство библиотек Python \| Может возникнуть сложность с модулями C API \| \| Цель \| Быстрая упаковка для распространения \| Улучшение производительности и компиляция \| Как видно из таблицы, `Nuitka` имеет много преимуществ перед `PyInstaller`, в том числе повышение скорости работы и уменьшение размера исполняемого файла. ### Нужно ли использовать Python Minifier перед Nuitka? В отличие от сценария с `PyInstaller`, дополнительная минификация или обфускация кода перед использованием `Nuitka` обычно не требуется. Сам процесс компиляции уже затрудняет восстановление читаемого кода. Если же вы хотите усилить защиту, `Nuitka` предлагает платные и бесплатные версии: - Бесплатная версия включает базовый функционал компиляции Python-кода в машинный, обеспечивая защиту от простого чтения исходного кода. - Платная версия (Commercial Edition) добавляет расширенные возможности, такие как встроенная обфускация, шифрование строковых литералов и дополнительная оптимизация для повышения безопасности. Если вам нужны улучшенные средства защиты, имеет смысл рассмотреть использование коммерческой версии, которая интегрирует функции обфускации прямо в процесс компиляции. ### Установка Nuitka Для установки необходимо выполнить команду: ``` pip install -U nuitka ``` Для работы, Nuitka требует наличие в системе C-компилятора. - Для Windows: - [Visual Studio 2022](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx) или выше. Не путать с VisualStudio Code / VSCode\! Используйте Английский язык в Visual Studio, чтобы Nuitka корректнее фильтровала вывод компилятора. - Компилятор `MinGW64`. Используется с параметром `--mingw64`. `Nuitka` предложит скачать его, если не найдёт Visual Studio. - Некоторые другие компиляторы, предоставляемые пакетами Visual Studio и MinGW64. - Для Lunux: используется `GCC-компилятор` или установленный `clang`. - Для macOS: используется системный Clang. Чтобы получить к нему доступ, установите `XCode` из `Apple Store`. ### Запуск сборки Для запуска выполним следующую команду: ``` nuitka --standalone --onefile --output-filename="MPF Converting Tool" \ --windows-disable-console --windows-icon-from-ico=./favicon.ico \ main.py ``` Разберём параметры: 1. `--standalone` - Собирает приложение с зависимостями, создавая автономный исполняемый файл. 2. `--onefile` - Упаковывает всё в один файл. 3. `--output-filename="MPF Converting Tool"` - Указывает имя выходного файла. (Для Windows в конец необходимо добавить `.exe`!) 4. `--windows-disable-console` - Отключает консольное окно для графических приложений. 5. `--windows-icon-from-ico=./favicon.ico` - Добавляет иконку для исполняемого файла. 6. `main.py` - указывает точку входа в проект. ### Результат выполнения Процесс компиляции может быть неторопливым и занять какое-то время. В процессе будет создано три директории: `main.build`, `main.dist` и `main.onefile-build`, содержащие временные файлы. По окончании в корне проекта появится нужный нам исполняемый файл: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119160648051.png) Точно также запустим, чтобы убедиться в работоспособности: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119160735127.png) ### Итог по использованию Nuitka При беглом знакомстве, `Nuitka` кажется отличным инструментом для создания исполняемых файлов, включаем в себя компиляцию и усложнение "разбора" файла на исходный код. По результату, мы получили файл размером 31 мегабайт, что меньше результата `PyInstaller` на 10 мегабайт, но не кажется выдающимся успехом. Вероятно, зависит от проекта. ## Заключение Было интересно в процессе написания поста пробовать разное и разбираться, как всё это работает. ### Что лучше — PyInstaller или Nuitka? - Если ваша основная цель — быстро собрать исполняемый файл для передачи заказчику, PyInstaller подойдёт лучше: он проще в использовании и не требует дополнительных инструментов. - Если вы хотите повысить производительность и затруднить разбор программы, выбирайте Nuitka. Всё описанное выше, не призыв к действию, а лишь описание способов защиты своего труда. Способов на самом деле куда больше и каждый следующий сложнее и комплектнее предыдущего. Выбор какой именно применять, остаётся за вами. Если вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https://t.me/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов. Если заметили ошибку — напишите в Telegram автора. ![Аватар автора](https://pressanybutton.ru/media/user/avatars/proDreamss.png) ### Автор #### [Иван Ашихмин](https://pressanybutton.ru/user/proDream/) Программист, фрилансер и автор гайдов. Занимаюсь разработкой ботов, сайтов и не только. [Telegram](https://t.me/proDreams) [GitHub](https://github.com/proDreams) [Сайт](https://pressanybutton.ru/) [Поддержать](https://boosty.to/prodream) ## Комментарии ⬆️ Наверх ## Все статьи × - [Selectolax: быстрая альтернатива Beautiful Soup](https://pressanybutton.ru/post/poleznye-instrumenty/selectolax-bystraya-alternativa-beautiful-soup/) 30 Октябрь 2025 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/selectolax-bystraya-alternativa-beautiful-soup/#comments) - [Обзор WSGI, ASGI и RSGI: лидеры среди веб-серверов в 2025 году](https://pressanybutton.ru/post/poleznye-instrumenty/obzor-wsgi-asgi-i-rsgi-lidery-sredi-veb-serverov-v-2025-godu/) 18 Сентябрь 2025 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/obzor-wsgi-asgi-i-rsgi-lidery-sredi-veb-serverov-v-2025-godu/#comments) - [Napkin Random Bot: как мы создали бота для честных розыгрышей](https://pressanybutton.ru/post/poleznye-instrumenty/napkin-random-bot-kak-my-sozdali-bota-dlya-chestnyh-rozygryshej/) 04 Сентябрь 2025 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/napkin-random-bot-kak-my-sozdali-bota-dlya-chestnyh-rozygryshej/#comments) - [Uptime Kuma 2 установка и мониторинг сервисов без VPS](https://pressanybutton.ru/post/poleznye-instrumenty/uptime-kuma-2-ustanovka-i-monitoring-servisov-bez-vps/) 28 Август 2025 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/uptime-kuma-2-ustanovka-i-monitoring-servisov-bez-vps/#comments) - [Бесплатный аналог ChatGPT на своём ПК](https://pressanybutton.ru/post/poleznye-instrumenty/besplatnyj-analog-chatgpt-na-svoyom-pk/) 28 Ноябрь 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/besplatnyj-analog-chatgpt-na-svoyom-pk/#comments) - [Python-проект в EXE-файл и обфускация кода](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/) 21 Ноябрь 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#comments) Вы читаете - [Obsidian LiveSync - совместная работа над проектной документацией](https://pressanybutton.ru/post/poleznye-instrumenty/obsidian-livesync-sovmestnaya-rabota-nad-proektnoj/) 10 Октябрь 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/obsidian-livesync-sovmestnaya-rabota-nad-proektnoj/#comments) - [Веб-сервер Caddy - Альтернатива NGINX и Apache](https://pressanybutton.ru/post/poleznye-instrumenty/veb-server-caddy-alternativa-nginx-i-apache/) 15 Август 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/veb-server-caddy-alternativa-nginx-i-apache/#comments) - [Создание резервных копий VPS на Яндекс Диск](https://pressanybutton.ru/post/poleznye-instrumenty/sozdanie-rezervnyh-kopij-vps-na-yandeks-disk/) 27 Март 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/sozdanie-rezervnyh-kopij-vps-na-yandeks-disk/#comments) - [Разворачивание Django-проекта на Replit](https://pressanybutton.ru/post/poleznye-instrumenty/razvorachivanie-django-proekta-na-replit/) 06 Март 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/razvorachivanie-django-proekta-na-replit/#comments) - [Разворачивание Django-проекта на PythonAnyWhere](https://pressanybutton.ru/post/poleznye-instrumenty/razvorachivanie-django-proekta-na-pythonanywhere/) 08 Февраль 2024 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/razvorachivanie-django-proekta-na-pythonanywhere/#comments) - [Cpp FreeGPT WebUI - Бесплатный GPT на вашем сервере](https://pressanybutton.ru/post/poleznye-instrumenty/cpp-freegpt-webui-besplatnyj-gpt-na-vashem-servere/) 29 Сентябрь 2023 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/cpp-freegpt-webui-besplatnyj-gpt-na-vashem-servere/#comments) - [Certbot - бесплатный SSL-сертификат для сайта](https://pressanybutton.ru/post/poleznye-instrumenty/certbot-besplatnyj-ssl-sertifikat-dlya-sajta/) 22 Сентябрь 2023 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/certbot-besplatnyj-ssl-sertifikat-dlya-sajta/#comments) - [Полезные инструменты. Переключатель цветовой темы в Bootstrap5](https://pressanybutton.ru/post/poleznye-instrumenty/poleznye-instrumenty-pereklyuchatel-cvetovoj-temy/) 06 Сентябрь 2023 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/poleznye-instrumenty-pereklyuchatel-cvetovoj-temy/#comments) - [Полезные инструменты. Jazzmin - шаблон панели администратора Django](https://pressanybutton.ru/post/poleznye-instrumenty/poleznye-instrumenty-jazzmin-shablon-paneli-admini/) 06 Сентябрь 2023 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/poleznye-instrumenty-jazzmin-shablon-paneli-admini/#comments) - [НЕ АКТУАЛЬНО! Бесплатный Chat-GPT4 на вашем ПК или сервере](https://pressanybutton.ru/post/poleznye-instrumenty/besplatnyj-chat-gpt4-na-vashem-pk-ili-servere/) 02 Август 2023 [Комментарии](https://pressanybutton.ru/post/poleznye-instrumenty/besplatnyj-chat-gpt4-na-vashem-pk-ili-servere/#comments) Ничего не найдено. Измените запрос. ### Ссылки - ![Поддержать проект](https://pressanybutton.ru/media/social-links/Color.png) [Поддержать проект](https://boosty.to/prodream) - ![RSS-лента последних постов](https://pressanybutton.ru/media/social-links/icons8-rss-32.png) [RSS-лента последних постов](https://pressanybutton.ru/feeds/latest/) - ![Telegram-канал](https://pressanybutton.ru/media/social-links/icons8-%D1%82%D0%B5%D0%BB%D0%B5%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B0-app-32.png) [Telegram-канал](https://t.me/napkincode) ## Оглавление - [Что такое сборка исполняемого файла (exe)?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#chto-takoe-sborka-ispolnyaemogo-fajla-exe) - [Что такое обфускация кода?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#chto-takoe-obfuskatsiya-koda) - [Что будет рассматриваться в посте?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#chto-budet-rassmatrivatsya-v-poste) - [⚠️Обратите внимание!⚠️](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#obratite-vnimanie) - [Python Minifier + PyInstaller](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#python-minifier--pyinstaller) - [Применение Python Minifier](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#primenenie-python-minifier) - [Применение PyInstaller](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#primenenie-pyinstaller) - [Основные особенности PyInstaller:](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#osnovnyie-osobennosti-pyinstaller) - [Как работает PyInstaller?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#kak-rabotaet-pyinstaller) - [Установка и применение](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#ustanovka-i-primenenie) - [Результат выполнения](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#rezultat-vyipolneniya) - [Итог по использованию Python Minifier + PyInstaller](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#itog-po-ispolzovaniyu-python-minifier--pyinstaller) - [Компилируем проект в Nuitka](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#kompiliruem-proekt-v-nuitka) - [Основные особенности Nuitka:](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#osnovnyie-osobennosti-nuitka) - [Процесс работы Nuitka:](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#protsess-rabotyi-nuitka) - [Как Nuitka отличается от PyInstaller?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#kak-nuitka-otlichaetsya-ot-pyinstaller) - [Нужно ли использовать Python Minifier перед Nuitka?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#nuzhno-li-ispolzovat-python-minifier-pered-nuitka) - [Установка Nuitka](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#ustanovka-nuitka) - [Запуск сборки](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#zapusk-sborki) - [Результат выполнения](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#rezultat-vyipolneniya) - [Итог по использованию Nuitka](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#itog-po-ispolzovaniyu-nuitka) - [Заключение](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#zaklyuchenie) - [Что лучше — PyInstaller или Nuitka?](https://pressanybutton.ru/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/#chto-luchshe---pyinstaller-ili-nuitka) ### Поделиться [Код на салфетке](https://pressanybutton.ru/) Гайды, статьи и проекты про разработку. ###### Навигация - [Гайды](https://pressanybutton.ru/category/gajdy/) - [Свежие статьи](https://pressanybutton.ru/#latest) ###### Правовая информация - [Политика обработки персональных данных](https://pressanybutton.ru/privacy-policy/) Использование материалов сайта pressanybutton.ru разрешено только c письменного согласия авторов. *** 2023–2026 © «Код на салфетке» [Telegram](https://t.me/press_any_button) [info@pressanybutton.ru](mailto:info@pressanybutton.ru) ↑ Наверх Этот сайт использует cookie для улучшения вашего опыта. Согласен
Readable Markdown	Работая на фрилансе, помимо выполнения своей задачи, не стоит забывать и о сохранности своего труда. Что я имею в виду? Вам скорее всего известны риски фриланса, когда исполнитель отправляет работу заказчику, а тот пропадает не оплачивая её. Не будем вдаваться в специфику фриланса, а поговорим о безопасных способах передачи "демо версии". Существует несколько способов безопасно продемонстрировать выполненную работу заказчику, минимизируя риски неоплаты: 1. Демонстрация результата через удаленный доступ. Самый простой и очевидный способ - запустить проект на своём компьютере или сервере, предоставив доступ заказчику только к результату (например, запустить Telegram-бота или веб-сервис). 2. Сборка исполняемого файла (exe) Такой способ подойдёт, если проект не требует дополнительных зависимостей, таких как база данных (которую можно запустить и у себя, прописав подключение к ней) или, например, когда задача представляет собой GUI-приложение. 3. Сборка exe-файла с обфускацией кода Этот метод похож на предыдущий, но включает дополнительный уровень защиты: обфускация усложняет чтение и анализ исходного кода. Хотя она не делает код полностью неуязвимым для опытных разработчиков, ее использование может существенно затруднить обратную разработку (`reverse engeneering`). Если первый способ понятен интуитивно, то второй и третий требуют более детального объяснения. Если вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https://t.me/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов. ## Что такое сборка исполняемого файла (exe)? Сборка в исполняемый (`exe`) файл представляет собой преобразование Python-проекта в файл/файлы, пригодные для запуска в окружении, где может не быть предустановлен интерпретатор Python. Мне известны два способа сборки: 1. Запаковка средствами PyInstaller — это инструмент для упаковки Python-приложений в исполняемые файлы. Он собирает Python-скрипт вместе с необходимыми библиотеками, модулями и интерпретатором Python в один файл или папку, удобные для распространения. [Сайт проекта](https://pyinstaller.org/en/stable/). Пример команды для создания `exe`\-файла: ``` pyinstaller --onefile script.py ``` 1. Компиляция средствами Nuitka — это компилятор для языка Python, который преобразует исходный код Python в машинный код или промежуточный байт-код (в зависимости от настроек), что ускоряет выполнение программ и делает их независимыми от интерпретатора Python. Nuitka также может генерировать исполняемые файлы, которые могут быть запущены без необходимости наличия интерпретатора Python. [Сайт проекта](https://nuitka.net/). Пример команды для компиляции с использованием Nuitka: ``` nuitka --standalone script.py ``` Каждый из способов обладает своими плюсами и минусами, о которых мы поговорим далее в статье. ## Что такое обфускация кода? Обфускация кода — это процесс изменения исходного кода программы таким образом, чтобы затруднить понимание для человека, при сохранении работоспособности программы. Обычно обфускация применяется для защиты программного обеспечения от несанкционированного доступа и копирования, а также для усложнения процесса обратной разработки (`reverse engeneering`). Стоит отметить, что обфускация не защищает полностью от реверс-инженеринга. Однако, для полной защиты нужно обладать специально обученными людьми. В контексте фриланса, это отличная защита. Помимо ручного способа, о котором говорить не будем, поскольку это весьма трудозатратное занятие, существует несколько инструментов, вот некоторые из них: 1. PyArmor — это инструмент для защиты Python скриптов от копирования. Он работает путем шифрования исходного кода и его динамической расшифровки во время выполнения. [Репозиторий библиотеки](https://github.com/dashingsoft/pyarmor). Пример команды для обфускации с использованием PyArmor: ``` pyarmor pack script.py ``` 1. Nuitka — несмотря на то что Nuitka это компилятор Python, он также может использоваться для обфускации кода. Он компилирует исходный код в промежуточный байт-код или машинный код, что затрудняет его понимание. [Сайт проекта](https://nuitka.net/). 2. Python Minifier — это инструмент для минификации и обфускации Python кода. Он удаляет пробелы, комментарии и документацию из исходного кода, а также может переименовывать переменные и функции в случайные названия. [Репозиторий библиотеки](https://github.com/dflook/python-minifier). Пример команды для минификации с использованием Python Minifier: ``` pyminify example.py --output example.min.py ``` ## Что будет рассматриваться в посте? Вариантов для применения и комбинирования методов достаточно много, но мы остановимся на двух: 1. Рассмотрим процесс обфускации кода библиотекой `Python Minifier`, а затем запакуем его в исполняемый файл библиотекой `PyInstaller`. 2. Скомпилируем исполняемый файл библиотекой `Nuitka`. Оба варианты будут независимы и выбор будет за вами. Для большей наглядности мы проведем описанные выше процессы на пррограмме `MPF Tools Converter`, которую я написал приятелю год назад (написал не лучшим образом, но сейчас не об этом). Для тех, кто хочет ознакомиться: [репозиторий на GitHub](https://github.com/proDreams/mpf_tools_converter). Приступим\! ### ⚠️Обратите внимание!⚠️ Результат выполнения сборки зависит от используемой системы! То есть: запустив сборку на Linux, вы получите исполняемый файл для Linux, соответственно, запустив сборку на Windows, вы получите исполняемый файл для Windows. Рабочего способа, собрать из Linux версию для Windows, не прибегая к виртуальной машине я не нашёл. Если вам известен способ, пожалуйста, напишите в комментариях\! ## Python Minifier + PyInstaller С `Python Minifier` всё понятно по предыдущему блоку: он выполняет минификацию — процесс оптимизации, при котором содержимое файлов сокращается за счёт удаления пробелов, комментариев и других необязательных элементов. Кроме того, инструмент переименовывает переменные и изменяет структуру кода, что делает его сложным для чтения, но позволяет уменьшить размер файлов и повысить их эффективность. ### Применение Python Minifier Для начала нужно установить библиотеку. Сделаем это выполнив команду: ``` pip install python-minifier ``` По умолчанию он использует "полный набор" минификации, но, если вам что-то не нужно, то в документации указан подробный перечень аргументов запуска: <https://dflook.github.io/python-minifier/command_usage.html> В моём случае, проект состоит из `main.py-файла` и пакета `app` с ещё двумя `.py-файлами`. Следовательно их нужно или обработать вручную каждый отдельно, либо использовать команду для пакетного изменения. ``` pyminify main.py app/ --in-place ``` Вот так выглядел `main.py` до применения: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134649520.png) А вот так после: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134726037.png) Другие файлы: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134749102.png) ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119134809732.png) Пример может показаться не очень наглядным и читаемым, т.к. используется многое из библиотеки Flet и на более независимом от библиотек коде картина будет лучше. Тем не менее, разбор всего этого займёт много времени и сил. Можно убедиться, что всё работает корректно запустив программу: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119135016799.png) ### Применение PyInstaller Прежде чем приступим, давайте познакомимся с `PyInstaller` поближе. #### Основные особенности PyInstaller: - Автоматическое обнаружение и включение всех необходимых зависимостей и модулей. - Поддержка различных платформ (Windows, macOS, Linux). - Возможность создания оконных приложений с использованием библиотек GUI. #### Как работает PyInstaller? PyInstaller анализирует код Python, определяет зависимости (модули и библиотеки) и включает их в итоговый пакет. Результат может быть представлен: - одним большим исполняемым файлом (режим `onefile`). - папкой с отдельным исполняемым файлом и всеми зависимостями (режим `onedir`). PyInstaller использует системный интерпретатор Python, добавляя его в пакет, а затем запускает программу как обычный Python-скрипт внутри скомпилированного окружения. #### Установка и применение Для установки библиотеки, необходимо выполнить следующую команду: ``` pip install -U pyinstaller ``` У PyInstaller много параметров запуска, позволяющих настроить сборку исполняемого файла "под себя". Полный перечень параметров доступен в документации: <https://pyinstaller.org/en/stable/usage.html> В моём случае команда будет выглядеть так: ``` pyinstaller --noconfirm --onefile --noconsole \ --name 'MPF Converting Tool' --icon './favicon.ico' \ --add-data './app:app/' \ 'main.py' ``` Разберём параметры: - `--noconfirm` - Этот параметр отключает запрос подтверждения при перезаписи существующих файлов сборки. PyInstaller без дополнительных вопросов заменит ранее созданные файлы. - `--onefile` - Объединяет все зависимости и саму программу в один исполняемый файл. Это удобно для распространения, так как итоговый файл не требует дополнительных папок или библиотек рядом. - `--noconsole` - Убирает отображение консольного окна при запуске программы. Полезно для графических приложений, где консоль не нужна. - `--name 'MPF Converting Tool'` - Задаёт имя для создаваемого исполняемого файла. В данном случае выходной файл будет называться `MPF Converting Tool.exe` (на Windows) или просто `MPF Converting Tool` (на Linux/MacOS). - `--icon './favicon.ico'` - Указывает путь к файлу иконки, которая будет использоваться для созданного исполняемого файла. Здесь используется `favicon.ico`. - `--add-data './app:app/'` - Добавляет дополнительные данные в сборку. В данном случае папка `./app` добавляется и будет доступна в приложении как `app/`. Формат записи: `source:destination`. - `'main.py'` - Основной файл программы, который PyInstaller должен обработать и собрать в исполняемый файл. #### Результат выполнения Выполнив команду начнётся процесс сборки. Если всё прошло успешно, вы увидите в терминале запись "27927 INFO: Building EXE from EXE-00.toc completed successfully.". В директории из которой был вызван PyInstaller появится две директории: `build` и `dist`. ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142053005.png) В директории `build` содержатся временные файлы, необходимые для сборки, а в директории `dist` итоговый исполняемый файл. Откроем директорию `dist` в файловом менеджере. Там находится исполняемый файл. ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142153175.png) Запустим его, чтобы удостовериться, что всё работает: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142232500.png) Я получил ошибку, что не может найти необходимые файлы. Это нормально, просто положим их рядом: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142320092.png) И запустим снова: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119142346840.png) Слетели размеры окна приложения, но это, скорее всего связанно с запуском на Linux. В остальном программа запустилась и работает корректно. ### Итог по использованию Python Minifier + PyInstaller Процесс достаточно прост и не вызывает трудностей. Python Minifier неплохо справляется со своей задачей - усложнить чтение кода. Отмечу ещё раз, что это не панацея и есть более продвинутые инструменты, например, тот же PyArmor, который ещё и шифрует файлы, но он куда более сложен в применении и в разрезе задач для фриланса, это кажется излишним. Что касается PyInstaller, то это живая классика. Обратите внимание на размер итогового файла: почти 40 мегабайт! И это всего три `.py-файла` + несколько библиотек. Всё дело в том, что внутри файла также находится и интерпретатор Python. ## Компилируем проект в Nuitka Теперь давайте разберёмся, как можно скомпилировать проект с помощью Nuitka и чем этот процесс отличается от использования PyInstaller и обфускации с Python Minifier. ### Основные особенности Nuitka: - Высокая производительность, так как код компилируется в машинный код или промежуточный байт-код. - Поддержка большинства функций языка Python и некоторых дополнений. - Возможность создания независимых исполняемых файлов. ### Процесс работы Nuitka: 1. Анализ исходного кода Python для определения всех зависимостей и возможных оптимизаций. 2. Компиляция исходного кода в промежуточный байт-код или машинный код. 3. Создание исполняемого файла, который может быть запущен без необходимости наличия Python. ### Как Nuitka отличается от PyInstaller? \| Характеристика \| PyInstaller \| Nuitka \| \|---\|---\|---\| \| Тип упаковки \| Собирает Python-скрипт с интерпретатором и модулями \| Компилирует Python-код в бинарный файл через C \| \| Размер файла \| Обычно больше, так как включает интерпретатор \| Меньше, поскольку компилирует код \| \| Производительность \| Производительность такая же, как у исходного кода \| Выше за счёт оптимизации и машинного кода \| \| Совместимость \| Поддерживает большинство библиотек Python \| Может возникнуть сложность с модулями C API \| \| Цель \| Быстрая упаковка для распространения \| Улучшение производительности и компиляция \| Как видно из таблицы, `Nuitka` имеет много преимуществ перед `PyInstaller`, в том числе повышение скорости работы и уменьшение размера исполняемого файла. ### Нужно ли использовать Python Minifier перед Nuitka? В отличие от сценария с `PyInstaller`, дополнительная минификация или обфускация кода перед использованием `Nuitka` обычно не требуется. Сам процесс компиляции уже затрудняет восстановление читаемого кода. Если же вы хотите усилить защиту, `Nuitka` предлагает платные и бесплатные версии: - Бесплатная версия включает базовый функционал компиляции Python-кода в машинный, обеспечивая защиту от простого чтения исходного кода. - Платная версия (Commercial Edition) добавляет расширенные возможности, такие как встроенная обфускация, шифрование строковых литералов и дополнительная оптимизация для повышения безопасности. Если вам нужны улучшенные средства защиты, имеет смысл рассмотреть использование коммерческой версии, которая интегрирует функции обфускации прямо в процесс компиляции. ### Установка Nuitka Для установки необходимо выполнить команду: ``` pip install -U nuitka ``` Для работы, Nuitka требует наличие в системе C-компилятора. - Для Windows: - [Visual Studio 2022](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx) или выше. Не путать с VisualStudio Code / VSCode\! Используйте Английский язык в Visual Studio, чтобы Nuitka корректнее фильтровала вывод компилятора. - Компилятор `MinGW64`. Используется с параметром `--mingw64`. `Nuitka` предложит скачать его, если не найдёт Visual Studio. - Некоторые другие компиляторы, предоставляемые пакетами Visual Studio и MinGW64. - Для Lunux: используется `GCC-компилятор` или установленный `clang`. - Для macOS: используется системный Clang. Чтобы получить к нему доступ, установите `XCode` из `Apple Store`. ### Запуск сборки Для запуска выполним следующую команду: ``` nuitka --standalone --onefile --output-filename="MPF Converting Tool" \ --windows-disable-console --windows-icon-from-ico=./favicon.ico \ main.py ``` Разберём параметры: 1. `--standalone` - Собирает приложение с зависимостями, создавая автономный исполняемый файл. 2. `--onefile` - Упаковывает всё в один файл. 3. `--output-filename="MPF Converting Tool"` - Указывает имя выходного файла. (Для Windows в конец необходимо добавить `.exe`!) 4. `--windows-disable-console` - Отключает консольное окно для графических приложений. 5. `--windows-icon-from-ico=./favicon.ico` - Добавляет иконку для исполняемого файла. 6. `main.py` - указывает точку входа в проект. ### Результат выполнения Процесс компиляции может быть неторопливым и занять какое-то время. В процессе будет создано три директории: `main.build`, `main.dist` и `main.onefile-build`, содержащие временные файлы. По окончании в корне проекта появится нужный нам исполняемый файл: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119160648051.png) Точно также запустим, чтобы убедиться в работоспособности: ![](https://pressanybutton.ru/media/post/2024/11/19/image-20241119160735127.png) ### Итог по использованию Nuitka При беглом знакомстве, `Nuitka` кажется отличным инструментом для создания исполняемых файлов, включаем в себя компиляцию и усложнение "разбора" файла на исходный код. По результату, мы получили файл размером 31 мегабайт, что меньше результата `PyInstaller` на 10 мегабайт, но не кажется выдающимся успехом. Вероятно, зависит от проекта. ## Заключение Было интересно в процессе написания поста пробовать разное и разбираться, как всё это работает. ### Что лучше — PyInstaller или Nuitka? - Если ваша основная цель — быстро собрать исполняемый файл для передачи заказчику, PyInstaller подойдёт лучше: он проще в использовании и не требует дополнительных инструментов. - Если вы хотите повысить производительность и затруднить разбор программы, выбирайте Nuitka. Всё описанное выше, не призыв к действию, а лишь описание способов защиты своего труда. Способов на самом деле куда больше и каждый следующий сложнее и комплектнее предыдущего. Выбор какой именно применять, остаётся за вами. Если вам интересны подобные материалы, подписывайтесь на Telegram-канал [«Код на салфетке»](https://t.me/+gCWO9K8Dd642NTYy). Там я делюсь гайдами для новичков, полезными инструментами и практическими примерами из реальных проектов.
Shard	75 (laksa)
Root Hash	3052112393321575475
Unparsed URL	ru,pressanybutton!/post/poleznye-instrumenty/python-proektav-exe-fajl-i-obfuskaciya-koda/ s443