Установка пакета SDK для .NET или среды выполнения .NET в Debian

В этой статье описано, как установить .NET в Debian. Если поддержка какой-либо версии Debian прекращается, то .NET также перестает поддерживать ее. Но с помощью этих инструкций вы сможете запустить .NET даже в неподдерживаемых версиях.

Если вы хотите разрабатывать приложения .NET, установите пакет SDK (включает среду выполнения). Если нужно просто запустить приложения, установите среду выполнения. Если вы устанавливаете среду выполнения, мы рекомендуем установить среду выполнения ASP.NET Core, так как она включает в себя среды выполнения .NET и ASP.NET Core.

dotnet --list-sdks Используйте команды, dotnet --list-runtimes чтобы узнать, какие версии установлены. Дополнительные сведения см. в статье Проверка того, установлена ли платформа .NET.

Внимание

Использование диспетчера пакетов для установки .NET из веб-канала пакетов Майкрософт поддерживает только архитектуру x64 . Другие архитектуры, такие как Arm, не поддерживаются веб-каналом пакетов Майкрософт.

Дополнительные сведения об установке .NET без использования диспетчера пакетов см. в одной из следующих статей:

Поддерживаемые дистрибутивы

В приведенной ниже таблице содержится список поддерживаемых сейчас выпусков .NET и версий Debian, в которых они поддерживаются. Эти версии поддерживаются до того же времени, что и версия .NET или Debian.

Debian .NET
12 8, 7, 6
11 8, 7, 6
10 7, 6

Следующие версии .NET больше не поддерживаются (❌).

  • .NET 5
  • .NET Core 3.1.
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0;

Установка предварительных версий

Предварительные версии и выпуски версии .NET недоступны в репозиториях пакетов. Предварительные версии и кандидаты .NET можно установить одним из следующих способов:

Удалите предварительные версии

При использовании диспетчера пакетов для управления установкой .NET вы можете столкнуться с конфликтом, если ранее вы установили предварительную версию. Диспетчер пакетов может интерпретировать выпуск, не являющийся предварительной версией, в качестве более ранней версии .NET. Чтобы установить выпуск, не относящийся к предварительной версии, сначала удалите предварительные версии. Дополнительные сведения об удалении .NET см. в разделе Удаление среды выполнения .NET и пакета SDK.

Debian 12

Для установки версии с помощью APT потребуется выполнить несколько команд. Перед установкой .NET выполните приведенные ниже команды, чтобы добавить ключ подписывания пакета Майкрософт в список доверенных ключей и добавить репозиторий пакетов.

Откройте терминал и выполните следующие команды:

wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Установка пакета SDK

Пакет SDK для .NET позволяет разрабатывать приложения с помощью .NET. При установке пакета SDK для .NET не нужно устанавливать соответствующую среду выполнения. Чтобы установить пакет SDK для .NET, выполните приведенные ниже команды.

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-8.0

Внимание

Если вы получаете сообщение об ошибке, аналогичное не удается найти пакет dotnet-sdk-8.0, см . раздел устранения неполадок .

Установка среды выполнения

Среда выполнения ASP.NET Core позволяет запускать приложения, созданные с помощью версии .NET без поддержки среды выполнения. Приведенные ниже команды позволяют установить среду выполнения ASP.NET Core, которая больше всего совместима с .NET. В терминале выполните приведенные ниже команды.

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-8.0

Внимание

Если вы получаете сообщение об ошибке, аналогичное не удается найти пакет aspnetcore-runtime-8.0, см . раздел устранения неполадок .

В качестве альтернативы среде выполнения ASP.NET Core вы можете установить среду выполнения .NET без поддержки ASP.NET Core. Для этого в приведенной выше команде замените aspnetcore-runtime-8.0 на dotnet-runtime-8.0.

sudo apt-get install -y dotnet-runtime-8.0

Debian 11

Для установки версии с помощью APT потребуется выполнить несколько команд. Перед установкой .NET выполните приведенные ниже команды, чтобы добавить ключ подписывания пакета Майкрософт в список доверенных ключей и добавить репозиторий пакетов.

Откройте терминал и выполните следующие команды:

wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Установка пакета SDK

Пакет SDK для .NET позволяет разрабатывать приложения с помощью .NET. При установке пакета SDK для .NET не нужно устанавливать соответствующую среду выполнения. Чтобы установить пакет SDK для .NET, выполните приведенные ниже команды.

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-8.0

Внимание

Если вы получаете сообщение об ошибке, аналогичное не удается найти пакет dotnet-sdk-8.0, см . раздел устранения неполадок .

Установка среды выполнения

Среда выполнения ASP.NET Core позволяет запускать приложения, созданные с помощью версии .NET без поддержки среды выполнения. Приведенные ниже команды позволяют установить среду выполнения ASP.NET Core, которая больше всего совместима с .NET. В терминале выполните приведенные ниже команды.

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-8.0

Внимание

Если вы получаете сообщение об ошибке, аналогичное не удается найти пакет aspnetcore-runtime-8.0, см . раздел устранения неполадок .

В качестве альтернативы среде выполнения ASP.NET Core вы можете установить среду выполнения .NET без поддержки ASP.NET Core. Для этого в приведенной выше команде замените aspnetcore-runtime-8.0 на dotnet-runtime-8.0.

sudo apt-get install -y dotnet-runtime-8.0

Debian 10

Для установки версии с помощью APT потребуется выполнить несколько команд. Перед установкой .NET выполните приведенные ниже команды, чтобы добавить ключ подписывания пакета Майкрософт в список доверенных ключей и добавить репозиторий пакетов.

Откройте терминал и выполните следующие команды:

wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Установка пакета SDK

Пакет SDK для .NET позволяет разрабатывать приложения с помощью .NET. При установке пакета SDK для .NET не нужно устанавливать соответствующую среду выполнения. Чтобы установить пакет SDK для .NET, выполните приведенные ниже команды.

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-7.0

Внимание

Если вы получите сообщение об ошибке, аналогичное ошибке, аналогичной обнаружению пакета dotnet-sdk-7.0, см. раздел об устранении неполадок.

Установка среды выполнения

Среда выполнения ASP.NET Core позволяет запускать приложения, созданные с помощью версии .NET без поддержки среды выполнения. Приведенные ниже команды позволяют установить среду выполнения ASP.NET Core, которая больше всего совместима с .NET. В терминале выполните приведенные ниже команды.

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-7.0

Внимание

Если вы получите сообщение об ошибке, аналогичное ошибке, аналогичной обнаружению пакета aspnetcore-runtime-7.0, см. раздел устранения неполадок.

В качестве альтернативы среде выполнения ASP.NET Core вы можете установить среду выполнения .NET без поддержки ASP.NET Core. Для этого в приведенной выше команде замените aspnetcore-runtime-7.0 на dotnet-runtime-7.0.

sudo apt-get install -y dotnet-runtime-7.0

Установка других версий

Все версии .NET доступны для загрузки в https://dotnet.microsoft.com/download/dotnet, но для этого требуется установка вручную. Можно попробовать использовать диспетчер пакетов для установки другой версии .NET. Однако запрошенная версия может быть недоступна.

Пакеты, добавляемые в веб-каналы диспетчера пакетов, именуются в формате, уязвимом для хакерских атак, например: {product}-{type}-{version}.

  • product
    Тип устанавливаемого продукта .NET. Допустимые значения:

    • dotnet
    • aspnetcore
  • type
    Позволяет выбрать пакет SDK или среду выполнения. Допустимые значения:

    • пакет SDK (доступен только для продукта dotnet )
    • среда выполнения
  • version
    Версия пакета SDK или среды выполнения для установки. Эта статья всегда будет содержать инструкции для последней поддерживаемой версии. Допустимые параметры — любая выпущенная версия, например:

    • 8.0
    • 6,0
    • 3.1
    • 2.1

    Возможно, пакет SDK или среда выполнения, которые вы пытаетесь скачать, недоступны для вашего дистрибутива Linux. Список поддерживаемых дистрибутивов см. в статье Установка .NET в Linux.

Примеры

  • Установите среду выполнения ASP.NET Core 8.0: aspnetcore-runtime-8.0
  • Установка среды выполнения .NET Core 2.1: dotnet-runtime-2.1
  • Установка пакета SDK .NET 5: dotnet-sdk-5.0
  • Установка пакета SDK для .NET Core 3.1: dotnet-sdk-3.1

Пакет отсутствует

Если сочетание пакета и версии больше не поддерживается, оно недоступно. Например, пакет SDK для ASP.NET Core отсутствует, компоненты этого пакета SDK входят в состав пакета SDK для .NET. Значение aspnetcore-sdk-8.0 неправильное и должно быть равно dotnet-sdk-8.0 Список дистрибутивов Linux, поддерживаемых .NET, см. в статье Зависимости и требования для .NET.

Обновление .NET с помощью APT

Если для .NET доступен новый выпуск исправлений, можете выполнить обновление с помощью APT и следующих команд:

sudo apt-get update
sudo apt-get upgrade

Если вы обновили дистрибутив Linux с момента установки .NET, может потребоваться перенастроить репозиторий пакетов Майкрософт. Выполните инструкции по установке для текущей версии дистрибутива, чтобы обновить репозиторий пакетов для обновлений .NET до соответствующей версии.

Устранение неполадок

В этом разделе описаны распространенные ошибки, которые могут возникнуть при использовании APT для установки .NET.

Не удалось найти пакет

Внимание

Использование диспетчера пакетов для установки .NET из веб-канала пакетов Майкрософт поддерживает только архитектуру x64 . Другие архитектуры, такие как Arm, не поддерживаются веб-каналом пакетов Майкрософт.

Дополнительные сведения об установке .NET без использования диспетчера пакетов см. в одной из следующих статей:

Не удалось найти \ Не удалось установить некоторые пакеты

Если появляется сообщение об ошибке, похожее на Не удалось найти пакет {dotnet-package} или Не удалось установить некоторые пакеты, выполните проведенные ниже команды.

В следующем наборе команд есть два заполнителя.

  • {dotnet-package}
    Этот заполнитель представляет собой устанавливаемый пакет .NET, например aspnetcore-runtime-8.0. Это используется в следующей команде sudo apt-get install.

  • {os-version}
    Этот заполнитель представляет собой версию дистрибутива, которую вы используете. Он используется в приведенной ниже команде wget. Версия дистрибутива — это числовое значение, например 20.04 в Ubuntu или 10 в Debian.

Сначала попробуйте очистить список пакетов.

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Затем попробуйте установить .NET еще раз. Если проблема не решена, можно выполнить установку вручную с помощью приведенных ниже команд.

sudo apt-get install -y gpg
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/debian/{os-version}/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Ошибка получения

При установке пакета .NET может появиться примерно такое сообщение об ошибке: Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Эта ошибка может означать, что веб-канал пакета для .NET сейчас обновляется до новой версии пакета и следует повторить попытку позже. Во время обновления веб-канал пакета остается недоступным не более 30 минут. Если вы продолжаете получать эту ошибку через 30 минут, отправьте заявку о проблеме на адрес https://github.com/dotnet/core/issues.

Зависимости

Если для установки используется диспетчер пакетов, эти библиотеки устанавливаются автоматически. Но если вы устанавливаете .NET вручную или публикуете автономное приложение, вам потребуется установить эти библиотеки:

  • libc6
  • libgcc1 (для 10.x)
  • libgcc-s1 (для 11.x и 12.x)
  • libgssapi-krb5-2
  • libicu63 (для 10.x)
  • libicu67 (для 11.x)
  • libicu72 (для 12.x)
  • libssl1.1
  • libstdc++6
  • zlib1g

Зависимости можно установить с помощью apt install команды. В следующем фрагменте кода показано, как установить библиотеку libc6 :

sudo apt install libc6

Если приложение .NET использует сборку System.Drawing.Common , необходимо также установить libgdiplus. Так как System.Drawing.Common больше не поддерживается в Linux, это работает только в .NET 6 и требует установки System.Drawing.EnableUnixSupport параметра конфигурации среды выполнения.

Вы можете установить последнюю версию libgdiplus , добавив репозиторий Mono в систему.

Следующие шаги