국내 미러 소스 변경

이 문서는 패널의 「국내 미러」 기능을 소개합니다. 국내 서버의 소프트웨어 소스 / Docker 설치 소스를 알리윈 국내 미러로 전환합니다.

먼저 알아두기: 「소스」란 무엇인가

Linux에서 소프트웨어를 설치할 때는 「소프트웨어 저장소」(소스)에서 설치 패키지를 내려받습니다. 해외 서버가 기본으로 사용하는 공식 소스는 국내에서 접속이 매우 느리거나 아예 연결되지 않아 소프트웨어 설치가 멈추거나 타임아웃됩니다. 미러 변경은 다운로드 주소를 「해외 공식 소스」에서 「국내 미러 사이트」(예: 알리윈)로 바꾸는 것으로, 다운로드 속도가 즉시 빨라집니다.

기능 소개

중국 본토의 서버는 해외 소프트웨어 소스(get.docker.com, download.docker.com 등)에 접속할 때 매우 느리거나 아예 연결되지 않는 경우가 많습니다. 이 기능은 대상 서버의 시스템 소프트웨어 소스와 Docker 설치 소스를 원클릭으로 알리윈 국내 미러로 전환해, 소프트웨어 설치 / Docker 설치 시 멈춤, 타임아웃, SSL 연결 재설정 등의 문제를 해결합니다.

적용 시나리오

• 서버가 국내에 있어 해외 소스 접속이 느리거나 실패하는 경우
• 앱 모음에서 소프트웨어 설치가 실패하거나 Docker가 설치되지 않는 경우
• apt-get / dnf / apk 설치 시 국내 가속을 사용하고 싶은 경우

사용 방법

미러 변경 기능에는 두 가지 진입점이 있습니다:

진입점 1: 시스템 관리 패널(권장)

1. 서버 목록에서 특정 서버의 「시스템 관리」 버튼을 클릭합니다

2. 상단 탭에서 「미러」(⚡ 아이콘, 「예약 작업」과 「설정」 사이)를 찾습니다

3. 패널이 서버 시스템(배포판 + 패키지 관리자)을 자동 감지합니다

4. 필요에 따라 클릭합니다:

• 시스템 소스 변경(알리윈): 시스템 소프트웨어 소스(apt/dnf/apk)를 알리윈으로 전환
• Docker 소스 변경(알리윈): Docker 설치 소스를 알리윈으로 전환
• 공식 시스템 소스 복원 / 공식 Docker 소스 복원: 원클릭으로 공식 소스 복원

진입점 2: 서버 카드 빠른 버튼

서버 목록의 각 카드 버튼 영역에는 ⚡ 번개 아이콘(「시스템 관리」 버튼 오른쪽, 편집 연필 왼쪽)이 있어, 클릭하면 시스템 관리에 들어가지 않고 바로 미러 변경 패널을 열 수 있습니다.

지원 시스템

미러 소스 설명

• 알리윈 미러(mirrors.aliyun.com)를 사용합니다. 국내 대기업 소스로 장기간 안정적입니다.
• Docker 설치 소스는 알리윈 docker-ce 저장소를 사용해, Docker 엔진 자체를 내려받을 때 국내 가속을 적용합니다.

> ⚠️ 주의: 여기서 바꾸는 것은 설치 소스(소프트웨어 소스 + Docker 엔진 소스)이며, 「Docker 이미지 가속기」(docker pull 이미지를 내려받는 가속)가 아닙니다. 후자는 공용 가속 소스가 이미 대부분 무효화되어, 사용자가 알리윈 개인 가속기 ID를 직접 신청해야 합니다.

보안성

1. 자동 백업: 미러 변경 전에 기존 설정 파일을 자동으로 백업해 언제든 원클릭으로 복원할 수 있습니다.

2. 롤백 가능: 복원 버튼이 공식 소스를 되돌리고 캐시를 갱신합니다.

3. 소스 설정만 변경: 서버의 다른 어떤 설정도 건드리지 않습니다.

주의 사항

1. 미러 변경은 사용자가 직접 하는 작업이며, 패널이 「국내인지」를 자동 감지해 강제로 미러를 바꾸지 않습니다(미러를 바꾸면 안 되는 환경에서의 실수를 방지).

2. 너무 오래된 배포판(Fedora 32 등 이미 EOL)은 미러를 바꿔도 실패할 수 있습니다. 공식 소스가 유지보수를 중단했고 미러 사이트도 해당 버전을 더 이상 보관하지 않기 때문입니다.

3. Docker 설치 시 공식 스크립트 다운로드가 실패하면, 패널이 자동으로 알리윈 소스 설치로 폴백하므로 수동으로 개입할 필요가 없습니다.