검증된 운영 도메인, 스토어별 링크, 이전 호스트명을 안전하게 교체할 계획.
1. 주소 계획하기
기본 도메인에는 역할 세 가지가 있어요: 콘솔 은 팀용, 결제 화면 은 고객용, 공개 API 는 통합용이에요. 기본 이름은 merchant, pay, api이며 다른 이름과 별칭을 사용할 수 있어요.
| 역할 | 첫 번째 도메인 | 두 번째 도메인 |
|---|---|---|
| 콘솔 | merchant.example.com | panel.example.org |
| 결제 화면 | pay.example.com | payment.example.org |
| 공개 API | api.example.com | api.example.org |
두 도메인은 같은 설치로 연결되고 별도 지갑, 데이터, 접근 권한을 만들지 않아요. 스토어 선호 도메인은 생성 링크를 정할 뿐 테넌트 격리가 아니에요.
2. 도메인 추가 또는 별칭 관리하기
열기 설정 → 시스템 → 도메인다음을 사용하세요: 도메인 추가 운영 도메인 위에서 새 기본 도메인을 추가해요. 예: example.org다음을 사용하세요: 관리 을 기존 항목에서 사용해 별칭을 추가하거나 기본 주소를 바꾸세요.
예를 들어 merchant와 panel을 모두 콘솔 이름으로 유지하세요. 별표가 있는 첫 이름이 해당 역할의 기본값이에요. 시스템 전체 기본 링크에 쓸 기본 도메인을 고르세요.
운영 중인 기본 이름은 바로 바꿀 수 없어요. 대신 대체 도메인을 추가하세요. 초안에는 다음이 표시돼요: 활성화 대기 아직 운영 중이 아니에요. 다음을 선택하세요: DNS로 계속 로 저장하고 검토하세요.
3. DNS를 VPS로 연결하기
새 호스트명마다 다음을 추가하세요: A 레코드 패널에 표시된 VPS IPv4로 연결하세요. 해당 IPv6가 실제 서버에 도달할 때만 AAAA를 추가하세요. 오래된 레코드는 제거하세요. Wholly Crypto가 DNS를 대신 편집하지 않아요.
인바운드를 열어 두세요: TCP 80 및 443 을 서버·제공자 방화벽에서 허용하세요. SSH 접근은 유지하세요. 클릭: DNS 확인새로 추가·변경한 호스트·역할 쌍을 권한 DNS로 검사하고 바뀌지 않은 운영 주소는 재사용해요.
Cloudflare를 쓰나요?
첫 설치는 설정을 마칠 때까지 프록시를 꺼두세요. 이후에는 Wholly Crypto 모드 전환 없이 직접·프록시 DNS를 쓸 수 있어요. Let's Encrypt는 VPS에 남아요.
사용 Full (strict) ↗HTTP 인증서 챌린지에 접근할 수 있게 하고 콘솔·결제·API 요청에는 캐시와 브라우저·봇 챌린지를 적용하지 마세요. Wholly Crypto도 원본을 검증할 수 있어야 해요.
권한 검사는 일반 VPS·ISP 주소 캐시를 우회해요. 방문자는 이전 DNS 캐시를 사용할 수 있고 네임서버 변경은 더 오래 걸릴 수 있어요.
4. 검토 후 게시하기
초안 저장이나 DNS 검사 통과가 운영 경로를 바꾸지는 않아요.
추가·제거·기본 주소 변경을 검토한 뒤 다음을 선택하세요: 활성화로 계속 → SSL 검증 및 게시수정했거나 DNS 검사 후 10분이 지났으면 다시 검사해야 해요.
새 주소는 인증서 챌린지, HTTPS, 올바른 서비스를 검사해요. 변경 없는 운영 호스트·역할 쌍은 네트워크 검사를 반복하지 않지만 전체 Nginx 설정은 검증해요.
성공 후 다음으로 돌아갈 때까지 기다리세요: 운영 도메인각 새 호스트명을 열어 역할을 확인하세요. 실패하면 배포 보고·롤백 상태를 읽은 뒤 재시도하세요. 강제로 활성화하려고 작동 중인 도메인을 삭제하지 마세요.
5. 스토어별 도메인 선택하기
이동하세요: 프로젝트 → 스토어 → 스토어 선택 → 기본 → 스토어 도메인해당 스토어의 활성 판매자·결제·API 호스트를 선택하세요. 대기 주소는 선택할 수 없어요.
생성 링크의 순서: 스토어 선택 → 프로젝트 기본 스토어 → 시스템 기본값예를 들어 청구서 API의 links.checkout 에서 사용할 수 있어요: payment.example.org 을 한 스토어에 쓰고 다른 스토어는 다음을 유지할 수 있어요: pay.example.com.
SDK·쇼핑몰 플러그인 API 출처는 따로 설정하세요. 스토어 선호 변경이 통합 설정을 바꾸지 않아요. 보존된 서명 IPN·웹훅 재시도는 원래 링크를 유지하며 기존 북마크·고객 링크도 바뀌지 않아요.
콘솔 별칭도 Basic Auth와 앱 로그인이 필요해요. 다음에서: 설정 → 시스템 → 원본 IP 제한규칙은 호스트명마다 따로 적용돼요. 의도적으로 비공개 결제를 운영하는 경우가 아니라면 고객 결제는 열어 두세요.
6. 두 단계로 이전 주소 교체하기
- 이전 호스트명이 작동하는 동안 대체 주소를 추가·게시하세요.
- 새 콘솔 주소를 열어 로그인하세요. 새 주소로 결제·API 접근을 테스트하세요.
- 스토어 선호, 통합, 북마크, 공개 링크를 갱신하세요. 고객·클라이언트가 사용 중이면 이전 pay/API 별칭을 유지하세요.
- 새 콘솔 주소에서 이전 도메인·별칭을 관리해 제거 초안을 만드세요. 변경을 검토·게시한 뒤 DNS 레코드를 지우세요.
패널은 현재 사용 중인 콘솔 호스트명을 제거하지 못하게 해요. 폐기된 호스트는 거부되며 자동 리디렉션되지 않아요새 DNS 조회가 필요 없어도 기본값만 바꾸거나 제거할 때는 검토·게시가 필요해요.