메인 콘텐츠로 건너뛰기

FASTPANEL 간 사용자 이전

소개​

이 문서에서는 사용자 계정과 그에 연결된 데이터(웹사이트, 데이터베이스, 이메일 등)를 이전하는 과정을 설명합니다 내장된 마이그레이션 유틸리티를 사용하여 한 FASTPANEL 서버에서 다른 서버로.

주요 용어​

  • 원본 서버 - 데이터가 이전되는 서버입니다.
  • 대상 서버 - 데이터가 이전되는 서버입니다.

중요 참고 사항​

  • 기본적으로 마이그레이션은 표준 FASTPANEL 구성의 사이트에서만 올바르게 작동합니다.

  • 수동 구성 변경이 있는 사이트는 IP 주소 매핑에 -m 플래그를 사용하는 경우에만 이전할 수 있습니다.

  • 데이터베이스 소유자의 암호화된 비밀번호를 사용할 수 없으면 해당 데이터베이스는 이전되지 않습니다.

  • 웹사이트가 이전되지 않으면 연결된 데이터베이스도 함께 이전되지 않습니다.

  • 로컬 데이터베이스만 이전할 수 있습니다.

마이그레이션 프로세스​

연결​

대상 서버는 SSH를 통해 원본 서버에 연결합니다. 최초 연결 시 대상 서버는 원본 서버에 SSH 키를 설치합니다(미리 제공되었거나 비밀번호로부터 생성된 키).

마이그레이션 단계​

  • 모듈 설치
  • 이전 가능한 객체 정보 수집
  • 사용자 생성
  • SSL 인증서 이전
  • 웹사이트, FTP 계정, 이메일 도메인 및 이메일 계정 생성
  • 데이터베이스 및 데이터베이스 사용자 생성
  • 웹사이트 및 이메일 사서함 파일 이전
  • cron 작업 전송

파일 전송은 rsync를 사용하여 수행됩니다. 데이터베이스는 SSH 터널을 통해 덤프를 생성하여 이전됩니다.

마이그레이션 시작 명령​

이 명령은 대상 서버에서 root 권한이 있는 사용자로 실행합니다:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

명령줄 플래그​

SSH 연결​

  • --remote_host="SOURCE_IP" - 원본 서버의 IP 주소.
  • --remote_port="SSH_PORT" - SSH 포트.
  • --remote_username="SSH_USER" - 사용자(root여야 함).
  • --remote_password="USER_PASSWORD" - 지정된 SSH 사용자의 비밀번호.
  • --ssh_key_path="PATH_TO_KEY" - 원본 서버에 연결하기 위한 대상 서버의 개인 SSH 키 경로. 키를 사용하는 경우 비밀번호(--remote_password)는 필요하지 않습니다.

IP 주소​

이전 중 사이트 IP 주소를 관리하려면 다음 플래그 중 하나만 사용해야 합니다. -m 플래그가 우선 적용됩니다.

  • -i "IP_ADDRESS_ON_DESTINATION" - 대상 서버에서 이전된 모든 사이트에 지정된 IP 주소를 할당합니다. 여러 IP를 지정하려면(예: 원본에 여러 개가 있었던 경우), 이전해야 하는 각 원본 IP에 대해 플래그를 반복해서 지정하십시오.

  • -m "SOURCE_IP,DESTINATION_IP" - 권장 방법. 직접 매핑을 설정합니다. 원본 서버에서 SOURCE_IP를 사용하는 모든 사이트는 대상 서버에서 DESTINATION_IP를 사용하게 됩니다. 이 플래그는 서로 다른 IP 쌍에 대해 여러 번 지정할 수 있습니다. 수동으로 구성을 편집한 사이트를 전송할 때 필수이며, listen 지시문에서 IP 주소를 올바르게 바꿀 수 있게 해줍니다.

추가 설정​

  • --users="USER_LIST" - 지정된 사용자만 이전합니다(쉼표로 구분). 지정하지 않으면 모든 사용자가 이전됩니다.
  • --disable_disk_quota - 사용자 디스크 쿼터의 이전을 비활성화합니다.
  • --with_user_data - 사용자 홈 디렉터리의 전체 내용(logs/ 하위 디렉터리 제외) 복사를 포함합니다. 이 경우 전송 시간과 전송되는 데이터 양이 크게 증가할 수 있으므로 주의해서 사용하십시오.
  • --only_data - 데이터만 이전합니다(웹사이트 파일, 메일 파일, 데이터베이스 덤프). 초기 구조 마이그레이션(사용자, 사이트, DB 등)이 성공했지만 파일 또는 덤프 복사 단계에서 오류가 발생한 경우 유용합니다. 데이터 복사 부분만 다시 실행할 수 있습니다.
  • --transfer_timeout - 작업 제한 시간을 설정합니다(기본값은 60분).

명령 예시​

서버 11.22.33.44의 모든 사용자를 현재 서버로 이전합니다. 기존 서버에서 사이트는 IP 11.22.33.44 및 11.22.33.55를 사용했고, 새 서버에서는 각각 99.88.77.66 및 99.88.77.67를 사용해야 합니다. 비밀번호를 사용한 SSH 연결.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

가능한 문제 및 오류 유형​

마이그레이션 로그의 오류가 항상 치명적인 문제를 의미하는 것은 아니며, 특정 객체가 이전되지 않은 이유를 가리킬 수도 있습니다.

  • 충돌: 대상 서버의 현재 구성 때문에 객체를 이전할 수 없는 경우(예: 같은 이름의 사용자 또는 사이트가 이미 존재함) 또는 원본 서버의 사이트 구성이 패널에 알려지지 않은 경우(예: 광범위한 수동 편집으로 인해) 발생합니다.

  • 저장된 비밀번호 누락: 앞서 언급했듯이, 원본 서버의 FASTPANEL에 저장된 비밀번호가 없는 MySQL 데이터베이스 사용자는 이전할 수 없습니다.

  • 수동 설정 및 IP 주소: 원본 서버의 사이트에 수동 웹 서버 구성 편집이 있고 마이그레이션 중에 해당 IP 주소를 매핑하기 위해 -m 플래그를 사용하지 않으면, 대상 서버의 구성에 어떤 IP를 지정해야 하는지 패널이 알 수 없으므로 해당 사이트는 이전되지 않습니다.