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

.NET은 Ubuntu에서 지원됩니다. 이 문서에서는 Ubuntu에 .NET을 설치하는 방법을 설명합니다. Ubuntu 버전의 지원이 종료되면 해당 버전에서는 .NET도 더 이상 지원되지 않습니다.

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

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

중요

패키지 관리자 설치는 x64 아키텍처에서만 지원됩니다. ARM 과 같은 기타 아키텍처는 Snap, 설치 프로그램 스크립트 또는 수동 이진 설치 등의 다른 방법으로 .NET을 설치해야 합니다.

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

지원되는 배포

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

  • ✔️는 Ubuntu 또는 .NET 버전이 계속 지원됨을 나타냅니다.
  • ❌는 Ubuntu 또는 .NET 버전이 해당 Ubuntu 릴리스에서 지원되지 않음을 나타냅니다.
  • Ubuntu 버전과 .NET 버전 모두에 ✔가 있으면 해당 OS와 .NET 조합은 지원됩니다.
Ubuntu .NET Core 2.1 .NET Core 3.1 .NET 5.0
✔️ 21.04 ✔️ 2.1 ✔️ 3.1 ✔️ 5.0
20.10 ✔️ 2.1 ✔️ 3.1 ✔️ 5.0
✔️ 20.04(LTS) ✔️ 2.1 ✔️ 3.1 ✔️ 5.0
19.10 ✔️ 2.1 ✔️ 3.1 ✔️ 5.0
19.04 ✔️ 2.1 ✔️ 3.1 ❌ 5.0
18.10 ✔️ 2.1 ❌ 3.1 ❌ 5.0
✔️ 18.04(LTS) ✔️ 2.1 ✔️ 3.1 ✔️ 5.0
17.10 ✔️ 2.1 ❌ 3.1 ❌ 5.0
17.04 ✔️ 2.1 ❌ 3.1 ❌ 5.0
16.10 ❌ 2.1 ❌ 3.1 ❌ 5.0
✔️ 16.04(LTS) ✔️ 2.1 ✔️ 3.1 ✔️ 5.0

다음 .NET 버전은 더 이상 지원되지 않습니다. 이러한 버전의 다운로드는 여전히 게시된 상태로 유지됩니다.

  • 3.0
  • 2.2
  • 2.0

미리 보기 버전 제거

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

21.04 ✔️

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

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

wget https://packages.microsoft.com/config/ubuntu/21.04/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 apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-5.0

중요

dotnet-sdk-5.0 패키지를 찾을 수 없음 과 유사한 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-5.0

중요

aspnetcore-runtime-5.0 패키지를 찾을 수 없음 과 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

20.10 ❌

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

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

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

wget https://packages.microsoft.com/config/ubuntu/20.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 apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-5.0

중요

dotnet-sdk-5.0 패키지를 찾을 수 없음 과 유사한 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-5.0

중요

aspnetcore-runtime-5.0 패키지를 찾을 수 없음 과 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

20.04 ✔️

몇 가지 명령을 사용하여 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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-5.0

중요

dotnet-sdk-5.0 패키지를 찾을 수 없음 과 유사한 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-5.0

중요

aspnetcore-runtime-5.0 패키지를 찾을 수 없음 과 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

19.10 ❌

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

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

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

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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-3.1

중요

패키지 dotnet-sdk-3.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-3.1

중요

패키지 aspnetcore-runtime-3.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

19.04 ❌

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

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

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

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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-3.1

중요

패키지 dotnet-sdk-3.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-3.1

중요

패키지 aspnetcore-runtime-3.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

18.10 ❌

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

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

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

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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

중요

패키지 dotnet-sdk-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

중요

패키지 aspnetcore-runtime-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

18.04 ✔️

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

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

wget https://packages.microsoft.com/config/ubuntu/18.04/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 apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-5.0

중요

dotnet-sdk-5.0 패키지를 찾을 수 없음 과 유사한 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-5.0

중요

aspnetcore-runtime-5.0 패키지를 찾을 수 없음 과 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

17.10 ❌

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

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

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

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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

중요

패키지 dotnet-sdk-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

중요

패키지 aspnetcore-runtime-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

17.04 ❌

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

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

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

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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

중요

패키지 dotnet-sdk-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

중요

패키지 aspnetcore-runtime-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

16.10 ❌

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

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

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

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

SDK 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

중요

패키지 dotnet-sdk-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

중요

패키지 aspnetcore-runtime-2.1을 찾을 수 없습니다 와 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

16.04 ✔️

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

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

wget https://packages.microsoft.com/config/ubuntu/16.04/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 apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-5.0

중요

dotnet-sdk-5.0 패키지를 찾을 수 없음 과 유사한 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

런타임 설치

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-5.0

중요

aspnetcore-runtime-5.0 패키지를 찾을 수 없음 과 같은 오류 메시지가 표시되는 경우 APT 문제 해결 섹션을 참조하세요.

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

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

다른 버전을 설치하는 방법

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

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

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

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

    • sdk
    • 런타임
  • version
    설치한 SDK 또는 런타임의 버전입니다. 이 문서에서는 항상 지원되는 최신 버전에 대한 지침을 제공합니다. 유효한 옵션은 모든 릴리스된 버전입니다. 예:

    • 5.0
    • 3.1
    • 3.0
    • 2.1

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

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

패키지가 없음

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

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

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

sudo apt-get update
sudo apt-get upgrade

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

APT 문제 해결

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

패키지를 찾을 수 없음

중요

패키지 관리자 설치는 x64 아키텍처에서만 지원됩니다. ARM 과 같은 기타 아키텍처는 Snap, 설치 프로그램 스크립트 또는 수동 이진 설치 등의 다른 방법으로 .NET을 설치해야 합니다.

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

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

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

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

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

  • {os-version}
    이는 현재 배포 버전을 나타냅니다. 아래의 wget 명령에서 사용됩니다. 배포 버전은 Ubuntu의 20.04 또는 Debian의 10과 같은 숫자 값입니다.

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

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/ubuntu/{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 apt-transport-https && \
  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
  • libgssapi-krb5-2
  • libicu52(14.x용)
  • libicu55(16.x용)
  • libicu60(18.x용)
  • libicu66(20.x용)
  • libssl1.0.0(14.x용, 16.x용)
  • libssl1.1(18.x용, 20.x용)
  • libstdc++6
  • zlib1g

System.Drawing.Common 어셈블리를 사용하는 .NET 앱의 경우 다음과 같은 종속성도 필요합니다.

  • libgdiplus(버전 6.0.1 이상)

    경고

    시스템에 Mono 리포지토리를 추가하여 최신 버전의 libgdiplus 를 설치할 수 있습니다. 자세한 내용은 https://www.mono-project.com/download/stable/를 참조하세요.

다음 단계