SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

Ubuntu에서 Tailscale 설치 오류 해결하기

Ubuntu에서 Tailscale 설치가 실패하면 apt 상태 코드와 전체 URL을 먼저 확인합니다. release codename 오류와 signing keyring 문제를 구분해 정확히 수정하는 방법을 안내합니다.

Ubuntu에서 Tailscale 설치 오류가 apt 오류인 이유

Ubuntu에서 발생하는 Tailscale 설치 오류는 대부분 Tailscale 코드가 실행되기 전에 발생합니다. 이는 apt 오류입니다. 2026년 10월 기준으로 Ubuntu 패키지 아카이브를 확인했을 때 tailscale 패키지는 존재하지 않았으며, Go 헬퍼 라이브러리와 python3-tailscale만 검색되었습니다. 따라서 데몬은 일반적으로 pkgs.tailscale.com에 있는 Tailscale 자체 apt 저장소에서 가져옵니다. Canonical 또한 Tailscale snap을 유지 관리하고 있으며, 이에 대해서는 마지막 부분의 대체 방안에서 다룹니다.

해당 저장소를 추가하면 두 개의 파일이 생성됩니다. 하나는 apt에 패키지 위치를 알려주는 파일이고, 다른 하나는 apt가 저장소 인덱스의 서명을 확인하는 데 사용하는 공개 키를 담고 있는 파일입니다. 아래에 나열된 거의 모든 실패 사례는 이 두 파일 중 하나가 잘못되었거나, apt와 저장소 사이의 장비가 요청을 거부하여 발생합니다.

다음은 Tailscale이 Ubuntu 24.04를 위해 게시한 명령어입니다.

sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.tailscale-keyring.list | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update && sudo apt-get install tailscale

noble은 Ubuntu 24.04의 코드네임이며, 두 URL 모두에 나타납니다. 두 번째 명령어는 /etc/apt/sources.list.d/tailscale.list 파일에 주석 한 줄과 deb 한 줄을 작성하며, cat은 그곳에 정확히 무엇이 기록되었는지 보여줍니다.

cat /etc/apt/sources.list.d/tailscale.list

해당 deb 줄을 네 개의 필드로 구성된 주소로 읽으십시오. 대괄호로 묶인 옵션 [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg], https를 통해 접근하는 저장소 베이스인 pkgs.tailscale.com/stable/ubuntu, 스위트(suite)인 noble, 그리고 컴포넌트인 main입니다. apt는 베이스와 스위트를 하나의 URL로 결합하여 가져옵니다: https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease. 해당 URL을 수동으로 가져와 보는 것은 요청을 테스트하는 방법이지만, apt의 요청이 성공할 것임을 보장하지는 않습니다.

설정을 변경하기 전에 apt 오류 메시지를 확인하십시오

오류 메시지가 화면에서 사라지지 않도록 업데이트 명령을 단독으로 실행하십시오.

sudo apt update

서드파티 저장소 오류는 다음과 같이 나타납니다. 코드네임과 IP 주소는 사용자의 환경에 따라 다를 수 있습니다.

E: Failed to fetch https://pkgs.tailscale.com/stable/ubuntu/dists/wilma/InRelease  404  Not Found [IP: 203.0.113.9 443]
E: Some index files failed to download. They have been ignored, or old ones used instead.

출력 내용 중 다음 단계를 결정하는 요소는 상태 코드와 E: Failed to fetch 줄에 표시된 전체 URL입니다. 하단 요약 줄만 보고 추측하지 마십시오. URL을 복사하여 서버에 직접 요청을 보내 확인하십시오.

curl -sS -o /dev/null -w '%{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease

이 명령은 Tailscale이 게시한 코드네임에 대해 200을 출력합니다. 2026년 10월 확인 결과, noble는 Origin: Tailscale 및 Codename: noble를 포함하는 서명된 인덱스를 반환합니다. 오류 메시지에 나타난 코드네임으로 noble를 교체하여 다시 실행하십시오. apt에서는 가져오기 오류가 발생했으나 curl에서는 200을 반환한다면, 저장소가 curl의 요청에는 응답한 것입니다. 하지만 이것이 apt 설정이 잘못되었다는 증거는 아닙니다. 서비스나 경로상의 필터링이 User-Agent와 같은 헤더를 기준으로 요청을 구분할 수 있기 때문입니다. 200은 다운로드가 성공했음을 증명할 뿐입니다. apt는 인덱스를 다운로드한 후 서명을 검증하며, 키 관련 문제는 이 단계에서 실패합니다. 이는 아래의 키링 섹션에서 다룹니다.

상태 코드가 의미하는 것

  • 404 Not Found은 서버가 해당 경로에서 파일을 찾지 못했거나, 파일 존재 여부를 공개하지 않으려 함을 의미합니다. 자격 증명 없이 파일을 제공하는 pkgs.tailscale.com에서는 거의 항상 URL의 코드네임이 원인입니다.
  • 403 Forbidden은 무언가가 응답했으나 거부했음을 의미합니다. 403 코드만으로는 거부 주체가 프록시인지, 필터링 장비인지, 서버와 Tailscale 사이의 방화벽인지, 아니면 서비스 자체인지 식별할 수 없습니다. 예를 들어 AWS는 CloudFront 배포가 방화벽 규칙이나 오리진 서버 등의 이유로 자체적으로 403을 반환할 수 있다고 명시합니다.
  • 407 Proxy Authentication Required는 프록시가 해당 요청에 대해 인증을 요구함을 의미합니다. apt가 프록시 자격 증명을 보내지 않았거나, 보낸 자격 증명이 유효하지 않거나 불완전하여 프록시가 거부한 경우입니다. 401 Unauthorized는 이와 다릅니다. 이는 요청한 리소스 자체에 대한 자격 증명을 요구하는 것으로, WWW-Authenticate 헤더와 함께 전송되며 그 자체로는 프록시를 식별하지 않습니다. 이 저장소는 자격 증명 없이 파일을 제공하므로, 401은 일반적으로 가로채기 게이트웨이와 같이 해당 URL에 대해 다른 무언가가 응답했음을 의미합니다. 프록시 섹션의 디버그 명령어를 사용하면 apt가 실제로 도달한 호스트를 확인할 수 있습니다.
  • 연결 오류나 이름 해석 오류는 HTTP 통신 자체가 발생하지 않았음을 의미합니다. IPv6 섹션으로 넘어가십시오.

URL에 포함된 코드네임은 Tailscale이 공개하지 않는 값입니다

Tailscale은 Ubuntu 코드네임별로 별도의 디렉터리를 생성합니다. 서버에 존재하지 않는 코드네임을 요청하면 dists/<codename>가 없어 404 오류가 발생합니다. pkgs.tailscale.com/stable에 있는 공급업체의 목록에서 실제 존재하는 코드네임을 확인할 수 있습니다. 2026년 10월 기준으로 이 목록은 16.04부터 Ubuntu 26.10인 stonking까지 포함하며, 바로 아래에는 Ubuntu 26.04인 resolute이 있습니다.

잘못된 코드네임이 입력되는 일반적인 원인은 Ubuntu 기반이지만 Ubuntu는 아닌 배포판에서 lsb_release -cs을 실행하는 경우입니다. Linux Mint 22에서 해당 명령을 실행하면 Mint 자체 코드네임인 wilma이 출력되는데, Tailscale은 이를 위한 패키지를 제공하지 않습니다. 대신 Ubuntu 기반 버전을 확인하십시오.

. /etc/os-release
echo "$VERSION_CODENAME $UBUNTU_CODENAME"

Ubuntu에서는 두 값이 동일합니다. 파생 배포판에서는 VERSION_CODENAME가 해당 배포판의 이름이고 UBUNTU_CODENAME이 기반이 되는 Ubuntu 릴리스입니다. 두 URL 모두에 UBUNTU_CODENAME을 사용하십시오.

두 번째 원인은 릴리스 업그레이드입니다. Ubuntu 업그레이드 도구는 실행 시 서드파티 소스를 비활성화합니다. 따라서 Ubuntu 24.04에서 26.04로 업그레이드한 후에는 /etc/apt/sources.list.d/tailscale.list가 주석 처리되어 있거나, 시스템은 resolute인데 여전히 noble을 가리키고 있을 것입니다. 새로운 코드네임으로 두 개의 curl 명령을 다시 실행하여 파일을 덮어쓰면 해결됩니다. 업그레이드 도중 중단되어 dpkg가 이 저장소뿐만 아니라 구성이 완료되지 않은 패키지에 대해 오류를 보고한다면, apt가 구성을 마칠 수 없는 시스템에서는 tailscale.list를 수정해도 소용없으므로 먼저 실패한 릴리스 업그레이드를 복구하십시오.

세 번째 원인은 시점 문제입니다. Tailscale이 코드네임을 추가하기 전에 새로운 Ubuntu 릴리스에 설치하면 동일한 404 오류가 발생합니다. 이러한 공백기는 짧거나 아예 없는 경우가 많습니다. Ubuntu 24.04 설치 지원을 위한 Tailscale의 추적 이슈는 해당 릴리스가 출시되기 수개월 전인 2024년 1월에 완료 처리되었습니다. 2026년 10월 24일에 확인한 Ubuntu 26.10의 경우, dists/stonking/InRelease은 Origin: Tailscale 및 Codename: stonking이 포함된 서명된 인덱스를 반환했습니다. 따라서 이전에 stonking에서 404 오류를 보았다면 우회하기 전에 다시 가져오기를 시도하십시오. 만약 공백기에 해당한다면 이전 LTS 코드네임을 지정하여 설치할 수 있습니다. 패키지의 의존성이 적기 때문입니다. 하지만 해당 저장소를 선택한다고 해서 특정 Ubuntu 릴리스용 빌드가 선택되는 것은 아닙니다. Tailscale의 deb 빌드는 amd64 및 arm64과 같은 Linux 아키텍처를 대상으로 합니다. apt policy tailscale를 사용하여 실제로 설치된 버전을 확인하고, 실제 코드네임이 나타나면 파일을 원래대로 되돌리십시오.

keyring이 비어 있고 키를 기록한 명령도 아무 출력이 없는 경우

이 경우는 조용히 끝나며, 대부분의 문제가 이 단계에서 발생합니다. keyring 명령을 다시 확인합니다.

curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null

셸은 두 프로그램이 실행되기 전에 전체 파이프라인을 구성합니다. 따라서 sudo tee가 keyring 경로를 열고 즉시 0바이트로 잘라 냅니다. 그런 다음 curl이 실패하고, -f 때문에 모든 HTTP 오류에서 실패하도록 설정되어 있으면 curl은 아무것도 기록하지 않고 0이 아닌 종료 상태로 끝납니다. 파일은 0바이트로 남습니다. 파이프라인의 종료 상태는 마지막 명령의 상태이며, 마지막 명령은 tee입니다. 이 명령은 성공합니다. 아무것도 출력되지 않으므로 키가 설치되었다고 생각하고 다음 명령으로 넘어가게 됩니다.

파일을 만든 명령이 아니라 파일 자체를 확인합니다.

ls -l /usr/share/keyrings/tailscale-archive-keyring.gpg
gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg

정상적인 keyring은 pub 줄과 Tailscale을 이름으로 표시하는 uid 줄을 출력합니다. 0바이트 파일은 gpg: no valid OpenPGP data found.만 출력하고 다른 내용은 출력하지 않습니다. HTML 오류 페이지가 저장된 파일도 같은 결과를 냅니다. 이 파일에 head -c 80를 실행하면 바이너리 키 데이터가 아니라 웹 페이지의 시작 부분이 표시됩니다.

사용할 수 있는 키가 없는 keyring에서는 sudo apt update가 인덱스를 다운로드한 다음 이를 거부합니다. Tailscale 저장소와 해당 suite를 표시하는 W: GPG error 줄이 출력되고, 그 아래에 16자리 키 ID가 뒤따르는 The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 텍스트가 출력됩니다. 이어서 저장소에 서명이 없다는 오류가 표시됩니다. apt의 메시지를 정확히 해석해야 합니다. 인덱스는 정상적으로 다운로드했지만 서명을 확인하지 못했다는 뜻입니다. 이는 네트워크 문제가 아니라 키 문제입니다. keyring 파일 자체가 없으면 메시지가 다시 달라지며 Could not open file /usr/share/keyrings/tailscale-archive-keyring.gpg를 사용해 경로를 직접 표시합니다.

다운로드 실패로 정상적인 keyring이 손상되지 않도록 키를 2단계로 기록합니다.

curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg -o /tmp/tailscale.gpg
gpg --show-keys /tmp/tailscale.gpg
sudo install -m 0644 -o root -g root /tmp/tailscale.gpg /usr/share/keyrings/tailscale-archive-keyring.gpg

가운데 줄이 확인 단계입니다. 이 줄에서 Tailscale uid이 출력되지 않으면 중지하고 파일을 복사하지 않습니다. 0644 모드가 중요한 이유는 apt가 가져오기와 검증을 수행할 때 권한이 없는 _apt 사용자로 권한을 낮추기 때문입니다. root만 읽을 수 있는 keyring은 apt가 사용할 수 없는 keyring입니다.

.list 파일과 .sources 파일이 동일한 저장소를 가리키는 경우

Ubuntu는 24.04 LTS부터 자체 소스 형식을 deb822로 변경하였으며, 이때 /etc/apt/sources.list은 /etc/apt/sources.list.d/ubuntu.sources가 되었습니다. Tailscale은 여전히 한 줄 형식(one line format)으로 배포합니다. 2026년 10월 확인 결과, pkgs.tailscale.com의 해당 .sources URL은 404 오류를 반환했습니다. 만약 시스템에 동일한 저장소를 설명하는 tailscale.sources과 tailscale.list이 모두 존재한다면, apt는 해당 저장소가 두 번 정의된 것으로 인식합니다.

경미한 경우에는 업데이트를 수행할 때마다 다음과 같은 경고가 발생합니다.

W: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list.d/tailscale.list:1 and /etc/apt/sources.list.d/tailscale.sources:1

심각한 문제는 두 파일이 서로 다른 키링(keyring) 경로를 지정할 때 발생합니다. apt가 어떤 키가 해당 저장소를 관리하는지 결정할 수 없기 때문입니다. 이때 apt는 E: Conflicting values set for option Signed-By regarding source를 출력하고 저장소와 스위트(suite) 정보를 표시한 뒤, 두 키링 경로 사이에 !=을 넣어 출력하고 작업을 중단합니다.

E: The list of sources could not be read.

이 오류는 파일 중 하나를 제거하기 전까지 업데이트뿐만 아니라 모든 apt 명령을 차단합니다. 동일한 오류가 Ubuntu 자체 저장소에서도 발생할 수 있으며, deb822 마이그레이션 후 발생하는 apt 소스 중복 오류 문서에서 일반적인 해결 방법을 확인할 수 있습니다.

무언가를 삭제하기 전에 Tailscale을 언급하는 모든 파일을 찾으십시오.

grep -RIn tailscale /etc/apt/sources.list /etc/apt/sources.list.d/

파일 하나만 남겨두십시오. 다른 파일을 삭제하지 않고 비활성화하려면 이름을 변경하십시오. apt는 .list 또는 .sources로 끝나는 파일만 읽으므로, tailscale.list.bak으로 이름을 바꾸면 apt는 이를 무시하며 참조용으로 디스크에 남게 됩니다.

deb822 source 파일을 올바르게 작성하기

새 형식을 사용하려면 저장소 주소를 다시 입력하지 말고 이미 있는 파일을 변환합니다. 주소에 오타가 있으면 위와 같은 오류가 발생하기 때문입니다. 최신 apt 릴리스에는 .list 파일을 deb822 stanza로 다시 작성하고 signed-by 옵션을 Signed-By으로 옮기는 변환기가 포함되어 있습니다.

apt modernize-sources --help
sudo apt modernize-sources

Ubuntu 24.04에는 해당 하위 명령이 포함되기 전 버전의 apt가 제공됩니다. 따라서 도움말 행을 확인하면 현재 apt에 이 기능이 있는지 바로 알 수 있습니다. 기능이 없다면 키보드로 다시 입력하지 말고 디스크에 이미 있는 행을 기준으로 stanza를 작성합니다. 이렇게 하면 base가 사용자가 입력한 값이 아니라 공급업체 파일에서 가져옵니다.

. /etc/os-release
{
  echo 'Types: deb'
  echo "URIs: $(awk '/^deb /{print $3}' /etc/apt/sources.list.d/tailscale.list)"
  echo "Suites: $UBUNTU_CODENAME"
  echo 'Components: main'
  echo 'Signed-By: /usr/share/keyrings/tailscale-archive-keyring.gpg'
} | sudo tee /etc/apt/sources.list.d/tailscale.sources
sudo rm /etc/apt/sources.list.d/tailscale.list

이 명령은 작성한 stanza를 출력합니다. 따라서 다음 apt update 전에 필드를 다시 확인할 수 있습니다. 다음 4개 필드는 각각 다른 방식으로 실패하므로 자세히 알아둘 필요가 있습니다.

  • URIs은 저장소의 base에서 끝나야 합니다. 여기에 dists/noble 부분을 붙여 넣으면 404가 발생합니다. apt가 dists/<suite>을 자체적으로 덧붙여 dists/noble/dists/noble을 요청하기 때문입니다.
  • Suites는 codename입니다. 한 줄 형식에서 가운데에 있던 값과 정확히 같습니다.
  • Signed-By에는 keyring 파일의 절대 경로를 지정합니다. 이 항목 아래에 armored key를 직접 포함할 수도 있습니다. 이 경우 key의 모든 줄을 공백 1개로 들여쓰고, key 내부의 각 빈 줄은 단일 점으로 작성해야 합니다.
  • Enabled: no은 source를 삭제하지 않고 비활성화합니다. 따라서 이름을 바꾸는 것보다 되돌리기 쉽고 다음 담당자에게 설명하기도 쉽습니다.

서드파티 저장소는 파일마다 stanza 하나만 유지합니다. 여러 stanza를 하나의 파일에 함께 둘 경우 stanza 사이에 빈 줄을 넣습니다. 저장소 인덱스에는 지원 아키텍처로 amd64와 arm64이 포함되어 있으므로 ARM VPS에는 별도의 Architectures 필드가 필요하지 않습니다.

중간 프록시가 403 오류를 반환하는 경우

403 오류는 요청이 거부되었음을 의미하지만, 거부 지점을 명확히 알려주지는 않습니다. 서버와 Tailscale 사이의 장비나 서비스 자체의 필터링 설정이 원인일 수 있습니다. 우선 apt 자체 설정부터 확인하십시오. apt에 설정된 프록시는 대화형 curl에는 적용되지 않기 때문입니다.

grep -RIn -i proxy /etc/apt/apt.conf.d/ /etc/apt/apt.conf
sudo apt-config dump | grep -i 'acquire::http'

그다음 apt가 실제로 전송하는 내용을 확인하십시오.

sudo apt -o Debug::Acquire::http=1 update

이 명령은 요청 라인, apt가 보낸 헤더, 그리고 연결된 프록시가 있다면 해당 프록시 정보를 출력합니다. 동일한 URL에 대해 일반 curl 명령을 실행한 결과와 비교해 보십시오. curl은 200를 반환하는데 apt는 403를 반환한다면, 프록시 설정뿐만 아니라 요청 헤더도 비교해야 합니다. 서비스나 경로상의 필터링 장비는 User-Agent를 기준으로 요청을 구분할 수 있기 때문입니다.

curl -sS -o /dev/null -w '%{http_code}\n' -A 'Debian APT-HTTP/1.3' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease

위 명령으로 403 오류가 발생하고 기본 curl 명령으로는 200이 반환된다면, 응답은 User-Agent에 따라 달라지는 것입니다. 하지만 이 테스트만으로는 필터링 지점을 특정할 수 없습니다. 네트워크의 필터링 규칙을 확인하고, 규칙으로 설명되지 않는다면 Tailscale 측에 응답 차이를 보고하십시오. 서버에서 보내는 모든 요청이 403을 반환한다면, 다른 네트워크에 있는 장비에서 동일한 curl 명령을 실행해 보십시오. 그곳에서 200이 반환된다면 거부 원인이 클라이언트나 네트워크에 있다는 뜻입니다. 다만 지리적 제한과 같은 서비스 측 규칙도 이러한 차이를 유발할 수 있습니다. Tailscale 상태 페이지도 함께 확인하십시오. 두 네트워크 모두에서 403이 발생한다고 해서 차단 지점이 명확해지는 것은 아닙니다. TLS를 검사하는 기업용 프록시는 또 다르게 동작합니다. 프록시가 사용하는 인증 기관(CA)이 서버에서 신뢰되지 않으면 apt는 인증서 검증 실패를 보고합니다. Ubuntu 미러만 허용하는 클라우드 송신(egress) 방화벽도 흔한 원인 중 하나이며, 이 경우 방화벽에서 pkgs.tailscale.com을 허용하는 것이 해결책입니다.

IPv6 전용 송신 및 상태 코드가 아닌 오류

apt가 HTTP 응답을 전혀 받지 못한다면 각 프로토콜을 개별적으로 테스트하십시오.

curl -4 -sS -o /dev/null -w 'v4 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease
curl -6 -sS -o /dev/null -w 'v6 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease

IPv4는 응답하지만 IPv6가 응답하지 않거나 Network is unreachable을 보고하는 경우, IPv6 테스트는 실패한 것이지만 이것만으로는 apt의 실패 원인을 모두 설명할 수 없습니다. APT 2.8은 이미 주소 패밀리를 교차하며 기본 250밀리초 후 다른 연결 시도를 시작합니다. apt의 결과가 달라지는지 확인하려면 다음 명령으로 IPv4를 강제하여 실행하십시오.

sudo apt -o Acquire::ForceIPv4=true update

이 업데이트가 성공한다면 설정을 영구적으로 적용하십시오.

echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4

반대의 경우도 명확히 파악해야 합니다. IPv4 주소가 전혀 없는 VPS에서는 IPv4를 강제해도 아무것도 해결되지 않습니다. 트래픽을 보낼 IPv4 경로가 존재하지 않기 때문입니다. 저장소에 네이티브 IPv6로 접근할 수 없다면 제공업체에서 제공하는 NAT64와 DNS64를 사용하거나, IPv4 주소를 보유한 프록시가 필요합니다. IPv6 주소가 포함된 연결 오류는 IPv6 연결 시도가 실패했음을 나타냅니다. curl -6 라인을 사용하여 해당 경로를 별도로 테스트하십시오.

대안과 그에 따른 비용

벤더 설치 스크립트. curl -fsSL https://tailscale.com/install.sh | sh은 Tailscale이 홍보하는 명령어입니다. 스크립트를 읽어보면 /etc/os-release에서 배포판을 감지한 뒤, 이 가이드에서 수정하고 있는 두 경로인 /usr/share/keyrings/tailscale-archive-keyring.gpg와 /etc/apt/sources.list.d/tailscale.list에 동일한 URL로부터 파일을 작성합니다. 이는 기대치 설정에 중요합니다. 즉, 프록시가 차단 중인 저장소를 우회하지는 못합니다. 출력 결과만 적을 뿐 동일한 방식으로 실패합니다. 다운로드한 스크립트를 root 권한으로 셸에 파이프(pipe)로 넘기는 것은 해결책이 아니라 거래입니다. 해당 시점에 서버가 반환하는 내용을 무조건 신뢰해야 하며 실행한 내용의 사본도 남지 않기 때문입니다. 이 거래를 선택한다면, 위험을 인지하고 진행하십시오.

curl -fsSL https://tailscale.com/install.sh -o install.sh
less install.sh
sh install.sh

정적 바이너리. 동일한 서버에서 pkgs.tailscale.com/stable의 정적 바이너리 섹션을 통해 일반 tarball을 배포합니다. 2026년 11월 3일 기준으로 안정 버전은 11월 2일에 릴리스된 1.104.5이며, 64비트 x86 파일은 tailscale_1.104.5_amd64.tgz입니다. 해당 페이지에는 이전 버전 링크도 있습니다. tailscale 클라이언트와 tailscaled 데몬을 직접 배치하고 데몬을 직접 관리해야 하므로 apt upgrade 경로는 존재하지 않습니다. 1.104.5 버전은 대체 tarball을 다운로드하여 sudo tailscale update로 정적 설치를 업데이트하는 기능을 지원합니다. 이 방식은 에어갭(air-gapped) 호스트를 사용하거나 특정 버전을 고정해야 할 때 적합합니다.

Ubuntu 자체 패키지. 2026년 10월 확인 당시 아카이브에는 tailscale deb 파일이 없었으므로, 벤더 저장소 없이 sudo apt install tailscale을 실행하면 E: Unable to locate package tailscale에서 종료되었습니다. Canonical은 sudo snap install tailscale로 설치하는 snap을 배포하며, 이는 Snap Store에서 제공되므로 위에서 언급한 모든 apt 오류를 피할 수 있습니다. 2026년 11월 3일 확인 결과, 1/stable 채널은 Tailscale의 최신 버전인 1.104.5보다 낮은 1.102.3 버전을 제공하고 있습니다. 해당 목록에는 Canonical이 유지 관리하며 업스트림 개발자가 반드시 보증하는 것은 아니라고 명시되어 있습니다. 업데이트는 snapd의 일정에 따라 진행되며, Ubuntu Server에서 snap 업데이트 제어하기에서 관리 방법을 설명합니다. 만약 Tailscale이 호스팅하는 서버가 아닌 직접 제어하는 조정 서버를 원한다면 이는 별개의 결정 사항입니다. 직접 제어 서버로 Headscale 운영하기에서 다루고 있으며, Tailscale과 일반 WireGuard 비교에서는 이러한 도구가 필요한지 여부를 다룹니다.

패키지는 설치되었으나 tailscaled가 시작되지 않는 경우

apt 설치가 완료된 후에도 데몬에서 오류가 발생할 수 있습니다.

systemctl status tailscaled
sudo journalctl -u tailscaled -n 50

LXC나 OpenVZ와 같이 호스트 커널을 공유하는 컨테이너 가상화 환경의 VPS에서 로그에 /dev/net/tun가 누락되었다고 표시된다면, 컨테이너에 TUN 장치가 없다는 의미입니다. 데몬은 tailscale0 인터페이스를 생성하기 위해 TUN 장치가 필요하지만, 컨테이너에 해당 장치가 할당되지 않은 상태입니다. 서비스 제공업체에 컨테이너의 TUN 활성화를 요청하거나, 자체 커널을 사용할 수 있는 KVM 플랜으로 이전하십시오. KVM 환경에서도 게스트는 여전히 tun 커널 모듈이 필요합니다. 모듈이 누락된 경우 Tailscale의 Linux 문서에 따라 sudo modprobe tun 명령어로 로드하십시오.

그 후 sudo tailscale up 명령어를 실행하면 로그인 URL이 출력되며, tailscale status 명령어를 통해 100.64.0.0/10 범위의 주소를 가진 장치 목록을 확인할 수 있습니다. 목록에 장치가 나타나면 해당 장치를 기반으로 작업을 수행할 수 있습니다. 여기에는 VPS에서 사설 서브넷을 광고하거나 VPS를 출구 노드로 사용하는 작업이 포함됩니다.

FAQ

apt가 Tailscale 저장소가 서명되지 않았다고 하는 이유는 무엇입니까?

apt가 저장소 인덱스를 다운로드했으나 /usr/share/keyrings/tailscale-archive-keyring.gpg을 통해 서명을 검증할 수 없기 때문입니다. 일반적으로 키링 파일의 크기가 0바이트일 때 발생합니다. sudo tee가 파일을 잘라냈고, curl은 아무것도 다운로드하지 못했지만 tee이 성공하여 파이프라인이 성공으로 보고된 경우입니다. gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg를 실행하십시오. 정상적인 키링이라면 pub 줄과 Tailscale이 명시된 uid 줄이 출력됩니다. 비어 있거나 손상된 키링은 gpg: no valid OpenPGP data found.을 출력합니다. 키를 임시 파일로 다운로드하여 확인한 뒤, _apt 사용자가 읽을 수 있도록 0644 모드로 복사하십시오.

Tailscale URL에 어떤 Ubuntu 코드네임을 넣어야 합니까?

/etc/os-release의 UBUNTU_CODENAME 값을 사용하십시오. 이 값은 Ubuntu 24.04에서는 noble, Ubuntu 26.04에서는 resolute, Ubuntu 26.10에서는 stonking입니다. Ubuntu 기반 배포판에서 lsb_release -cs를 사용하지 마십시오. Linux Mint 22에서는 wilma이 출력되는데, Tailscale은 해당 이름으로 아무것도 게시하지 않으므로 apt는 dists/wilma/InRelease에서 404 오류를 보고합니다. 설정을 변경하기 전에 https://pkgs.tailscale.com/stable/ubuntu/dists/<codename>/InRelease를 대상으로 curl -sS -o /dev/null -w '%{http_code}\n'을 사용하여 인덱스를 직접 가져와 선택한 값이 올바른지 확인하십시오.

Tailscale 설치 스크립트를 셸로 파이프하여 실행해도 안전합니까?

이는 의도적으로 선택해야 하는 절충안입니다. 해당 스크립트는 Tailscale에서 제공하며 수동 설치 단계와 동일한 작업을 수행합니다. /etc/os-release을 읽고, 동일한 키링과 /etc/apt/sources.list.d/tailscale.list을 작성한 뒤 패키지를 설치합니다. 이 방식의 위험은 서버가 반환하는 내용을 root 권한으로 즉시 실행하며 기록을 남기지 않는다는 점입니다. -o install.sh로 스크립트를 다운로드하여 내용을 읽어본 뒤 실행하면, 맹목적인 실행 없이도 편리함을 누릴 수 있습니다. 또한 이미 실패한 URL을 사용하므로 저장소가 차단된 경우에는 스크립트도 도움이 되지 않습니다.

apt 저장소 없이 Ubuntu에 Tailscale을 어떻게 설치합니까?

두 가지 방법이 있습니다. 첫 번째는 Canonical이 유지 관리하는 snap인 sudo snap install tailscale을 사용하는 것입니다. 2026년 11월 3일 기준으로 1/stable 채널에서 1.102.3 버전을 제공하며, Tailscale이 반드시 보증하는 것은 아닙니다. 두 번째는 pkgs.tailscale.com에 게시된 정적 tarball을 사용하는 것입니다. 2026년 11월 3일 기준으로 1.104.5 버전이며 amd64 파일명은 tailscale_1.104.5_amd64.tgz입니다. tarball을 사용하면 tailscale 및 tailscaled 프로그램을 직접 설치하고 systemd를 통해 데몬을 직접 실행해야 합니다. 새 버전을 가져올 apt 패키지는 없지만, 1.104.5 버전은 정적 설치를 위한 sudo tailscale update를 지원합니다. 2026년 10월 확인 결과, Ubuntu 아카이브 자체에는 tailscale deb 파일이 포함되어 있지 않았으므로, 공급업체 저장소가 없는 시스템에서 sudo apt install tailscale은 E: Unable to locate package tailscale에서 멈췄습니다.

이 글이 도움이 되었나요?