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

Статья
04/02/2024

В этой статье описано, как установить .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

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

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

sudo apt-get update && \
  sudo apt-get install -y 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

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

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

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

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

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

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

Debian 10

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

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

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

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

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-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 )
- runtime
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

Примечание.

Некоторые пакеты могут быть недоступны в дистрибутиве Linux.

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

Если сочетание пакета и версии больше не поддерживается, оно недоступно. Например, нет пакета SDK для ASP.NET Core. Компоненты пакета SDK для ASP.NET Core включены в пакет 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.

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

Внимание

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

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

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

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

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

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

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

Если вы используете Debian 12 или более поздней версии, попробуйте выполнить следующие команды:

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Move the key to the appropriate place
sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])")

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Если вы используете версию Debian до 12, попробуйте выполнить следующие команды:

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Set ownership
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

# Update packages and install .NET
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 в систему.

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

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

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

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

Debian 12

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

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

Debian 11

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

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

Debian 10

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

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

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

Примеры

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

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

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

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

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

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

Зависимости

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

Обратная связь

Дополнительные ресурсы