# cPanel에서 KapsuleHost로 웹사이트 마이그레이션하기

Source: https://support.kapsulehost.com/ko-kr/sites-migrate-cpanel

대부분의 고객은 파일에 손대지 않고 cPanel에서 사이트를 이전합니다. KapsuleHost에는 기존 사이트를 그대로 운영한 상태에서 파일과 데이터베이스를 대신 복사해 주는 안내형 마이그레이션 기능이 있습니다. 이 가이드에서는 세 가지 마이그레이션 경로와 그중 무엇을 선택해야 하는지, 그리고 직접 진행하고자 하는 경우를 위한 수동 방법을 다룹니다.

마이그레이션은 모든 요금제에서 무료입니다. 설정 비용이나 사이트별 요금은 없습니다.

## 시작하기 전에

> **Note:** 새 사이트가 확인되고 도메인이 완전히 연결될 때까지 기존 호스팅을 계속 활성 상태로 유지하십시오. 이 과정에서 되돌릴 수 없는 유일한 실수는 호스팅을 너무 일찍 해지하는 것입니다. 복사본의 원본이 그와 함께 사라지기 때문입니다. 일주일 정도의 중첩 기간을 두시기 바랍니다.

다음 사항을 미리 준비해 두십시오:

- 현재 사이트가 운영되고 있는 도메인
- 사이트의 WordPress 관리자 또는 cPanel이나 FTP 로그인 중 하나에 대한 접근 권한
- 마지막 단계에 필요한 도메인 등록 기관 로그인 정보
- 무료 사이트 슬롯이 있는 KapsuleHost 호스팅 요금제

## 마이그레이션 경로 선택하기

왼쪽 KPanel 사이드바에서 **마이그레이션**를 엽니다. 웹사이트 마이그레이션으로 이동하여 현재 사이트 주소를 입력합니다. KapsuleHost가 사이트를 확인하고 플랫폼을 식별한 후 세 가지 경로를 제시합니다.

![KPanel의 마이그레이션 경로 옵션](https://support.kapsulehost.com/help/screenshots/sites-migrate-cpanel.89d2d04b.webp)

| 경로 | 작동 방식 | 적합한 경우 |
|---|---|---|
| **KapsuleHost Migrator Plugin** | 원본 사이트에 무료 플러그인을 설치하고 일회용 토큰을 붙여넣습니다. 호스팅 자격 증명이 외부로 전달되지 않습니다. | WordPress 및 WooCommerce 사이트. 가장 빠른 방법이며 대부분의 고객에게 권장되는 방법입니다. |
| **호스팅 자격 증명** | 임시 FTP, SFTP 또는 cPanel 접근 권한과 데이터베이스 정보를 제공해 주시면 저희가 직접 가져옵니다. | WordPress가 아닌 사이트를 포함한 모든 플랫폼. |
| **저희 팀이 직접 처리** | 사이트에 대해 알려 주시면 마이그레이션 엔지니어가 수동으로 처리합니다. | 복잡한 구성, 여러 사이트를 한 번에 이전하는 경우, 또는 직접 하고 싶지 않은 경우. |

세 가지 방법 모두 무료이며, 마법사 진행 중 언제든지 방법을 변경할 수 있습니다.

### 플러그인 경로

1. **KapsuleHost Migrator Plugin**을 선택합니다.
2. 화면에서 `kapsule-migrator.zip`를 다운로드합니다.
3. 현재 사이트에서 **Plugins**, **Add New**, **Upload Plugin** 순서로 이동합니다. zip 파일을 업로드하고 활성화합니다.
4. WordPress 관리자 메뉴에서 **KapsuleHost Migrate**를 엽니다.
5. KPanel에서 토큰을 복사하여 플러그인에 붙여넣고 **마이그레이션 시작**을 클릭합니다.

KPanel이 연결을 자동으로 감지하고 실시간 진행 화면으로 이동시켜 줍니다. 파일, 데이터베이스, 업로드 파일이 모두 대신 복사됩니다. 토큰은 48시간 후 만료되며, 필요한 경우 같은 화면에서 새 토큰을 발급받을 수 있습니다.

### 자격 증명 경로

**호스팅 자격 증명**을 선택하고 두 섹션을 입력합니다: FTP, SFTP 또는 SSH 정보(호스트명, 사용자 이름, 비밀번호)와 데이터베이스 정보(호스트, 이름, 사용자 이름, 비밀번호)입니다. cPanel 주소와 같이 도움이 될 만한 추가 정보를 입력할 수 있는 메모란도 있습니다.

> **Note:** 자격 증명은 저장되기 전에 암호화되며, 직원이 아닌 자동화된 마이그레이션 시스템만 읽을 수 있습니다. 마이그레이션 완료 후 24시간 이내에 영구적으로 삭제되며, 사이트 복사 외의 목적으로는 결코 사용되지 않습니다.

### 팀 경로

사이트에 대한 정보와 원하시는 일정을 알려 주십시오. 마이그레이션 엔지니어가 영업시간 기준 4시간 이내에 계획과 함께 답변을 드리며, 고객님의 승인 없이는 어떤 것도 적용되지 않습니다.

## 다음 단계

어떤 경로를 선택하셨든 진행 방식은 동일합니다:

1. 복사 작업은 백그라운드에서 진행됩니다. 기존 사이트는 그동안 계속 그대로 운영됩니다.
2. 새 사이트를 임시 주소에서 검토할 수 있게 됩니다.
3. 확인 후 승인합니다.
4. 그 이후에야 DNS가 변경됩니다.

기존 사이트는 이전 호스팅에서 그대로 유지되며, 7일간의 롤백 기간이 제공됩니다. 새 사이트가 공개된 후 7일 동안 마이그레이션 페이지에서 버튼 하나(**이전 호스팅 업체로 되돌리기**)를 클릭하면 도메인을 원래대로 되돌릴 수 있으며, DNS가 자체 등록 기관에 있는 경우 복원해야 할 정확한 레코드가 표시됩니다. [사이트 전환 후 마음이 바뀐 경우](https://support.kapsulehost.com/ko-kr/migrations-overview)를 참고하십시오. 최소한 이 7일 동안은 기존 호스팅을 유지하시기 바랍니다.

## 전환 전 검토하기

이 단계는 신중하게 진행할 가치가 있습니다. DNS가 변경된 이후로는 모든 방문자가 승인하신 내용 그대로를 보게 되기 때문입니다.

임시 주소를 열어 다음 사항을 확인하십시오:

- 홈페이지와 하위 페이지 두세 개
- 슬라이더나 갤러리에 포함된 이미지를 포함한 모든 이미지
- 연락처 또는 예약 양식을 실제로 제출해 보기
- 관리자 로그인 및 수정 사항 하나 저장해 보기
- 쇼핑몰의 경우: 확인 페이지까지 이어지는 전체 테스트 주문

일부 URL이 여전히 이전 도메인을 가리키고 있다면 검색 및 바꾸기를 실행하십시오: [검색 및 바꾸기 실행하기](https://support.kapsulehost.com/ko-kr/wordpress-search-replace).

## 도메인 연결하기

검토가 완료되면 도메인을 옮깁니다. 더 간단한 방법이자 DNS 관리를 KPanel로 가져오는 방법인 네임서버를 KapsuleHost로 변경하거나, 기존 DNS 제공업체를 그대로 유지한 채 사이트 레코드만 재지정할 수 있습니다.

전체 안내는 [네임서버 변경하기](https://support.kapsulehost.com/ko-kr/nameservers) 및 [웹사이트에 사용자 지정 도메인 연결하기](https://support.kapsulehost.com/ko-kr/custom-domain-for-website)에서 확인하실 수 있습니다.

DNS 변경 사항이 모든 사용자에게 전파되기까지는 몇 분에서 몇 시간까지 걸릴 수 있습니다. 이 기간 동안 일부 방문자는 여전히 이전 호스팅에 접속하게 되며, 이것이 바로 기존 호스팅을 계속 유지해야 하는 이유입니다.

> **Tip:** 금요일 저녁이 아니라 평일 오전의 한가한 시간에 도메인을 전환하시기 바랍니다. 조정이 필요한 경우 고객님께서 깨어 계시고 저희와 연락 가능한 시간이어야 합니다.

## 수동으로 마이그레이션하기

직접 진행하고 싶으시거나 사이트가 지원되는 플랫폼이 아닌 경우에도 수동 방법은 여전히 사용할 수 있습니다.

### 1. 사이트 생성하기

**웹사이트**에서 **웹사이트 추가**, **새 웹사이트** 순서로 진행합니다. 이전하려는 사이트 유형에 맞는 사이트 유형을 선택합니다. 사이트는 즉시 테스트해 볼 수 있는 임시 주소로 생성됩니다. [첫 웹사이트 만들기](https://support.kapsulehost.com/ko-kr/creating-your-first-website)를 참고하십시오.

### 2. cPanel에서 내보내기

cPanel의 파일 관리자 또는 FTP를 통해 사이트 파일을 다운로드합니다. WordPress의 경우 `wp-config.php`을 포함하여 `public_html` 아래의 모든 항목이 해당됩니다. 원하신다면 cPanel의 Backup Wizard를 사용해 전체를 하나의 다운로드 파일로 받을 수도 있습니다.

그런 다음 데이터베이스를 내보냅니다: cPanel에서 phpMyAdmin을 열고 데이터베이스를 선택한 후 **Export**, **Quick**, **Go** 순서로 진행합니다.

### 3. 파일 업로드하기

1. KPanel에서 새 사이트를 연 다음 **설정**, **SFTP** 순서로 이동합니다.
2. **SFTP 계정**에서 사용자 이름을 입력하고 **Create**를 클릭합니다.
3. 표시된 호스트, 포트, 사용자 이름, 비밀번호를 복사합니다. 비밀번호는 한 번만 표시되며 이후에는 복구할 수 없습니다.
4. 원하는 SFTP 클라이언트로 연결하여 파일을 사이트 디렉터리에 업로드합니다.

SFTP 계정과 네이티브 SSH 접근에 대한 전체 내용은 [SFTP로 연결하기](https://support.kapsulehost.com/ko-kr/sftp-access)에서 확인하실 수 있습니다.

### 4. 데이터베이스 가져오기

1. 사이트를 연 다음 **데이터베이스**로 이동합니다.
2. **phpMyAdmin 열기**를 클릭합니다. 별도의 비밀번호 없이 자동으로 로그인됩니다.
3. 데이터베이스를 선택하고 **Import**를 클릭한 다음 `.sql` 파일을 선택하고 **Go**를 클릭합니다.

가져오기 제한 및 대용량 덤프 처리 방법에 대해서는 [phpMyAdmin으로 데이터베이스 접근하기](https://support.kapsulehost.com/ko-kr/sites-phpmyadmin)를 참고하십시오.

### 5. wp-config.php 업데이트하기

Database 탭에는 새 연결 정보가 표시됩니다. **설정**, **파일 관리자**를 사용하여 이 정보를 `wp-config.php`에 복사해 넣습니다:

```php
define( 'DB_NAME', 'your-new-database-name' );
define( 'DB_USER', 'your-new-database-user' );
define( 'DB_PASSWORD', 'your-new-password' );
define( 'DB_HOST', '127.0.0.1' );
```

> **Warning:** 이전 호스팅의 `.htaccess` 규칙을 그대로 가져오지 마십시오. KapsuleHost는 Apache를 사용하지 않으므로 해당 규칙은 작동하지 않으며, 실제로는 리디렉션이 적용되지 않았는데도 적용된 것처럼 오해하게 만들 수 있습니다. 대신 KPanel에서 다시 설정하십시오: [KapsuleHost에서 .htaccess 이해하기](https://support.kapsulehost.com/ko-kr/wordpress-htaccess).

### 6. 테스트 후 도메인 재지정하기

임시 주소를 열어 위의 검토 목록을 확인한 다음 도메인을 연결합니다.

## 문제 해결

**사이트는 로드되지만 스타일이 적용되지 않습니다.** 데이터베이스에 이전 절대 URL이 남아 있는 경우입니다. 이전 주소에서 새 주소로 검색 및 바꾸기를 실행하십시오.

**"Error establishing a database connection" 오류가 발생합니다.** `wp-config.php`의 자격 증명이 Database 탭과 일치하지 않는 경우입니다. `DB_HOST`이 `127.0.0.1`인지 확인하십시오.

**데이터베이스 가져오기가 도중에 실패합니다.** 덤프 파일이 phpMyAdmin의 업로드 제한보다 큰 경우입니다. `.sql.gz`로 압축하거나, 더 작은 파일로 분할하거나, 티켓을 열어 주시면 저희가 대신 가져와 드리겠습니다.

**이전 후 일부 페이지에서 404 오류가 발생합니다.** 리라이트 규칙을 새로고침하십시오: **WordPress**, **빠른 작업**, **Rewrites 비우기** 순서로 진행합니다. [WordPress 고유 주소 문제 해결하기](https://support.kapsulehost.com/ko-kr/wordpress-permalink-issues)를 참고하십시오.

**자물쇠 아이콘이 없거나 경고가 표시됩니다.** 데이터베이스에 남아 있는 HTTP URL로 인한 혼합 콘텐츠 문제입니다: [혼합 콘텐츠 경고 해결하기](https://support.kapsulehost.com/ko-kr/ssl-mixed-content)를 참고하십시오.