작동하는 HTTPS 콘솔과 보호된 관리자 계정.
1. Linux VPS 준비하기
호스팅 제공자 패널에서 다음을 새로 만드세요: x86-64 Linux VPS 와 root 접근 권한. Ubuntu 24.04 LTS 또는 Debian 12+가 간단한 선택이에요. 유지보수 중인 OS를 사용하세요. 네이티브 설치 프로그램은 ARM을 지원하지 않아요.
작은 쇼핑몰은 다음 사양으로 시작하세요: 2 vCPU, 4 GB RAM, 60 GB SSD가벼운 사용은 1 vCPU, 2 GB RAM, 20 GB 디스크로도 가능하지만 OS, 결제 이력, 백업, 업데이트 공간을 남기세요. 이 서버는 블록체인 노드를 실행하지 않아요.
SSH 공개 키를 추가하고 서버 IP를 기록하며 첫 연결 시 SSH 호스트 지문을 검증하세요. SSH 개인 키는 공유하지 마세요. 다음을 참고하세요: 전체 요구 사항 또는 선택 가능한 Docker 설치.
2. 도메인을 서버로 연결하기
도메인 DNS 패널에 이 레코드를 추가하세요. 다음을 바꾸세요: example.com 및 IP를 본인 값으로.
| 호스트명 | 레코드 | 용도 |
|---|---|---|
| merchant.example.com | A → VPS IPv4 | 내 콘솔 |
| pay.example.com | A → VPS IPv4 | 고객 결제 화면 |
| api.example.com | A → VPS IPv4 | 내 통합 |
하위 도메인 이름은 자유롭게 정할 수 있고 설치 프로그램이 물어봐요. IPv6가 실제로 VPS에 연결될 때만 AAAA 레코드를 추가하세요. A 레코드가 맞아도 오래된 AAAA가 HTTPS 검증을 실패하게 할 수 있어요.
Cloudflare: 설치 중에는 프록시를 끄고 DNS 전용으로 설정하세요. 설정과 HTTPS 검증을 마치면 다시 켤 수 있어요. 원본 서버까지 암호화하고 가능하면 유효한 인증서와 Full (strict)를 사용하세요.
3. 방화벽 확인하기
인바운드 허용: TCP 80 및 443 을 VPS와 호스팅 제공자의 방화벽 모두에서 허용하세요. 실제 SSH 포트도 열어 두세요. 아웃바운드 HTTPS와 DNS가 작동해야 해요.
PostgreSQL이나 앱 내부 포트를 공개하지 마세요. 설치 프로그램은 방화벽 규칙을 대신 바꾸지 않아요. 접근 규칙을 바꿀 때 현재 SSH 세션을 열어 두어 스스로 잠기지 않게 하세요.
4. 서명된 설치 프로그램 실행하기
root로 SSH에 연결한 뒤 실행하세요:
bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh)설정에서 도메인, HTTPS 연락 이메일, 기본 법정화폐, HTTP Basic 사용자 이름·비밀번호를 물어봐요. 비밀번호를 직접 정하거나 생성할 수 있어요. 안전하게 보관하세요.
설치 프로그램은 서명된 릴리스를 검증하고 PostgreSQL, Nginx, HTTPS, 시스템 서비스를 설정해요. 성공 메시지를 기다리세요. Basic Auth 자격 증명은 별도의 보안 계층이며 나중에 만드는 콘솔 계정과는 달라요.
먼저 검사하거나 중단된 설치 재개하기
설치 전에 호환성 검사를 실행하세요:
bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --check보고된 오류를 고친 뒤 재개하세요. 설치 디렉터리를 삭제하거나 지갑 키를 다시 만들지 마세요.
bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resume5. 가입하고 계정 보호하기
판매자 호스트명을 열고 Basic Auth를 통과한 뒤 이메일과 강력한 비밀번호로 첫 관리자를 등록하세요. 설치 모드, 언어, 시간대를 선택하고 연결된 약관·개인정보 처리방침을 읽으세요. 모드 선택은 영구적이에요. 조회 가맹점 또는 운영자 모드 을 제출 전에 확인하세요.
다음에서: 설정 → 계정에서 2단계 인증을 켜세요. 다음에서는: 설정 → 시스템지역 통화·시간대 기본값과 운영 도메인을 확인하세요. 지역 기본값은 새 항목에만 적용되며 기존 프로젝트를 바꾸지 않아요.
첫 적격 설치는 일회성으로 다음을 받아요: US$10 환영 크레딧 등록·연결 후 자동 지급돼요. 다음을 확인하세요: 설정 → 수수료 의 청구 상태. 처리 크레딧 작동 방식 →
6. 결제 수신 전 확인하기
열기 설정 → 체인 연결노드 상태뿐 아니라 스캐너 준비 상태를 확인하세요. 사용할 체인에는 독립적인 대체 제공자를 두세요.
핫월렛 서버로서 보호하세요. 관리자 접근을 제한하고 보안 업데이트를 설치하며 비공개 백업을 VPS 밖에 보관하세요. 지갑 내보내기에는 비밀 정보가 있으므로 웹사이트나 지원 티켓에 올리지 마세요. 서버 보안 체크리스트 →
이제 프로젝트와 스토어를 만들 준비가 됐어요. 고객에게 안내하기 전에 각 결제 수단으로 소액 실제 테스트를 하세요.