다음을 통해 공유

Debian에 .NET SDK 또는 .NET 런타임 설치

  • 아티클

이 문서에서는 Debian에 .NET을 설치하는 방법을 설명합니다. Debian 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다. 그러나 이러한 지침은 지원되지 않더라도 해당 버전에서 .NET을 실행하는 데 도움이 될 수 있습니다.

.NET 앱을 개발하려는 경우 SDK(런타임 포함)를 설치합니다. 또는 앱을 실행하기만 하려면 런타임을 설치합니다. 런타임을 설치하려면 .NET 런타임과 ASP.NET Core 런타임이 모두 포함된 ASP.NET Core 런타임을 설치하는 것이 좋습니다.

dotnet --list-sdks 및 dotnet --list-runtimes 명령을 사용하여 설치된 버전을 확인합니다. 자세한 내용은 .NET이 이미 설치되어 있는지 확인하는 방법을 참조하세요.

Important

패키지 관리자를 사용하여 Microsoft 패키지 피드에서 .NET을 설치하면 x64 아키텍처만 지원합니다. Arm과 같은 다른 아키텍처는 Microsoft 패키지 피드에서 지원되지 않습니다.

패키지 관리자 없이 .NET을 설치하는 방법에 대한 자세한 내용은 다음 문서 중 하나를 참조하세요.

지원되는 배포

다음 표는 현재 지원되는 .NET 릴리스와 해당 릴리스가 지원되는 Debian 버전의 목록입니다. 이러한 버전은 .NET 버전이 지원 종료에 도달하거나 Debian 버전이 지원 종료에 도달할 때까지 계속 지원됩니다.

Debian .NET
12 9, 8, 6
11 8, 6

Important

.NET 9는 현재 미리 보기로 제공됩니다.

다음 .NET 버전은 ❌ 더 이상 지원되지 않습니다.

  • .NET 7
  • .NET 6(2024년 11월 12일부터)
  • .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을 설치하기 전에 다음 명령을 실행하여 신뢰 키 목록에 Microsoft 패키지 서명 키를 추가하고 패키지 리포지토리를 추가합니다.

터미널을 열고 다음 명령을 실행합니다.

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 설치

.NET SDK를 사용하면 .NET으로 앱을 개발할 수 있습니다. .NET SDK를 설치하면 해당 런타임을 설치할 필요가 없습니다. .NET SDK를 설치하려면 다음 명령을 실행합니다.

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

.NET CLI 사용 방법을 알아보려면 .NET CLI 개요를 참조하세요.

런타임 설치

ASP.NET Core 런타임을 사용하면 런타임을 제공하지 않는 .NET으로 만든 앱을 실행할 수 있습니다. 다음 명령을 실행하면 .NET에 대해 가장 호환성이 높은 ASP.NET Core 런타임이 설치됩니다. 터미널에서 다음 명령을 실행합니다.

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

ASP.NET Core 런타임 대신 ASP.NET Core 지원이 포함되지 않은 .NET 런타임을 설치할 수 있습니다. 이전 명령에서 aspnetcore-runtime-8.0을 dotnet-runtime-8.0으로 바꿉니다.

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

.NET CLI 사용 방법을 알아보려면 .NET CLI 개요를 참조하세요.

Debian 11

몇 가지 명령을 사용하여 APT 설치를 완료할 수 있습니다. .NET을 설치하기 전에 다음 명령을 실행하여 신뢰 키 목록에 Microsoft 패키지 서명 키를 추가하고 패키지 리포지토리를 추가합니다.

터미널을 열고 다음 명령을 실행합니다.

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 설치

.NET SDK를 사용하면 .NET으로 앱을 개발할 수 있습니다. .NET SDK를 설치하면 해당 런타임을 설치할 필요가 없습니다. .NET SDK를 설치하려면 다음 명령을 실행합니다.

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

.NET CLI 사용 방법을 알아보려면 .NET CLI 개요를 참조하세요.

런타임 설치

ASP.NET Core 런타임을 사용하면 런타임을 제공하지 않는 .NET으로 만든 앱을 실행할 수 있습니다. 다음 명령을 실행하면 .NET에 대해 가장 호환성이 높은 ASP.NET Core 런타임이 설치됩니다. 터미널에서 다음 명령을 실행합니다.

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

ASP.NET Core 런타임 대신 ASP.NET Core 지원이 포함되지 않은 .NET 런타임을 설치할 수 있습니다. 이전 명령에서 aspnetcore-runtime-8.0을 dotnet-runtime-8.0으로 바꿉니다.

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

.NET CLI 사용 방법을 알아보려면 .NET CLI 개요를 참조하세요.

Debian 10

몇 가지 명령을 사용하여 APT 설치를 완료할 수 있습니다. .NET을 설치하기 전에 다음 명령을 실행하여 신뢰 키 목록에 Microsoft 패키지 서명 키를 추가하고 패키지 리포지토리를 추가합니다.

터미널을 열고 다음 명령을 실행합니다.

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 설치

.NET SDK를 사용하면 .NET으로 앱을 개발할 수 있습니다. .NET SDK를 설치하면 해당 런타임을 설치할 필요가 없습니다. .NET SDK를 설치하려면 다음 명령을 실행합니다.

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

.NET CLI 사용 방법을 알아보려면 .NET CLI 개요를 참조하세요.

런타임 설치

ASP.NET Core 런타임을 사용하면 런타임을 제공하지 않는 .NET으로 만든 앱을 실행할 수 있습니다. 다음 명령을 실행하면 .NET에 대해 가장 호환성이 높은 ASP.NET Core 런타임이 설치됩니다. 터미널에서 다음 명령을 실행합니다.

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

ASP.NET Core 런타임 대신 ASP.NET Core 지원이 포함되지 않은 .NET 런타임을 설치할 수 있습니다. 이전 명령에서 aspnetcore-runtime-7.0을 dotnet-runtime-7.0으로 바꿉니다.

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

.NET CLI 사용 방법을 알아보려면 .NET CLI 개요를 참조하세요.

다른 버전을 설치하는 방법

모든 버전의 .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 배포판에서 사용할 수 없을 수 있습니다. 지원되는 배포판 목록은 Linux에 .NET 설치를 참조하세요.

예제

  • ASP.NET Core 8.0 런타임 설치: aspnetcore-runtime-8.0
  • .NET Core 2.1 런타임 설치: dotnet-runtime-2.1
  • .NET 5 SDK 설치: dotnet-sdk-5.0
  • .NET Core 3.1 SDK 설치: dotnet-sdk-3.1

참고 항목

일부 패키지는 Linux 배포판에서 사용할 수 없을 수 있습니다.

패키지가 없음

패키지-버전 조합이 작동하지 않는다면 사용할 수 없는 것입니다. 예를 들어 ASP.NET Core SDK가 없습니다. ASP.NET Core용 SDK 구성 요소는 .NET SDK에 포함됩니다. 값 aspnetcore-sdk-8.0는 올바르지 않으며, 올바른 값은 dotnet-sdk-8.0입니다. .NET에서 지원하는 Linux 배포판 목록은 .NET 종속성 및 요구 사항을 참조하세요.

APT를 사용하여 .NET 업데이트

.NET에 대한 새로운 패치 릴리스가 출시되면 다음 명령을 사용하여 APT를 통해 간단하게 업그레이드할 수 있습니다.

sudo apt-get update
sudo apt-get upgrade

.NET을 설치한 후 Linux 배포를 업그레이드한 경우 Microsoft 패키지 리포지토리를 다시 구성해야 할 수 있습니다. 현재 배포 버전의 설치 명령을 실행하여 .NET 업데이트에 적합한 패키지 리포지토리로 업그레이드합니다.

문제 해결

이 섹션에서는 APT를 사용하여 .NET을 설치할 때 발생할 수 있는 일반적인 오류에 대한 정보를 제공합니다.

패키지를 찾을 수 없음

Important

패키지 관리자를 사용하여 Microsoft 패키지 피드에서 .NET을 설치하면 x64 아키텍처만 지원합니다. Arm과 같은 다른 아키텍처는 Microsoft 패키지 피드에서 지원되지 않습니다.

패키지 관리자 없이 .NET을 설치하는 방법에 대한 자세한 내용은 다음 문서 중 하나를 참조하세요.

찾을 수 없음\일부 패키지를 설치할 수 없음

{netcore-package} 패키지를 찾을 수 없음 또는 일부 패키지를 설치할 수 없음과 같은 오류 메시지가 표시되는 경우 다음 명령을 실행합니다.

다음 명령 집합에는 두 개의 자리 표시자가 있습니다.

  • {dotnet-package}
    aspnetcore-runtime-8.0과 같이 설치 중인 .NET 패키지를 나타냅니다. 다음 sudo apt-get install 명령에 사용됩니다.

먼저, 다음 패키지 목록을 제거해 봅니다.

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

그런 다음, .NET을 다시 설치해 봅니다. 이 방법으로 문제가 해결되지 않으면 다음 명령을 사용하여 수동 설치를 실행할 수 있습니다.

Debian 12 이상을 사용하는 경우 다음 명령을 시도합니다.

# Get OS version info which adds the $ID and $VERSION_ID variables
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}

12 이전의 Debian 버전을 사용하는 경우 다음 명령을 시도합니다.

# 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을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

10.x

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu63
  • libssl1.1
  • libstdc++6
  • zlib1g

11.x

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu67
  • libssl1.1
  • libstdc++6
  • zlib1g

12.x

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • libssl3
  • libstdc++6
  • zlib1g

종속성은 apt install 명령을 사용하여 설치할 수 있습니다. 다음 코드 조각에서는 libc6 라이브러리를 설치하는 방법을 보여줍니다.

sudo apt install libc6

.NET 앱에서 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus도 설치해야 합니다. System.Drawing.Common이 더 이상 Linux에서 지원되지 않으므로 이는 .NET 6에서만 작동하며 System.Drawing.EnableUnixSupport 런타임 구성 스위치를 설정해야 합니다.

시스템에 Mono 리포지토리를 추가하여 최신 버전의 libgdiplus를 설치할 수 있습니다.

다음 단계