본문 바로가기
텔레그램 한글 가이드
채널·봇 STEP 82 / 98

텔레그램 데이터 센터 — _MIGRATE 오류와 옮겨 가기

텔레그램 서버의 데이터 센터 구조를 개발자 눈높이로 정리했습니다. 계정과 파일이 속한 곳, help.getConfig 로 목록 받기, MIGRATE 오류별 할 일, 데이터 센터마다 따로인 인증 키와 다시 로그인 없이 옮기는 법을 안내합니다.

  • 난이도L4
  • 읽는 시간4분
  • 최종 검증

결론부터

  1. 1계정은 집 데이터 센터 하나, 파일은 저장된 dc_id 를 단다.
  2. 2MIGRATE_X 오류는 X 로 옮겨 다시 — 목록은 help.getConfig 로.
  3. 3키는 데이터 센터마다 따로, 인증은 export·import 로 옮긴다.
이 글의 목차
  1. 텔레그램 서버는 여러 곳에 나뉘어 있다
  2. 데이터 센터 목록 받기
  3. '다른 곳으로 가라'는 오류
  4. 다시 로그인하지 않고 옮기기
  5. 자주 묻는 질문
  6. 한눈에 정리

텔레그램 서버는 여러 곳에 나뉘어 있다

텔레그램 서버는 여러 지역의 데이터 센터(DC, 번호로 구분)에 나뉘어 있습니다. 계정마다 '집'처럼 속한 데이터 센터가 있고, 파일도 저장된 데이터 센터 번호(dc_id)를 달고 있습니다. 공식 앱과 TDLib 은 이 차이를 알아서 처리하지만, MTProto 를 직접 다루면 직접 챙겨야 합니다.

무엇어디에 속하나
사용자 계정정해진 집 데이터 센터 하나
파일(사진·동영상·문서)파일마다 dc_id — 올린 곳에서 바로 받을 수 있다
큰 파일 전송파일 전용(미디어) 연결·CDN 이 따로 있을 수 있다

데이터 센터 목록 받기

앱은 처음에 아무 데이터 센터에나 연결한 뒤 help.getConfig 로 설정을 받습니다. 그 안의 데이터 센터 목록(dcOptions)에 번호·주소·포트와 '파일 전용', 'CDN' 같은 표시가 들어 있습니다. 주소를 코드에 박아 두지 말고 이 목록을 저장해 씁니다. my.telegram.org 앱 정보 화면의 서버 주소는 처음 연결할 곳입니다(api_id 발급).

'다른 곳으로 가라'는 오류

요청을 엉뚱한 데이터 센터에 보내면 303 오류가 이름 끝에 갈 곳 번호를 달고 옵니다(오류 읽기).

오류언제할 일
PHONE_MIGRATE_X로그인할 때 — 이 번호의 집은 XX 에 연결해 로그인부터 다시
USER_MIGRATE_X로그인한 사용자의 요청 — 집이 XX 를 기본 연결로 바꾼다
NETWORK_MIGRATE_X지금 쓰는 연결 대신 X 를 쓰라X 로 옮겨 다시 요청
FILE_MIGRATE_X파일 올리기·받기 — 파일은 X 에X 에 파일용 연결을 만들어 다시

다시 로그인하지 않고 옮기기

집 데이터 센터에 로그인한 상태에서 다른 데이터 센터의 파일을 받으려면, 사용자를 또 로그인시킬 필요는 없습니다.

  1. 지금 데이터 센터에서 auth.exportAuthorization 으로 옮길 곳의 번호를 주고 일회용 인증 값을 받습니다.
  2. 옮길 데이터 센터에 연결해(새 인증 키) auth.importAuthorization 으로 그 값을 넘깁니다.
  3. 이제 그 데이터 센터에서도 같은 사용자로 요청할 수 있습니다.

한 인증 키로 여러 세션(연결)을 동시에 열 수 있어, 메시지용 연결과 큰 파일용 연결을 나눠 쓰기도 합니다 — 파일 올리기·받기.

자주 묻는 질문

텔레그램 데이터 센터는 무엇인가요?

텔레그램 서버가 나뉘어 있는 지역별 묶음입니다. 계정마다 속한 곳이 있고 파일도 저장된 곳이 정해져 있습니다.

FILE_MIGRATE_X 가 나와요.

그 파일이 X 번 데이터 센터에 있다는 뜻입니다. X 에 파일용 연결을 만들어 다시 요청합니다.

다른 데이터 센터에서 다시 로그인해야 하나요?

아닙니다. auth.exportAuthorization 으로 받은 값을 그곳에서 auth.importAuthorization 으로 넘기면 됩니다.

데이터 센터 주소는 어디서 얻나요?

help.getConfig 응답의 데이터 센터 목록을 저장해 씁니다. 처음 연결할 주소는 my.telegram.org 앱 정보 화면에 있습니다.

참고한 공식 문서

요약

한눈에 정리

  1. 1구조

    계정 · 파일마다 DC.

  2. 2오류

    MIGRATE_X → X 로.

  3. 3옮기기

    새 키 · export·import.

이 글 공유하기

같은 문제를 겪는 친구에게 보내 주세요.

텔레그램
더보기

휴대폰으로 열기휴대폰 카메라로 비추면 이 글이 열려요.

최종 수정 2026-10-06

함께 보면 좋은 글

전체 보기 ›