Trade 설치(처음이라면 여기서 시작)
CPU 2코어, 메모리 2GB 이상의 클라우드 서버면 충분합니다. 안내를 따라 하시면 명령어 한 줄로 설치됩니다.
영상을 보며 설치하기
서버 구매ZML Trade는 사용자의 클라우드 서버에 설치되며, 거래소 API 키는 그곳에만 저장됩니다. 요구 사양은 낮습니다. 입문형 클라우드 서버로 충분하며, 월 약 11 USD부터입니다.
ZML Trade는 직접 마련한 클라우드 서버에 설치되며, 거래소 API 키는 해당 서버에만 저장됩니다. 기술 지식은 필요 없습니다. 몇 번 클릭하고 명령어 하나를 복사해 붙여넣으면 설치가 끝납니다.
최소 사양
2 CPU 코어, 2 GB 메모리, 20 GB 디스크, x86_64 아키텍처의 Linux(Ubuntu 24.04 LTS 권장).
대역폭은 트래픽 종량제로 선택하세요.
리전은 일본(도쿄)을 선택하세요.
엔트리급 사양이면 충분하며, 월 약 11 USD부터입니다(2026-10 공식 가격 기준이며, 최종 가격은 주문 페이지를 따릅니다). ZML Trade 자체는 무료입니다.
먼저 Docker를 설치하거나 도메인과 인증서를 준비하실 필요가 없습니다. 설치 프로그램이 처리합니다.
리전은 일본(도쿄)을 선택하세요. 다른 리전의 서버에서는 거래소가 API 접속을 거부할 수 있습니다. 리전은 구매 후 변경할 수 없습니다.
따라 하기: 하나 선택
아직 서버가 없으시다면 한 곳을 골라 따라 하세요. 서버 구매부터 Trade를 여는 단계까지 안내합니다:
Alibaba Cloud ECS에 설치: 월 약 11 USD부터.
AWS EC2에 설치: 월 약 25 USD부터.
두 곳 모두 콘솔에서 언제든지 서버 사양을 업그레이드할 수 있습니다. 콤보가 늘어나면 Trade를 다시 설치하지 않고 바로 업그레이드하세요.
다른 클라우드 서버 사용하기
위의 최소 사양을 충족하는 서버라면 어디든 설치할 수 있으며, 어떤 업체와 어떤 요금제를 선택할지는 직접 정하시면 됩니다. 구매 전과 설치 전에 다음 사항을 확인하세요.
아키텍처는 x86(x86_64)을 선택하고, ARM 기종은 선택하지 마세요.
시스템 이미지는 깨끗한 Linux(Ubuntu 24.04 LTS 권장)를 선택하고, BT 패널이나 WordPress 같은 앱이 포함된 이미지는 선택하지 마세요. 이런 이미지에 포함된 프로그램이 Trade에서 필요로 하는 443번 포트를 사용합니다.
대역폭은 트래픽 사용량에 따라 과금되는 방식을 선택하세요. 대역폭이 매우 작거나 피크 시간대에 대역폭이 제한되는 요금제에서는 시세가 지연됩니다.
리전은 일본(도쿄)을 선택하세요.
클라우드 콘솔의 보안 그룹(방화벽)에서 TCP 443 인바운드를 허용하세요. Trade는 이 포트 하나만 사용합니다.
root로 로그인할 수 있거나, 로그인하는 사용자가 sudo를 사용할 수 있어야 합니다.
거래소 API 키의 IP 허용 목록에 이 서버의 공인 IP를 등록해야 합니다. 서버의 공인 IP가 바뀔 수 있다면, 설치하기 전에 고정 공인 IP(탄력적 IP)를 연결하세요.
준비가 끝나면 서버에 로그인하여 아래 단계에 따라 설치 명령을 실행하세요.
설치 명령 실행
이 명령을 복사하세요(공식 웹사이트의 Trade 설치 페이지에 "설치 명령 복사" 버튼이 있습니다).
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh명령줄에서 마우스 오른쪽 버튼을 클릭해 붙여넣기를 선택하거나 Ctrl+V(Mac에서는 ⌘V)를 누른 다음 엔터 키를 누르세요.
화면에 16개 언어가 표시됩니다. 사용하려는 언어 앞의 번호를 입력하고 엔터 키를 누르세요. 이후 설치 프로그램과 Trade의 웹 페이지가 해당 언어로 표시됩니다.
나머지는 자동으로 진행되며 더 이상 아무것도 묻지 않습니다. 서버 확인, Docker 설치, ZML Trade 다운로드, 시작, HTTPS 인증서 요청의 다섯 단계가 차례로 체크 표시됩니다. 현재 단계 앞의 기호가 계속 돌고 초 단위 시간이 계속 늘어나므로 작동 중임을 알 수 있습니다.
"설치 완료, 소요 시간 …"이 표시되면 설치가 끝난 것입니다. 보통 1~2분 걸립니다.
Trade를 설치할 수 없는 경우(예: 디스크 공간 부족, 또는 다른 프로그램이 443번 포트를 사용 중인 경우) 설치 프로그램이 원인을 알려 주고 중단됩니다. 안내에 따라 문제를 해결한 뒤 같은 명령어를 다시 실행하십시오. 이미 완료된 단계는 건너뜁니다.
Trade를 열고 관리자 계정 만들기
마지막에 터미널에 "브라우저에서 이 링크를 여세요(한 줄 전체를 복사)"라고 표시됩니다. 그 아래 단독으로 나오는 한 줄이 Trade 주소입니다. 마우스로
https부터 주소 끝까지 드래그해 선택하고, 마우스 오른쪽 버튼을 클릭해 복사를 선택한 다음 브라우저 주소 표시줄에 붙여넣으세요. 명령줄에서는 Ctrl+C로 복사되지 않습니다. 주소가 길어 두 줄로 나뉘면 두 줄 모두 선택하세요.페이지에 관리자 계정 설정이(가) 표시됩니다. 사용자 이름과 비밀번호를 입력하고 약관에 동의한 뒤 생성 후 계속을(를) 선택하세요. 이제 Trade에 들어왔습니다.
이 링크에는 관리자 계정을 만들기 위한 일회용 코드가 들어 있습니다. 본인만 사용하고 다른 사람과 공유하지 마세요. 계정은 사용자의 서버에만 저장되므로 비밀번호를 안전하게 보관하세요. 잊어버렸다면 서버에서 curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --reset-admin을(를) 실행해 새로 설정할 수 있습니다.
링크를 잃어버렸다면 서버에 다시 로그인하여 명령줄을 열고, 이 명령을 붙여넣은 뒤 엔터 키를 누르면 링크가 다시 출력됩니다.
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --setup-link브라우저에서 인증서를 신뢰할 수 없다고 경고하는 경우
설치 프로그램은 서버의 공인 IP에 대해 신뢰할 수 있는 인증서를 자동으로 요청합니다. 인증서를 받으면 브라우저에서 Trade가 바로 열립니다. 받지 못하는 경우(서버가 NAT 뒤에 있거나 인터넷에서 443번 포트에 접근할 수 없는 경우)에는 자체 서명 인증서를 사용하며, 터미널에 TLS SHA-256 지문 줄이 추가로 출력됩니다. 확인하려면 브라우저 주소 표시줄 왼쪽의 아이콘을 클릭하고 인증서 세부 정보를 연 다음, SHA-256 지문을 찾아 터미널에 출력된 지문과 한 글자씩 비교하십시오. 두 지문이 일치하는 경우에만 계속 진행하고, 일치하지 않으면 중단하십시오.
포트를 연 후 다음 명령을 실행하여 신뢰할 수 있는 인증서를 다시 요청하십시오:
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --enable-ip-cert설치 후
거래소 연결: 거래소 API 키를 추가합니다. 각 키의 IP 허용 목록에는 Trade에 표시된 출구 IP, 즉 이 서버의 공용 IP를 입력합니다.
Z Market Lab과 페어링: Z Market Lab에서 마음에 드는 기회를 클릭 한 번으로 이 Trade에 보낼 수 있습니다.
여러 공용 IP 사용: 콤보를 많이 운용할 때는 서버에 공용 IP를 더 추가하세요. Trade가 자동으로 인식하여 요청을 분산합니다.
업데이트
Trade는 서명된 릴리스만 설치합니다. 새로 설치한 경우 기본적으로 새 버전이 나오면 곧바로 자동으로 업데이트됩니다. Trade에서 수동 업데이트로 전환해 원하는 시간에 업데이트할 수 있지만, 새 버전은 도착한 날로부터 7일 이내에 설치됩니다. ZML이 필수로 표시한 긴급 수정은 기다리지 않고 설치됩니다. 전환 전에 데이터베이스를 백업하며, 새 버전이 시작되기 전에 오류가 발생하면 현재 버전이 계속 실행됩니다. 업데이트를 위해 포지션 종료가 필요하지 않으며, 업데이트 때문에 포지션을 자동으로 종료하지도 않습니다. 업데이트가 진행되는 1~2분 동안 Trade는 거래를 일시 중지하며, 이미 거래소에 걸려 있는 주문은 그동안에도 체결될 수 있습니다.
나만의 도메인 사용하기 (고급)
자체 도메인과 신뢰할 수 있는 인증서로 Trade에 접속하려면 설치 디렉터리의 Caddyfile을 수정합니다. 업데이트는 이 파일을 덮어쓰지 않습니다. 도메인 사이트를 추가하기 전에 기본 자체 서명 인증서 사이트를 먼저 옮겨 두세요. 그렇지 않으면 도메인으로 접속해도 여전히 자체 서명 인증서가 사용됩니다.