본문으로 건너뛰기

Trade 설치(처음이라면 여기서 시작)

CPU 2코어, 메모리 2GB 이상의 클라우드 서버면 충분합니다. 안내를 따라 하시면 명령어 한 줄로 설치됩니다.

영상을 보며 설치하기

알리바바 클라우드AWS

서버 구매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를 여는 단계까지 안내합니다:

두 곳 모두 콘솔에서 언제든지 서버 사양을 업그레이드할 수 있습니다. 콤보가 늘어나면 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)를 연결하세요.

준비가 끝나면 서버에 로그인하여 아래 단계에 따라 설치 명령을 실행하세요.

설치 명령 실행

  1. 이 명령을 복사하세요(공식 웹사이트의 Trade 설치 페이지에 "설치 명령 복사" 버튼이 있습니다).

bash
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh
  1. 명령줄에서 마우스 오른쪽 버튼을 클릭해 붙여넣기를 선택하거나 Ctrl+V(Mac에서는 ⌘V)를 누른 다음 엔터 키를 누르세요.

  2. 화면에 16개 언어가 표시됩니다. 사용하려는 언어 앞의 번호를 입력하고 엔터 키를 누르세요. 이후 설치 프로그램과 Trade의 웹 페이지가 해당 언어로 표시됩니다.

  3. 나머지는 자동으로 진행되며 더 이상 아무것도 묻지 않습니다. 서버 확인, Docker 설치, ZML Trade 다운로드, 시작, HTTPS 인증서 요청의 다섯 단계가 차례로 체크 표시됩니다. 현재 단계 앞의 기호가 계속 돌고 초 단위 시간이 계속 늘어나므로 작동 중임을 알 수 있습니다.

  4. "설치 완료, 소요 시간 …"이 표시되면 설치가 끝난 것입니다. 보통 1~2분 걸립니다.

Trade를 설치할 수 없는 경우(예: 디스크 공간 부족, 또는 다른 프로그램이 443번 포트를 사용 중인 경우) 설치 프로그램이 원인을 알려 주고 중단됩니다. 안내에 따라 문제를 해결한 뒤 같은 명령어를 다시 실행하십시오. 이미 완료된 단계는 건너뜁니다.

Trade를 열고 관리자 계정 만들기

  1. 마지막에 터미널에 "브라우저에서 이 링크를 여세요(한 줄 전체를 복사)"라고 표시됩니다. 그 아래 단독으로 나오는 한 줄이 Trade 주소입니다. 마우스로 https부터 주소 끝까지 드래그해 선택하고, 마우스 오른쪽 버튼을 클릭해 복사를 선택한 다음 브라우저 주소 표시줄에 붙여넣으세요. 명령줄에서는 Ctrl+C로 복사되지 않습니다. 주소가 길어 두 줄로 나뉘면 두 줄 모두 선택하세요.

  2. 페이지에 관리자 계정 설정이(가) 표시됩니다. 사용자 이름과 비밀번호를 입력하고 약관에 동의한 뒤 생성 후 계속을(를) 선택하세요. 이제 Trade에 들어왔습니다.

이 링크에는 관리자 계정을 만들기 위한 일회용 코드가 들어 있습니다. 본인만 사용하고 다른 사람과 공유하지 마세요. 계정은 사용자의 서버에만 저장되므로 비밀번호를 안전하게 보관하세요. 잊어버렸다면 서버에서 curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --reset-admin을(를) 실행해 새로 설정할 수 있습니다.

링크를 잃어버렸다면 서버에 다시 로그인하여 명령줄을 열고, 이 명령을 붙여넣은 뒤 엔터 키를 누르면 링크가 다시 출력됩니다.

bash
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 지문을 찾아 터미널에 출력된 지문과 한 글자씩 비교하십시오. 두 지문이 일치하는 경우에만 계속 진행하고, 일치하지 않으면 중단하십시오.

포트를 연 후 다음 명령을 실행하여 신뢰할 수 있는 인증서를 다시 요청하십시오:

bash
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --enable-ip-cert

설치 후

  1. 거래소 연결: 거래소 API 키를 추가합니다. 각 키의 IP 허용 목록에는 Trade에 표시된 출구 IP, 즉 이 서버의 공용 IP를 입력합니다.

  2. Z Market Lab과 페어링: Z Market Lab에서 마음에 드는 기회를 클릭 한 번으로 이 Trade에 보낼 수 있습니다.

  3. 여러 공용 IP 사용: 콤보를 많이 운용할 때는 서버에 공용 IP를 더 추가하세요. Trade가 자동으로 인식하여 요청을 분산합니다.

업데이트

Trade는 서명된 릴리스만 설치합니다. 새로 설치한 경우 기본적으로 새 버전이 나오면 곧바로 자동으로 업데이트됩니다. Trade에서 수동 업데이트로 전환해 원하는 시간에 업데이트할 수 있지만, 새 버전은 도착한 날로부터 7일 이내에 설치됩니다. ZML이 필수로 표시한 긴급 수정은 기다리지 않고 설치됩니다. 전환 전에 데이터베이스를 백업하며, 새 버전이 시작되기 전에 오류가 발생하면 현재 버전이 계속 실행됩니다. 업데이트를 위해 포지션 종료가 필요하지 않으며, 업데이트 때문에 포지션을 자동으로 종료하지도 않습니다. 업데이트가 진행되는 1~2분 동안 Trade는 거래를 일시 중지하며, 이미 거래소에 걸려 있는 주문은 그동안에도 체결될 수 있습니다.

나만의 도메인 사용하기 (고급)

자체 도메인과 신뢰할 수 있는 인증서로 Trade에 접속하려면 설치 디렉터리의 Caddyfile을 수정합니다. 업데이트는 이 파일을 덮어쓰지 않습니다. 도메인 사이트를 추가하기 전에 기본 자체 서명 인증서 사이트를 먼저 옮겨 두세요. 그렇지 않으면 도메인으로 접속해도 여전히 자체 서명 인증서가 사용됩니다.

이 문서가 도움이 되었나요?

ZML Trade를 무료로 사용하세요

구독이 필요 없습니다. 명령어 하나로 보유하신 서버에 설치하거나, 먼저 온라인 데모를 체험해 보세요.