Документация Технические подробности Сборка VeraCrypt из исходного кода Руководство по сборке в Windows

В этом руководстве описано, как настроить систему Windows для компилирования VeraCrypt и как cкомпилировать программу.
Здесь как пример приведена процедура для Windows 10, процедуры для других версий Windows аналогичны.
Для компиляции VeraCrypt необходимы следующие компоненты:

1. Microsoft Visual Studio 2010
2. Microsoft Visual Studio 2010 Service Pack 1
3. NASM
4. YASM
5. Visual C++ 1.52
6. Windows SDK 7.1
7. Windows Driver Kit 7.1
8. Windows 8.1 SDK
9. gzip
10. UPX
11. 7-Zip
12. WiX3
13. Microsoft Visual Studio 2019
14. Windows 10 SDK
15. Windows Driver Kit 1903
16. Средства сборки Visual Studio

Ниже приведены шаги процедуры. Нажав на любую ссылку, вы сразу перейдёте к соответствующему шагу:

- Установка Microsoft Visual Studio 2010
- Установка Microsoft Visual Studio 2010 Service Pack 1
- Установка NASM
- Установка YASM
- Установка Microsoft Visual C++ 1.52
- Установка Windows SDK 7.1
- Установка Windows Driver Kit 7.1
- Установка Windows 8.1 SDK
- Установка gzip
- Установка UPX
- Установка 7-Zip
- Установка WiX3
- Установка Microsoft Visual Studio 2019
- Установка Windows Driver Kit 2004
- Установка средств сборки Visual Studio
- Загрузка исходных файлов VeraCrypt
- Компиляция Win32/x64-версий VeraCrypt
- Компиляция ARM64-версии VeraCrypt
- Сборка исполняемых файлов VeraCrypt
- Импорт сертификатов
- Известные проблемы

Установка Microsoft Visual Studio 2010

1. Посетите следующий сайт Microsoft и войдите в систему с помощью бесплатной учётной записи Microsoft:
   https://my.visualstudio.com/Downloads?q=Visual%20Studio%202010%20Professional&pgroup=
2. Загрузите (пробную) версию "Visual Studio Professional 2010".
3. Смонтируйте загруженный файл ISO, дважды щёлкнув по нему.
4. Запустите файл "autorun.exe" от имени администратора.
5. Установите Microsoft Visual Studio 2010 с настройками по умолчанию.

Установка Microsoft SQL Server 2008 Express Service Pack 1 (x64) может завершиться ошибкой, но это не требуется для компиляции VeraCrypt.
Установка Microsoft Visual Studio 2010 Service Pack 1

ПРИМЕЧАНИЕ: Содержимое, которое пытается загрузить официальный установщик Microsoft, больше недоступно. Поэтому необходимо использовать автономный установщик.

1. Посетите сайт интернет-архива и загрузите ISO-образ Microsoft Visual Studio 2010 Service Pack 1:
   https://archive.org/details/vs-2010-sp-1dvd-1
2. Смонтируйте загруженный файл ISO, дважды щёлкнув по нему.
3. Запустите файл "Setup.exe" от имени администратора.
4. Установите Microsoft Visual Studio 2010 Service Pack 1 с настройками по умолчанию.

Установка NASM

1. Загрузите файл "nasm-2.08-installer.exe" отсюда:
   https://www.nasm.us/pub/nasm/releasebuilds/2.08/win32/
2. Запустите файл от имени администратора.
3. Установите NASM с настройками по умолчанию.
4. Добавьте путь к папке NASM в системную переменную PATH. Это сделает команду доступной отовсюду при вызове из командной строки.
   1. Откройте Проводник.
   2. В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
   3. В правой части окна щёлкните по "Дополнительные параметры системы".
   4. Нажмите кнопку "Переменные среды".
   5. В поле "Системные переменные" выберите переменную "Path" и нажмите кнопку "Изменить...".
   6. Нажмите кнопку "Создать" и добавьте следующее значение:

      C:\Program Files (x86)\nasm

   7. Закройте окна, нажимая кнопки OK.
5. Чтобы проверить, правильно ли работает конфигурация, откройте командную строку и посмотрите вывод следующей команды:

   nasm

Установка YASM

1. Создайте следующую папку:
   C:\Program Files\YASM
2. Загрузите файл "Win64 VS2010 .zip" отсюда:
   https://yasm.tortall.net/Download.html
3. Ваш интернет-браузер может сообщить, что, возможно, файл представляет угрозу безопасности, так как редко скачивается или из-за незашифрованного соединения. Тем не менее официальный сайт – наиболее надёжный источник этого файла, поэтому мы рекомендуем разрешить загрузку.
4. Распакуйте загруженный zip-архив и скопируйте извлечённые файлы в папку "C:\Program Files\YASM".
5. Загрузите файл "Win64 .exe" отсюда:
   https://yasm.tortall.net/Download.html
6. Ваш интернет-браузер может сообщить, что, возможно, файл представляет угрозу безопасности, так как редко скачивается или из-за незашифрованного соединения. Тем не менее официальный сайт – наиболее надёжный источник этого файла, поэтому мы рекомендуем разрешить загрузку.
7. Переименуйте файл в "yasm.exe" и скопируйте его в папку "C:\Program Files\YASM".
8. Добавьте путь к папке YASM в переменную PATH и создайте новую системную переменную для YASM. Это сделает команду доступной отовсюду при вызове из командной строки.
   1. Откройте Проводник.
   2. В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
   3. В правой части окна щёлкните по "Дополнительные параметры системы".
   4. Нажмите кнопку "Переменные среды".
   5. В поле "Системные переменные" выберите переменную "Path" и нажмите кнопку "Изменить...".
   6. Нажмите кнопку "Создать" и добавьте следующее значение:

      C:\Program Files\YASM

   7. Закройте верхнее окно, нажав OK.
   8. В поле "Системные переменные" нажмите кнопку "Создать...".
   9. Заполните форму следующими значениями:

      Имя переменной: YASMPATH
      Значение переменной: C:\Program Files\YASM

   10. Закройте окна, нажимая кнопки OK.
9. Чтобы проверить, правильно ли работает конфигурация, откройте командную строку и посмотрите вывод следующей команды:

   yasm

   и

   vsyasm

Установка Microsoft Visual C++ 1.52

1. Пакет Visual C++ 1.52 доступен по платной подписке Microsoft MSDN. Если у вас нет подписки, загрузите образ ISO через интернет-архив:
   https://archive.org/details/ms-vc152
2. Создайте папку "C:\MSVC15".
3. Смонтируйте файл ISO и скопируйте содержимое папки "MSVC" в "C:\MSVC15".
4. Создайте системную переменную для Microsoft Visual C++ 1.52.
   1. Откройте Проводник.
   2. В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
   3. В правой части окна щёлкните по "Дополнительные параметры системы".
   4. Нажмите кнопку "Переменные среды".
   5. В поле "Системные переменные" нажмите кнопку "Создать...".
   6. Заполните форму следующими значениями:

      Имя переменной: MSVC16_ROOT
      Значение переменной: C:\MSVC15

   7. Закройте окна, нажимая кнопки OK.

Установка Windows SDK 7.1

Для установки требуется платформа .NET Framework 4 (более новая, например .NET Framework 4.8, не годится!). Поскольку вместе с Windows 10 уже предустановлена более новая версия, установщик придётся обмануть:

1. Нажмите кнопку Пуск и найдите "regedit.exe". Запустите первое найденное.
2. Перейдите в ветвь "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\".
3. Измените разрешения у папки "Client", чтобы можно было редактировать ключи:
   1. Щёлкните правой кнопкой мыши по подпапке "Client" и выберите "Разрешения...".
   2. Нажмите кнопку "Дополнительно".
   3. Измените владельца на своего пользователя и нажмите "Добавить".
   4. Укажите субъектом своего пользователя, включите опцию "Полный доступ" и нажмите OK.
   5. В папке "Client" запишите значение элемента "Version".
   6. Дважды щёлкните мышью по элементу "Version" и измените значение на "4.0.30319".
4. Измените разрешения у папки "Full", чтобы можно было редактировать ключи:
   1. Щёлкните правой кнопкой мыши по подпапке "Full" и выберите "Разрешения...".
   2. Нажмите кнопку "Дополнительно".
   3. Измените владельца на своего пользователя и нажмите "Добавить".
   4. Укажите субъектом своего пользователя, включите опцию "Полный доступ" и нажмите OK.
   5. В папке "Full" запишите значение элемента "Version".
   6. Дважды щёлкните мышью по элементу "Version" и измените значение на "4.0.30319".
5. Загрузите Windows SDK 7.1 отсюда:
   https://www.microsoft.com/en-us/download/details.aspx?id=8279
6. Запустите загруженный файл от имени администратора и установите приложение с настройками по умолчанию.
7. После установки отмените изменения, сделанные в редакторе реестра.
   ПРИМЕЧАНИЕ: Владельца "TrustedInstaller" можно восстановить, выполнив поиск: "NT Service\TrustedInstaller".

Установка Windows Driver Kit 7.1

1. Загрузите ISO-файл Windows Diver Kit 7.1 отсюда:
   https://www.microsoft.com/en-us/download/details.aspx?id=11800
2. Смонтируйте загруженный файл ISO, дважды щёлкнув по нему.
3. Запустите файл "KitSetup.exe" от имени администратора. Выберите для установки все компоненты.
   ПРИМЕЧАНИЕ: Возможно, во время установки вас попросят установить .NET Framework 3.5. В этом случае нажмите "Загрузить и установить".
4. Установите комплект драйверов в папку по умолчанию.

Установка Windows 8.1 SDK

1. Загрузите ISO-файл Windows 8.1 SDK отсюда:
   https://developer.microsoft.com/de-de/windows/downloads/sdk-archive/
2. Запустите загруженный файл от имени администратора и установите Windows 8.1 SDK с настройками по умолчанию.
3. Создайте системную переменную для Windows 8.1 SDK.
   1. Откройте Проводник.
   2. В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
   3. В правой части окна щёлкните по "Дополнительные параметры системы".
   4. Нажмите кнопку "Переменные среды".
   5. В поле "Системные переменные" нажмите кнопку "Создать...".
   6. Заполните форму следующими значениями:

      Имя переменной: WSDK81
      Значение переменной: C:\Program Files (x86)\Windows Kits\8.1\

   7. Закройте окна, нажимая кнопки OK.

Установка gzip

1. Создайте следующую папку:
   C:\Program Files (x86)\gzip
2. Загрузите версию gzip отсюда:
   https://sourceforge.net/projects/gnuwin32/files/gzip/1.3.12-1/gzip-1.3.12-1-bin.zip/download?use-mirror=netix&download=
3. Скопируйте содержимое загруженного zip-архива в папку "C:\Program Files (x86)\gzip".
4. Добавьте путь к папке с gzip в переменную PATH. Это сделает команду доступной отовсюду при вызове из командной строки.
   1. Откройте Проводник.
   2. В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
   3. В правой части окна щёлкните по "Дополнительные параметры системы".
   4. Нажмите кнопку "Переменные среды".
   5. В поле "Системные переменные" выберите переменную "Path" и нажмите кнопку "Изменить...".
   6. Нажмите кнопку "Создать" и добавьте следующее значение:

      C:\Program Files (x86)\gzip\bin

   7. Закройте окна, нажимая кнопки OK.
5. Чтобы проверить, правильно ли работает конфигурация, откройте командную строку и посмотрите вывод следующей команды:

   gzip

Установка UPX

1. Создайте следующую папку:
   C:\Program Files (x86)\upx
2. Загрузите новейшую версию файла upx-X.X.X-win64.zip отсюда:
   https://github.com/upx/upx/releases/tag/v4.0.2
3. Скопируйте содержимое загруженного zip-архива в папку "C:\Program Files (x86)\upx".
4. Добавьте путь к папке с gzip в системную переменную PATH. Это сделает команду доступной отовсюду при вызове из командной строки.
   1. Откройте Проводник.
   2. В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
   3. В правой части окна щёлкните по "Дополнительные параметры системы".
   4. Нажмите кнопку "Переменные среды".
   5. В поле "Системные переменные" выберите переменную "Path" и нажмите кнопку "Изменить...".
   6. Нажмите кнопку "Создать" и добавьте следующее значение:

      C:\Program Files (x86)\upx

   7. Закройте окна, нажимая кнопки OK.
5. Чтобы проверить, правильно ли работает конфигурация, откройте командную строку и посмотрите вывод следующей команды:

   upx

Установка 7-Zip

1. Загрузите новейшую версию 7-Zip отсюда:
   https://www.7-zip.org/
2. Запустите загруженный файл от имени администратора и установите 7-Zip с настройками по умолчанию.

Установка WiX3

1. Загрузите файл "wix311.exe" отсюда:
   https://github.com/wixtoolset/wix3/releases
2. Запустите загруженный файл от имени администратора и установите WiX с настройками по умолчанию.

Установка Microsoft Visual Studio 2019

1. Посетите следующий сайт Microsoft и войдите в систему с помощью бесплатной учётной записи Microsoft:
   https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20Professional
2. Загрузите новейшую (пробную) версию "Visual Studio Professional 2019".
3. Запустите загруженный файл от имени администратора и следуйте указаниям мастера.
   Выберите следующие Workloads для установки:
   1. Desktop development with C++
   2. .NET desktop development
   Выберите следующие отдельные компоненты для установки:
   1. .NET
      1. .NET 6.0 Runtime
      2. .NET Core 3.1 Runtime (LTS)
      3. .NET Framework 4 targeting pack
      4. .NET Framework 4.5 targeting pack
      5. .NET Framework 4.5.1 targeting pack
      6. .NET Framework 4.5.2 targeting pack
      7. .NET Framework 4.6 targeting pack
      8. .NET Framework 4.6.1 targeting pack
      9. .NET Framework 4.7.2 targeting pack
      10. .NET Framework 4.8 SDK
      11. .NET Framework 4.8 targeting pack
      12. .NET SDK
      13. ML.NET Model Builder (Preview)
   2. Облако, база данных и сервер
      1. CLR data types for SQL Server
      2. Connectivity and publishing tools
   3. Инструменты кода
      1. NuGet package manager
      2. Text Template Transformation
   4. Компиляторы, инструменты сборки и среды выполнения
      1. .NET Compiler Platform SDK
      2. C# and Visual Basic Roslyn compilers
      3. C++ 2019 Redistributable Update
      4. C++ CMake tools for Windows
      5. C++/CLI support for v142 build tools (Latest)
      6. MSBuild
      7. MSVC v142 - VS 2019 C++ ARM64 build tools (Latest)
      8. MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest)
      9. MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest)
      10. MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest)
   5. Отладка и тестирование
      1. .NET profiling tools
      2. C++ AddressSanatizer
      3. C++ profiling tools
      4. Just-In-Time debugger
      5. Test Adapter for Boost.Test
      6. Test Adapter for Google Test
   6. Средства разработки
      1. C# and Visual Basic
      2. C++ core features
      3. F# language support
      4. IntelliCode
      5. JavaScript and TypeScript language support
      6. Live Share
   7. Эмуляторы
      НЕТ
   8. Игры и графика
      1. Graphics debugger and GPU profiler for DirectX
   9. SDK, библиотеки и фреймворки
      1. C++ ATL for latest v142 build tools (ARM64)
      2. C++ ATL for latest v142 build tools (x86 & x64)
      3. C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64)
      4. C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64)
      5. C++ MFC for latest v142 build tools (ARM64)
      6. C++ MFC for latest v142 build tools (x86 & x64)
      7. C++ MFC for latest v142 build tools with Spectre Mitigations (ARM64)
      8. C++ MFC for latest v142 build tools with Spectre Mitigations (x86 & x64)
      9. Entity Framework 6 tools
      10. TypeScript 4.3 SDK
      11. Windows 10 SDK (10.0.19041.0)
      12. Windows Universal C Runtime

Установка Windows Driver Kit 2004

1. Загрузите Windows Driver Kit (WDK) 2004 отсюда:
   https://docs.microsoft.com/en-us/windows-hardware/drivers/other-wdk-downloads
2. Запустите загруженный файл от имени администратора и установите WDK с настройками по умолчанию.
3. В конце установки вас спросят, нужно ли установить расширение Windows Driver Kit Visual Studio.
   Перед закрытием диалогового окна убедитесь, что эта опция включена.
4. Автоматически запустится другая установка и определит пакет Visual Studio Professional 2019 как цель для расширения.
   Выберите его и продолжите установку.

Установка средств сборки Visual Studio

1. Посетите следующий сайт Microsoft и войдите в систему с помощью бесплатной учётной записи Microsoft:
   https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20build%20tools
2. Загрузите новейшую версию "Build Tools for Visual Studio 2019".
3. Запустите загруженный файл от имени администратора и следуйте указаниям мастера. Выберите для установки следующие отдельные компоненты:
   1. .NET
      НЕТ
   2. Облако, база данных и сервер
      НЕТ
   3. Инструменты кода
      НЕТ
   4. Компиляторы, инструменты сборки и среды выполнения
      1. C++/CLI support for v142 build tools (Latest)
      2. MSVC v142 - VS 2019 C++ ARM64 build tools (Latest)
      3. MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest)
      4. MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest)
      5. MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest)
   5. Отладка и тестирование
      НЕТ
   6. Средства разработки
      НЕТ
   7. SDK, библиотеки и фреймворки
      1. C++ ATL for latest v142 build tools (ARM64)
      2. C++ ATL for latest v142 build tools (x86 & x64)
      3. C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64)
      4. C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64)

Загрузка исходных файлов VeraCrypt

1. Посетите репозитарий VeraCrypt на Github:
   https://github.com/veracrypt/VeraCrypt
2. Нажмите зелёную кнопку с надписью "Code" и скачайте код.
   Загрузить репозиторий можно в виде zip-архива, но вы, возможно, предпочтёте использовать протокол git для отслеживания изменений.

Компиляция Win32/x64-версий VeraCrypt

1. Откройте файл "src/VeraCrypt.sln" в Visual Studio 2010.
2. Выберите "All|Win32" как активную конфигурацию.
3. Нажмите "Build -> Build Solution".
4. Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Некоторые проекты следует пропустить.
5. Выберите "All|x64" как активную конфигурацию.
6. Нажмите "Build -> Build Solution".
7. Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Некоторые проекты следует пропустить.
   Закройте Visual Studio 2010 после завершения процесса компиляции.

Компиляция ARM64-версии VeraCrypt

1. Откройте файл "src/VeraCrypt_vs2019.sln" в Visual Studio 2019.
2. Выберите "All|ARM64" как активную конфигурацию.
3. Нажмите "Build -> Build Solution".
4. Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Один проект следует пропустить.
   Закройте Visual Studio 2019 после завершения процесса компиляции.

Сборка исполняемых файлов VeraCrypt

1. Откройте командную строку от имени администратора.
2. Перейдите в папку "src/Signing/".
3. Запустите скрипт "sign_test.bat".
4. Сгенерированные исполняемые файлы будут в папке "src/Release/Setup Files".

Импорт сертификатов

С помощью скрипта sign_test.bat вы только что подписали исполняемые файлы VeraCrypt. Это необходимо, поскольку Windows принимает только те драйверы, которым доверяет подписанный центр сертификации.
Поскольку вы использовали не официальный сертификат подписи VeraCrypt для подписи своего кода, а общедоступную версию для разработки, вы должны импортировать и, следовательно, доверять используемым сертификатам.

1. Откройте папку "src/Signing".
2. Импортируйте следующие сертификаты в хранилище сертификатов локального компьютера, дважды щёлкнув по ним:
   - GlobalSign_R3Cross.cer
   - GlobalSign_SHA256_EV_CodeSigning_CA.cer
   - TestCertificates/idrix_codeSign.pfx
   - TestCertificates/idrix_Sha256CodeSign.pfx
   - TestCertificates/idrix_SHA256TestRootCA.crt
   - TestCertificates/idrix_TestRootCA.crt

Известные проблемы

- Этот дистрибутив повреждён.
  В Windows 10 или более новой версии возможно появление указанного выше сообщения об ошибке. Чтобы этого избежать, необходимо сделать следующее:
  - Перепроверьте установку корневого сертификата, выдавшего сертификат подписи тестового кода, в хранилище доверенных корневых центров сертификации локальной машины ("Local Machine Trusted Root Certification Authorities").
  - Вычислите отпечаток SHA512 сертификата подписи тестового кода и соответствующим образом обновите массив gpbSha512CodeSignCertFingerprint в файле "src/Common/Dlgcode.c".
  См. подробности тут: https://sourceforge.net/p/veracrypt/discussion/technical/thread/83d5a2d6e8/#db12.
  Другой подход – отключить проверку подписи в коде VeraCrypt. Это следует делать только в целях тестирования, но не для нормального использования:
  1. Откройте файл "src/Common/Dlgcode.c".
  2. Найдите функцию "VerifyModuleSignature".
  3. Замените следующие строки:
     Найти:

     if (!IsOSAtLeast (WIN_10))
     return TRUE;

     Заменить на:

     return TRUE;

  4. Снова скомпилируйте код VeraCrypt.
- Ошибка сертификата.
  Windows проверяет подпись каждого устанавливаемого драйвера.
  Из соображений безопасности Windows позволяет загружать только драйверы, подписанные Microsoft.
  Поэтому при использовании пользовательской сборки:
  - Если вы не изменяли исходный код драйвера VeraCrypt, то можете использовать подписанные Microsoft драйверы, включённые в исходный код VeraCrypt (в "src\Release\Setup Files").
  - Если вы внесли изменения, то нужно будет загрузить Windows в "тестовом режиме" ("Test Mode"). Этот режим позволяет Windows загружать драйверы, не подписанные Microsoft. Однако даже в "тестовом режиме" существуют определённые требования к подписям, и сбои всё равно могут возникать по описанным ниже причинам.
  Возможные причины сбоя установки в "тестовом режиме" ("Test Mode"):
  1. Используемый для подписи сертификат не является доверенным для Windows.
     Чтобы проверить, относится ли это к вам, проверьте свойства исполняемого файла:
     1. Щёлкните правой кнопкой мыши по исполняемому файлу VeraCrypt Setup: "src/Release/Setup Files/VeraCrypt Setup 1.XX.exe".
     2. Выберите Свойства.
     3. Сверху выберите вкладку "Цифровые подписи". Здесь вы увидите две подписи.
     Проверьте обе, дважды щёлкая по ним. Если в заголовке написано "Подпись сертификата не может быть проверена", то соответствующий сертификат подписи не был правильно импортирован.
     Нажмите кнопку "Просмотр сертификата", а затем "Установить сертификат...", чтобы импортировать сертификат в хранилище сертификатов.
  2. Драйвер был изменён после подписания.
     В этом случае воспользуйтесь скриптом "src/Signing/sign_test.bat", чтобы снова подписать ваш код тестовыми сертификатами.