선택 가능한 설치 방식

Docker로 Wholly Crypto를.

같은 판매자 소프트웨어를 컨테이너에서 실행해요. 기본 설치 프로그램이 잘 맞는다면 그대로 사용하세요.

시작하기 전에.

새 환경을 사용하세요: Linux amd64 / x86-64 VPS 에 root 권한, Python 3.9+, Git, Docker Engine 및 Compose 플러그인이 필요해요. 가벼운 사용은 2 vCPU, RAM 4 GB, SSD 30 GB부터 시작하세요. 기록, 이미지, 백업 공간도 남겨 두세요.

다음 포트를: 80 및 443 사용 중이지 않게 하고 양쪽 방화벽에서 열어 두세요. 판매자, 결제, API DNS 레코드를 VPS로 연결하세요. Cloudflare에서는 다음을 사용하세요: 설치 중에는 DNS 전용. HTTPS 검증이 끝난 뒤 프록시를 켜세요.

Docker 선택 또는 해당 기본 설치 프로그램. Docker 설치는 기존 설치를 옮기거나 다른 웹 서버를 중지하지 않아요.

명령 세 개로 설치하세요.

git clone https://github.com/whollycrypto-com/whollycrypto-docker.git /root/whollycrypto-docker
cd /root/whollycrypto-docker
./whollycrypto-docker setup

도메인, VPS 공인 IP, 갱신 이메일, 법정화폐, Basic Auth 로그인을 선택하세요. 기본값: merchant.example.com, pay.example.com 및 api.example.com. 다른 하위 도메인 이름을 선택해도 돼요.

설치는 런타임 이미지를 만들고 서명된 판매자 다운로드를 검증하며 PostgreSQL 18을 시작하고 HTTPS 인증서를 발급해요. GitHub는 대체 다운로드 경로예요. 판매자 소스, Rust 컴파일러, 블록체인 노드는 필요 없어요.

다음이 나올 때까지 기다리세요: Ready: https://… 가 로그에 표시되면 해당 주소를 열고 Basic Auth로 로그인해 관리자 계정을 만드세요. 설치가 멈추면 표시된 문제를 해결한 뒤 다음을 실행하세요: ./whollycrypto-docker resume. 기존 지갑 키는 유지돼요.

저장소 및 전체 설정 가이드 ↗

설치 환경을 관리하세요.

다음 위치에서 실행하세요: /root/whollycrypto-docker. 콘솔, 결제 화면, API, 처리 크레딧 규칙은 기본 설치와 같아요.

명령	용도
`./whollycrypto-docker status`	컨테이너 상태
`./whollycrypto-docker logs`	설치 진행 및 작업자 로그
`./whollycrypto-docker doctor`	읽기 전용 점검
`./whollycrypto-docker update`	서명된 판매자 업데이트
`./whollycrypto-docker cli htaccess`	Basic Auth 변경
`./whollycrypto-docker cli ssl`	HTTPS 점검 또는 복구

설정 → 시스템 에서도 판매자 업데이트를 설치할 수 있어요. Docker 이미지를 다시 만들어도 설치된 판매자 소프트웨어가 바뀌거나 업데이트 검사를 우회하지 않아요. 컨테이너 의존성은 저장소의 런타임 업데이트 안내에 따라 별도로 업데이트하세요.

VPS 밖에 사본을 보관하세요.

./whollycrypto-docker backup

전체 백업 중에는 결제 화면이 잠시 멈춰요. 데이터베이스, 판매자 파일, 지갑 암호화 키, Nginx, 인증서, 해당 설치 비밀 정보를 저장하고 검증해요. 복사할 대상: 타임스탬프가 있는 전체 백업 디렉터리 를 안전한 오프라인 저장소에 복사하세요.

백업에는 암호화되지 않은 개인 키와 인증 정보가 포함돼요. Git이나 공개 폴더에 절대 넣지 마세요. 콘솔에서 프로젝트 지갑 백업도 내보내세요. 연결된 Lightning 지갑에는 별도의 복구 절차가 필요해요.

절대 사용하지 마세요: docker compose down -v 를 오류 해결에 사용하지 마세요. 영구 볼륨을 삭제해 지갑 키와 결제 내역이 사라질 수 있어요. 다음을 사용하세요: docker compose stop 로 데이터를 지우지 않고 중지할 수 있어요. 복원 전에 다음을 따르세요: 복구 가이드 를 먼저 확인하세요.

작은 구성, 분리된 데이터.

Nginx가 포함된 판매자 컨테이너와 PostgreSQL, 두 컨테이너를 사용해요. 데이터는 이름 있는 볼륨에 있어 컨테이너를 교체해도 유지돼요. 데이터베이스는 비공개 Unix 소켓을 사용하며 5432와 8080 포트는 공개하지 않아요. 특권 모드, 호스트 네트워크, 호스트 Docker 소켓은 필요 없어요.

Docker는 기본 설치의 systemd 샌드박스가 아니라 컨테이너 격리를 사용해요. root와 Docker 관리자는 여전히 키에 접근할 수 있어요. Basic Auth와 적절한 도메인/API IP 제한을 켜 두세요. Docker 포트 공개가 UFW 규칙을 우회할 수 있으니 제공업체 방화벽과 다음을 확인하세요: Docker 방화벽 안내.

초기 Docker 설치는 자체 Nginx를 사용하는 Linux amd64용이에요. ARM64, Docker Desktop, rootless Docker, 추가 리버스 프록시는 아직 지원 구성이 아니에요.