---
title: "SLV Migrate Linux - 빠른 시작"
description: "slv migrate linux로 Linux 서버 전체를 새 머신으로 마이그레이션합니다."
canonical: "https://erpc.global/ko/doc/migrate/quickstart/"
locale: "ko"
---

# SLV Migrate Linux - 빠른 시작

## 🚚 SLV Migrate Linux

rsync를 사용해 SSH로 Linux 디스크 전체를 새 서버로 마이그레이션합니다. 전체 디스크 마이그레이션이므로 사용자 데이터, 설정, 설치된 패키지, SLV 노드 설정을 포함해 소스 서버의 모든 것이 대상 서버로 복사됩니다.

> **참고:** 이것은 `slv v switch`(validator identity 마이그레이션)와 다릅니다. `slv migrate linux`는 파일 시스템 전체를 복사하고, `slv v switch`는 이미 실행 중인 두 노드 사이에서 validator identity를 교체합니다.

### 사전 요구 사항

- **소스** 노드에 SLV CLI 설치
- 소스와 대상 모두에서 `sudo` / root 권한
- 소스에서 대상으로의 SSH 접속 (비밀번호 또는 키 기반)
- 대상 서버는 새로 설치한 상태여야 합니다 (기존 데이터가 감지되면 SLV가 경고합니다)

## 기본 사용법

**소스** 서버에서 실행:

```bash
sudo slv migrate linux --to root@new-server-ip
```

```
🚚 SLV Linux Migration

  Source:      ubuntu (this machine)
  Destination: root@203.0.113.50

📋 Exclude list:
  • /dev/*
  • /proc/*
  • /sys/*
  • /tmp/*
  • /run/*
  • /mnt/*
  • /media/*
  • /lost+found
  • /swapfile
  • /snap/*
  • /var/log/*

? Start migration? This will overwrite data on the destination. › Yes
  Syncing... (this may take a while depending on disk size)
√ Migration complete
  Rebooting destination...
```

## 옵션

| 옵션 | 설명 |
|---|---|
| `-t, --to <ssh>` | SSH 대상 (예: `root@new-server`) |
| `-p, --port <port>` | SSH 포트 (기본값: 22) |
| `--skip-reboot` | 마이그레이션 후 자동 재부팅 건너뛰기 |
| `--exclude <path>` | 추가 rsync 제외 패턴 (반복 지정 가능) |
| `--include <path>` | 기본 제외 목록에서 제거 (반복 지정 가능) |
| `--list-excludes` | 현재 제외 목록을 표시하고 종료 |
| `-y, --yes` | 확인 프롬프트 건너뛰기 |

## 사용자 지정 SSH 포트

대상이 비표준 SSH 포트를 사용하는 경우:

```bash
sudo slv migrate linux --to root@new-server-ip --port 2222
```

## 제외 경로 사용자 지정

제외될 항목 보기:

```bash
slv migrate linux --list-excludes
```

추가 경로 제외 (예: 더 빠른 마이그레이션을 위해 ledger 데이터 건너뛰기):

```bash
sudo slv migrate linux --to root@new-server-ip --exclude /home/solv/ledger
```

## 비대화형 모드

스크립트용:

```bash
sudo slv migrate linux --to root@new-server-ip --skip-reboot --yes
```

## 작동 방식

1. **사전 점검** — SSH 연결을 확인하고, 대상에 기존 데이터가 있으면 경고
2. **rsync** — 파일 시스템 전체(시스템 의사 파일 시스템 제외)를 SSH로 복사
3. **마이그레이션 후** — 대상 서버를 자동으로 재부팅 (`--skip-reboot` 지정 시 제외)

마이그레이션은 모든 파일 속성, 권한, 특수 파일을 보존하기 위해 `--archive --hard-links --acls --xattrs` 옵션으로 rsync를 사용합니다.

## ⚠️ 중요 참고 사항

- **root로 실행하세요** (또는 `sudo` 사용). root가 아닌 상태로 마이그레이션하면 시스템 파일이 누락됩니다.
- 대상은 **새 서버**여야 합니다. 기존 데이터는 덮어씌워집니다.
- rsync 종료 코드 23/24(부분 전송)는 오류가 아니라 경고로 처리됩니다. 일부 파일(활성 로그 등)은 완전히 전송되지 않을 수 있습니다.
- 마이그레이션 후에는 소스 서버를 폐기하기 전에 노드가 정상적으로 작동하는지 확인하세요.
- **validator identity 마이그레이션**(실행 중인 두 validator 간의 무중단 교체)에는 `slv v switch`를 대신 사용하세요. [Mainnet Validator 마이그레이션](https://erpc.global/ko/doc/mainnet-validator/migrate/)을 참고하세요.