다음을 통해 공유

Ubuntu에 .NET SDK 또는 .NET Runtime 설치

  • 아티클

이 문서에서는 Ubuntu에 .NET을 설치하는 방법을 설명합니다.

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

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

Important

패키지 관리자를 사용하여 Microsoft 패키지 피드에서 .NET을 설치하면 x64 아키텍처만 지원합니다. Arm과 같은 다른 아키텍처는 Microsoft 패키지 피드에서 지원되지 않습니다. Ubuntu 피드를 사용하거나 .NET을 수동으로 설치합니다. 여러 피드를 사용할 때 패키지 혼합 문제를 주의해야 합니다. 자세한 내용은 Linux의 .NET 패키지 혼합을 참조하세요.

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

Ubuntu 24.10

.NET은 Ubuntu 패키지 관리자 피드에서 사용할 수 있습니다. Microsoft 패키지 리포지토리에는 더 이상 Ubuntu용 .NET 패키지가 포함되어 있지 않습니다.

다음 버전의 .NET은 Ubuntu 24.10에서 지원되거나 사용할 수 있습니다.

  • 9.0
  • 8.0

Ubuntu 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다.

SDK 설치

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

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

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

런타임 설치

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

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

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

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

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

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

Ubuntu 24.04

.NET은 Ubuntu 패키지 관리자 피드에서 사용할 수 있습니다. Microsoft 패키지 리포지토리에는 더 이상 Ubuntu용 .NET 패키지가 포함되어 있지 않습니다.

Ubuntu 24.04에서는 다음 버전의 .NET이 지원되거나 사용 가능합니다.

지원되는 .NET 버전 사용 가능
기본 제공 Ubuntu 피드		 다음에서 사용 가능
backports
Ubuntu 피드		 다음에서 사용 가능
Microsoft 피드
9.0, 8.0 8.0 9.0, 7.0, 6.0 None

Ubuntu 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다.

.NET은 Ubuntu .NET 백포트 패키지 리포지토리에서 사용할 수 있습니다. 리포지토리를 추가하려면 터미널을 열고 다음 명령을 실행합니다.

sudo add-apt-repository ppa:dotnet/backports

SDK 설치

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

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

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

런타임 설치

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

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

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

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

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

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

Ubuntu 22.04

.NET은 Ubuntu 패키지 관리자 피드와 Microsoft 패키지 리포지토리에서 사용할 수 있습니다. 그러나 .NET을 설치하려면 둘 중 하나만 사용해야 합니다. Ubuntu 패키지 관리자 피드를 사용하는 것이 좋습니다. Microsoft 패키지 리포지토리를 사용하려면 Microsoft 패키지 리포지토리 등록 방법을 참조하세요.

Ubuntu 22.04에서는 다음 버전의 .NET이 지원되거나 사용 가능합니다.

지원되는 .NET 버전 사용 가능
기본 제공 Ubuntu 피드		 다음에서 사용 가능
.NET 백포트
Ubuntu 피드		 다음에서 사용 가능
Microsoft 피드
9.0, 8.0 8.0, 7.0, 6.0 9.0 8.0, 7.0, 6.0, 3.1

Important

.NET 8 SDK 및 Ubuntu 22.04를 사용하는 경우 Canonical에서 제공하는 SDK 버전은 항상 .1xx 기능 밴드에 있음을 이해합니다. 최신 기능 밴드 릴리스를 사용하려면 Microsoft 피드를 사용하여 SDK를 설치합니다. 리포지토리 피드 간 전환이 미치는 영향을 이해하려면 Linux의 .NET 패키지 혼합 문서의 정보를 검토합니다.

Ubuntu 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다.

.NET은 Ubuntu .NET 백포트 패키지 리포지토리에서 사용할 수 있습니다. 리포지토리를 추가하려면 터미널을 열고 다음 명령을 실행합니다.

sudo add-apt-repository ppa:dotnet/backports

SDK 설치

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

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

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

런타임 설치

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

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

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

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

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

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu70
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

Ubuntu 20.04

기본 Ubuntu 패키지 리포지토리에는 이 버전의 .NET이 포함되어 있지 않습니다. 대신 Microsoft 패키지 리포지토리를 사용합니다.

Ubuntu 20.04에서는 다음 버전의 .NET이 지원되거나 사용 가능합니다.

지원되는 .NET 버전 사용 가능
기본 제공 Ubuntu 피드		 다음에서 사용 가능
.NET 백포트
Ubuntu 피드		 다음에서 사용 가능
Microsoft 피드
8.0 None None 8.0, 7.0. 6.0, 5.0, 3.1, 2.1

Ubuntu 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다.

Microsoft 패키지 리포지토리 추가

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

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

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

Ubuntu 20.04는 2025년 4월에 수명이 종료되므로 Microsoft는 Ubuntu 20.04에서 .NET 9를 지원하지 않기로 결정했습니다.

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu66
  • libssl1.1
  • libstdc++6
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

지원되지 않는 버전

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

  • .NET 7
  • .NET 6
  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

다른 버전을 설치하는 방법

.NET 패키지 이름은 모든 Linux 배포판에서 표준화되어 있습니다. 다음 표에는 패키지가 나열되어 있습니다.

모든 버전의 .NET은 https://dotnet.microsoft.com/download/dotnet에서 다운로드할 수 있지만 수동 설치가 필요합니다. 패키지 관리자를 사용하여 다른 버전의 .NET을 설치할 수 있습니다. 그러나 요청된 버전을 사용하지 못할 수도 있습니다.

패키지 관리자 피드에 추가되는 패키지는 해킹 가능한 형식으로 명명됩니다(예: {product}-{type}-{version}).

  • product
    설치할 .NET 제품의 유형입니다. 유효한 옵션은 다음과 같습니다.

    • dotnet
    • aspnetcore

  • type
    SDK와 런타임 중 선택합니다. 유효한 옵션은 다음과 같습니다.

    • sdk(dotnet 제품에만 사용 가능)
    • runtime

  • version
    설치한 SDK 또는 런타임의 버전입니다. 유효한 옵션은 모든 릴리스된 버전입니다. 예:

    • 9.0
    • 8.0
    • 3.1
    • 2.1

    다운로드하려는 SDK/런타임을 Linux 배포판에서 사용할 수 없을 수 있습니다. 지원되는 배포판 목록은 Linux에 .NET 설치를 참조하세요.

예제

  • ASP.NET Core 9.0 런타임을 설치합니다. aspnetcore-runtime-9.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 종속성 및 요구 사항을 참조하세요.

수동 설치

Ubuntu 버전이 지원되지 않는 경우 설치 스크립트를 사용하여 이진 파일을 수동으로 추출하여 .NET을 설치해야 할 수 있습니다. 자세한 내용은 패키지 관리자를 사용하지 않고 Linux에 .NET 설치를 참조하세요.

Ubuntu 23.10

Warning

이 버전의 Ubuntu는 더 이상 지원되지 않습니다.

이 버전의 Ubuntu에서 .NET을 실행하는 것은 더 이상 지원되지 않습니다.

.NET은 Ubuntu 패키지 관리자 피드와 Microsoft 패키지 리포지토리에서 사용할 수 있습니다. 그러나 .NET을 설치하려면 둘 중 하나만 사용해야 합니다. Ubuntu 패키지 관리자 피드를 사용하는 것이 좋습니다. Microsoft 패키지 리포지토리를 사용하려면 Microsoft 패키지 리포지토리 등록 방법을 참조하세요.

Ubuntu 23.10에서 지원되거나 사용할 수 있는 .NET 버전은 다음과 같습니다.

지원되는 .NET 버전 사용 가능
기본 제공 Ubuntu 피드		 다음에서 사용 가능
.NET 백포트
Ubuntu 피드		 다음에서 사용 가능
Microsoft 피드
8.0, 6.0 8.0, 7.0, 6.0 None 8.0, 7.0, 6.0

Important

.NET 8 SDK 및 Ubuntu 22.04를 사용하는 경우 Canonical에서 제공하는 SDK 버전은 항상 .1xx 기능 밴드에 있음을 이해합니다. 최신 기능 밴드 릴리스를 사용하려면 Microsoft 피드를 사용하여 SDK를 설치합니다. 리포지토리 피드 간 전환이 미치는 영향을 이해하려면 Linux의 .NET 패키지 혼합 문서의 정보를 검토합니다.

Ubuntu 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다.

.NET 9는 Ubuntu 23.10에서 지원되지 않습니다.

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

Ubuntu 23.04

Warning

이 버전의 Ubuntu는 더 이상 지원되지 않습니다.

이 버전의 Ubuntu에서 .NET을 실행하는 것은 더 이상 지원되지 않습니다.

.NET은 Ubuntu 패키지 관리자 피드와 Microsoft 패키지 리포지토리에서 사용할 수 있습니다. 그러나 .NET을 설치하려면 둘 중 하나만 사용해야 합니다. Ubuntu 패키지 관리자 피드를 사용하는 것이 좋습니다. Microsoft 패키지 리포지토리를 사용하려면 Microsoft 패키지 리포지토리 등록 방법을 참조하세요.

Ubuntu 23.04에서 지원되거나 사용할 수 있는 .NET 버전은 다음과 같습니다.

지원되는 .NET 버전 사용 가능
기본 제공 Ubuntu 피드		 다음에서 사용 가능
.NET 백포트
Ubuntu 피드		 다음에서 사용 가능
Microsoft 피드
8.0, 6.0 7.0, 6.0 None 8.0, 7.0, 6.0

Important

.NET 8 SDK 및 Ubuntu 22.04를 사용하는 경우 Canonical에서 제공하는 SDK 버전은 항상 .1xx 기능 밴드에 있음을 이해합니다. 최신 기능 밴드 릴리스를 사용하려면 Microsoft 피드를 사용하여 SDK를 설치합니다. 리포지토리 피드 간 전환이 미치는 영향을 이해하려면 Linux의 .NET 패키지 혼합 문서의 정보를 검토합니다.

.NET 9는 Ubuntu 23.04에서 지원되지 않습니다.

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

Ubuntu 22.10

Warning

이 버전의 Ubuntu는 더 이상 지원되지 않습니다.

이 버전의 Ubuntu에서 .NET을 실행하는 것은 더 이상 지원되지 않습니다.

.NET은 Ubuntu 패키지 관리자 피드와 Microsoft 패키지 리포지토리에서 사용할 수 있습니다. 그러나 .NET을 설치하려면 둘 중 하나만 사용해야 합니다. Ubuntu 패키지 관리자 피드를 사용하는 것이 좋습니다. Microsoft 패키지 리포지토리를 사용하려면 Microsoft 패키지 리포지토리 등록 방법을 참조하세요.

Ubuntu 22.10에서는 다음 버전의 .NET이 지원되거나 사용 가능합니다.

지원되는 .NET 버전 사용 가능
기본 제공 Ubuntu 피드		 다음에서 사용 가능
.NET 백포트
Ubuntu 피드		 다음에서 사용 가능
Microsoft 피드
6.0 7.0, 6.0 None 7.0, 6.0, 3.1

Important

.NET 8 SDK 및 Ubuntu 22.04를 사용하는 경우 Canonical에서 제공하는 SDK 버전은 항상 .1xx 기능 밴드에 있음을 이해합니다. 최신 기능 밴드 릴리스를 사용하려면 Microsoft 피드를 사용하여 SDK를 설치합니다. 리포지토리 피드 간 전환이 미치는 영향을 이해하려면 Linux의 .NET 패키지 혼합 문서의 정보를 검토합니다.

.NET 9는 Ubuntu 22.10에서 지원되지 않습니다.

종속성

패키지 관리자를 설치할 때 이러한 라이브러리가 설치됩니다. 그러나 .NET을 수동으로 설치하거나 자체 포함 앱을 게시할 경우 이러한 라이브러리가 설치되어 있는지 확인해야 합니다.

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu71
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

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

sudo apt install zlib1g

.NET 앱이 System.Drawing.Common 어셈블리를 사용하는 경우 libgdiplus를 설치해야 합니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조 하세요.

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

다음 단계