Ubuntu의 .NET 개요

이 문서에서는 Ubuntu에 .NET을 설치하는 방법을 설명합니다. Ubuntu 22.04부터는 지원되는 대부분의 .NET 버전을 기본 제공 Ubuntu 피드에서 사용할 수 있습니다. Ubuntu .NET 백포트 패키지 리포지토리에는 지원되는 나머지 .NET 버전이 포함되어 있습니다. 사용 가능한 버전에 관한 자세한 내용은 지원되는 배포 섹션을 참조하세요.

정식은 Ubuntu에 .NET 게시를 인수했습니다. Ubuntu 22.04부터 Microsoft는 더 이상 .NET for Ubuntu를 Microsoft 패키지 리포지토리에 배포하지 않습니다.

Ubuntu 업그레이드 시 고려 사항

Ubuntu를 22.04 이상으로 업그레이드하시겠습니까? 먼저 .NET을 제거하는 것이 좋습니다.

패키지 관리자를 사용하여 Microsoft 패키지 리포지토리에서 .NET을 설치한 경우 Ubuntu를 업그레이드한 후 패키지 혼합 문제가 발생합니다. Canonical이 Ubuntu 22.04 이상 버전의 패키지 피드에 .NET을 게시했으므로 패키지 관리자는 이전에 설치된 .NET 버전에 대해 알지 못합니다. 패키지를 최신 .NET으로 업그레이드할 수 없습니다. 먼저 제거한 다음 [Ubuntu 패키지 리포지토리]에서 다시 설치합니다.

.NET 설치 방법 결정

Ubuntu 버전이 기본 제공 또는 .NET 백포트 Ubuntu 피드를 통해 .NET을 지원하는 경우 이러한 .NET 빌드에 대한 지원은 Canonical이 제공하며 다른 워크로드에 맞게 빌드를 최적화할 수 있습니다. Microsoft는 Microsoft 패키지 리포지토리 피드의 패키지에 대한 지원을 제공합니다.

다음 섹션을 사용하여 .NET을 설치하는 방법을 결정합니다.

• Ubuntu 22.04 이상을 사용하고 있으며, .NET만 필요합니다
• Ubuntu 22.04 이전 버전을 사용하고 있습니다
• 다른 Microsoft 패키지(예: powershell, mdatp, mssql) 사용하고 있습니다
• .NET 앱을 만들려고 합니다
• 컨테이너, 클라우드 또는 연속 통합 시나리오에서 .NET 앱을 실행하려고 합니다
• 내 Ubuntu 배포판에 원하는 .NET 버전이 포함되어 있지 않거나 지원되지 않는 .NET 버전이 필요합니다
• 미리 보기 버전을 설치하려고 합니다
• APT를 사용하고 싶지 않습니다
• Arm 기반 CPU를 사용하고 있습니다
• IBM System Z 플랫폼을 사용하고 있습니다

Ubuntu 22.04 이상을 사용하고 있으며 .NET만 필요합니다

Ubuntu 피드를 통해 .NET를 설치합니다. 자세한 내용은 다음 페이지를 참조하세요.

• Ubuntu 24.10에 .NET을 설치합니다.
• Ubuntu 24.04에 .NET를 설치합니다.
• Ubuntu 22.04에 .NET를 설치합니다.

Microsoft 리포지토리를 설치하여 다른 Microsoft 패키지(예: powershell, mdatp, mssql)를 사용하려는 경우 Microsoft 리포지토리에서 제공하는 .NET 패키지의 우선순위를 해제해야 합니다. 패키지의 우선순위를 해제하는 방법에 대한 지침은 내 Linux 배포판에서 제공하는 .NET 패키지를 사용하려고 합니다를 참조하세요.

Ubuntu 22.04 이전 버전을 사용하고 있습니다

버전별 Ubuntu 페이지의 지침을 사용합니다.

• 20.04(LTS)

Ubuntu 버전에서 지원되는 .NET 버전에 관한 자세한 내용은 지원되는 배포 섹션을 검토하세요. 지원되지 않는 버전을 설치하려는 경우 Microsoft 패키지 리포지토리 등록을 참조하세요.

다른 Microsoft 패키지(예: powershell, mdatp, mssql)를 사용하고 있습니다

Ubuntu 버전이 Ubuntu 피드를 통해 .NET을 지원하는 경우 .NET을 설치할 피드를 결정해야 합니다. 지원되는 배포 섹션에서는 패키지 피드에서 사용할 수 있는 .NET 버전을 나열한 표를 제공합니다.

Ubuntu 피드에서 .NET 패키지를 소싱하려는 경우 Microsoft 리포지토리에서 제공하는 .NET 패키지의 우선순위를 낮춰야 합니다. 패키지의 우선순위를 해제하는 방법에 대한 지침은 내 Linux 배포판에서 제공하는 .NET 패키지를 사용하려고 합니다를 참조하세요.

.NET 앱을 만들려고 합니다

런타임에 사용하는 것과 동일한 패키지 소스를 SDK에 사용합니다. Ubuntu 피드를 통해 .NET을 설치하는 것이 좋습니다. 그러나 다른 원본(예: 더 높은 SDK 기능 밴드에 액세스하기 위한 Microsoft 패키지 리포지토리)에서 .NET을 설치하려면 .NET을 제거하고 Ubuntu 피드의 .NET 패키지를 무시하도록 패키지 관리자를 구성하고 다른 원본에서 다시 설치해야 합니다.

.NET 설치 방법 결정 섹션에서 다른 제안을 검토하세요.

컨테이너, 클라우드 또는 연속 통합 시나리오에서 .NET 앱을 실행하려고 합니다

사용자의 Ubuntu 버전이 필요한 .NET 버전을 제공하는 경우 이를 기본 제공 피드에서 설치합니다. 그렇지 않은 경우 Microsoft 패키지 리포지토리를 등록하고 해당 리포지토리에서 .NET을 설치합니다. 지원되는 배포 섹션에서 정보를 확인하세요.

원하는 .NET 버전을 사용할 수 없는 경우 dotnet-install 스크립트를 사용해 보세요.

내 Ubuntu 배포판에 원하는 .NET 버전이 포함되어 있지 않거나 지원되지 않는 .NET 버전이 필요합니다

APT 및 Microsoft 패키지 리포지토리를 사용하는 것이 좋습니다. 자세한 내용은 Microsoft 패키지 리포지토리로 등록 및 설치 섹션을 참조하세요.

미리 보기 버전을 설치하려고 합니다

다음 방법 중 하나로 .NET을 설치합니다.

• install-dotnet 스크립트를 사용하여 .NET을 설치합니다.
• 수동으로 .NET 설치

APT를 사용하고 싶지 않습니다

자동 설치를 원하는 경우 Linux 설치 스크립트를 사용합니다.

.NET 설치 환경을 완전히 제어하려면 tarball을 다운로드하여 수동으로 .NET을 설치합니다. 자세한 내용은 수동 설치를 참조하세요.

Arm 기반 CPU를 사용하고 있습니다

사용자의 Ubuntu 버전에서 필요한 .NET 버전을 제공하는 경우 기본 제공 피드에서 설치합니다. 지원되는 배포 섹션에서 정보를 확인하세요.

원하는 .NET 버전을 사용할 수 없는 경우 다음 방법 중 하나를 사용하여 .NET을 설치해 보세요.

• install-dotnet 스크립트를 사용하여 .NET을 설치합니다.
• 수동으로 .NET 설치

IBM System Z 플랫폼을 사용하고 있습니다

Ubuntu 24.04의 .NET 8부터는 Canonical이 IBM System Z 플랫폼용 .NET을 지원합니다. Canonical은 다른 .NET와 Ubuntu 버전으로 지원을 확장하기 위해 노력하고 있습니다.

기본 제공 Ubuntu 피드를 통해 .NET를 설치합니다. 자세한 내용은 다음 페이지를 참조하세요.

• Ubuntu 24.10에 .NET 9를 설치합니다.

지원되는 배포

다음 표는 현재 지원되는 .NET 릴리스와 해당 릴리스가 지원되는 Ubuntu 버전의 목록입니다. 각 링크는 해당 버전의 Ubuntu에 .NET을 설치하는 방법에 대한 특정 지침이 포함된 특정 Ubuntu 버전 페이지로 이동합니다.

Ubuntu 버전의 지원 기간이 종료되면 해당 특정 Ubuntu 버전에서 .NET이 더 이상 지원되지 않습니다.

Canonical은 해당 Ubuntu 버전의 수명 동안 기본 제공 Ubuntu 피드에서 .NET 버전을 지원하며(Microsoft가 제공하는 지원 수명 이후까지), .NET 백포트 패키지 리포지토리의 .NET 버전에 대해 최상의 지원을 제공합니다(Microsoft가 제공하는 지원 수명 이내에서).

다음 .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

Ubuntu .NET 백포트 패키지 리포지토리

Ubuntu .NET 백포트 패키지 리포지토리는 기본 제공 Ubuntu 피드에서 사용할 수 없는 .NET 버전을 제공합니다. 지원되는 배포 섹션에서는 패키지 피드에서 사용할 수 있는 .NET 버전을 나열한 표를 제공합니다. Canonical은 이 패키지 리포지토리에 포함된 패키지를 유지 관리하며 Microsoft에서 제공하는 지원 수명 또는 특정 Ubuntu 버전의 지원 기간 이내에서 최상의 지원을 제공합니다.

자세한 내용은 Ubuntu .NET 백포트 패키지 리포지토리의 웹 뷰를 참조하세요.

Ubuntu .NET 백포트 패키지 리포지토리 등록

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

sudo add-apt-repository ppa:dotnet/backports

Ubuntu .NET 백포트 패키지 리포지토리 등록 취소

Ubuntu .NET 백포트 패키지 리포지토리의 패키지를 더 이상 사용하지 않으려면 등록을 취소할 수 있습니다. 터미널을 열고 다음 명령을 실행합니다.

sudo add-apt-repository --remove ppa:dotnet/backports

add-apt-repository 명령을 찾을 수 없음

add-apt-repository(1) 유틸리티는 대부분의 Ubuntu 설치에 미리 설치되어 있습니다.

add-apt-repository 명령을 찾을 수 없다는 오류 메시지가 표시되면 이 명령을 제공하는 software-properties-common 패키지를 설치해야 합니다. 터미널을 열고 다음 명령을 실행합니다.

sudo apt update
sudo apt install software-properties-common

Microsoft 패키지 리포지토리 등록

Microsoft 패키지 리포지토리에는 사용자의 Ubuntu 버전에서 이전에 지원되었거나 현재 지원되는 모든 .NET 버전이 포함되어 있습니다. Ubuntu 버전에서 .NET 패키지를 제공하는 경우 Ubuntu 패키지의 우선순위를 낮추고 Microsoft 리포지토리를 사용해야 합니다. 패키지의 우선순위를 낮추는 방법에 대한 지침은 내 Linux 배포판에서 제공하지 않는 .NET 버전이 필요합니다를 참조하세요.

미리 보기 릴리스는 Microsoft 패키지 리포지토리에서 사용할 수 없습니다. 자세한 내용은 미리 보기 버전 설치를 참조하세요.

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

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

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download Microsoft signing key and repository
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

# Install Microsoft signing key and repository
sudo dpkg -i packages-microsoft-prod.deb

# Clean up
rm packages-microsoft-prod.deb

# Update packages
sudo apt update

.NET 설치

명령을 사용하여 패키지 관리자를 통해 .NET을 설치합니다 sudo apt install <package-name> . <package-name>을(를) 설치하려는 .NET 패키지의 이름으로 바꿉니다. 예를 들어 .NET SDK 9.0을 설치하려면 명령을 sudo apt install dotnet-sdk-9.0사용합니다. 다음 표에서는 현재 지원되는 .NET 패키지( Ubuntu 버전에 따라 다를 수 있음)를 나열합니다.

일부 환경 변수는 .NET이 설치된 후 실행되는 방식에 영향을 줍니다. 자세한 내용은 .NET SDK 및 CLI 환경 변수를 참조하세요.

.NET 제거

패키지 관리자를 통해 .NET을 설치한 경우 apt-get remove 명령을 사용하여 동일한 방법으로 제거합니다.

sudo apt-get remove dotnet-sdk-6.0

자세한 내용은 .NET 제거를 참조하세요.

미리 보기 버전 설치

.NET의 미리 보기 및 릴리스 후보 버전은 패키지 리포지토리에서 사용할 수 없습니다. 다음 방법 중 하나로 .NET의 미리 보기 및 릴리스 후보를 설치할 수 있습니다.

• install-dotnet.sh 스크립트를 통한 설치
• 수동 이진 추출

미리 보기 버전 제거

패키지 관리자를 사용하여 .NET 설치를 관리하는 경우 미리 보기 릴리스를 이전에 설치했으면 충돌이 발생할 수 있습니다. 패키지 관리자는 미리 보기가 아닌 릴리스를 이전 버전의 .NET으로 해석할 수 있습니다. 미리 보기가 아닌 릴리스를 설치하려면 먼저 미리 보기 버전을 제거합니다. .NET 제거에 대한 자세한 내용은 .NET 런타임 및 SDK를 제거하는 방법을 참조하세요.

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

패키지 관리자를 통해 .NET을 설치한 경우 apt upgrade 명령을 사용하여 패키지를 업그레이드할 수 있습니다. 예를 들어 다음 명령은 dotnet-sdk-9.0 패키지를 최신 버전으로 업그레이드합니다.

sudo apt update
sudo apt upgrade dotnet-sdk-9.0

문제 해결

Ubuntu 22.04부터 .NET의 일부만 사용 가능해 보이는 상황이 발생할 수 있습니다. 예를 들어 런타임과 SDK를 설치했지만 dotnet --info을(를) 실행할 때 런타임만 나열됩니다. 이 상황은 서로 다른 두 패키지 소스를 사용하는 경우와 관련이 있을 수 있습니다. 기본 제공 Ubuntu 22.04 및 Ubuntu 22.10 패키지 피드에는 .NET 전체 버전이 아닌 일부 버전이 포함되어 있으며, 사용자가 Microsoft 피드에서 .NET을 설치했을 수도 있습니다. 이 문제를 해결하는 방법에 관한 자세한 내용은 Linux에서 누락된 파일과 관련된 .NET 오류 문제 해결을 참조하세요.

APT 문제

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

패키지를 찾을 수 없음

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

• install-dotnet 스크립트를 사용하여 .NET을 설치합니다.
• 수동으로 .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을 다시 설치해 봅니다. 이 방법으로 문제가 해결되지 않으면 다음 명령을 사용하여 수동 설치를 실행할 수 있습니다.

Ubuntu 23.10 이상을 사용하는 경우 다음 명령을 사용해 보세요.

# 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}

23.10 이전의 Ubuntu 버전을 사용하는 경우 다음 명령을 사용해 보세요.

# 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을 수동으로 설치하거나 자체 포함 앱을 게시하는 경우 다음 종속성을 설치하여 앱을 실행해야 합니다.

• ca-certificates
• libc6
• libgcc1(16.x 및 18.x용)
• libgcc-s1(20.x 이상용)
• libgssapi-krb5-2
• libicu55(16.x용)
• libicu60(18.x용)
• libicu66(20.x용)
• libicu70(22.04용)
• libicu72(23.10)
• libicu74(24.04 이상)
• liblttng-ust1(22.x 이상)
• libssl1.0.0(16.x용)
• libssl1.1(18.x용, 20.x용)
• libssl3(22.x 이상)
• libstdc++6
• libunwind8(22.x 이상)
• zlib1g

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

sudo apt install zlib1g

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

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

다음 단계

• .NET CLI 개요
• .NET CLI에 대해 탭 완성 기능을 사용하는 방법
• 자습서: Visual Studio Code를 사용하여 .NET SDK에서 콘솔 애플리케이션 만들기