내 PC에서 실행하기

HandStack 배포본으로 서버를 실행합니다. 이 단계의 완료 기준은 브라우저에서 관리 화면에 접속하는 것입니다. 도구 설치와 다운로드 시간은 PC와 네트워크에 따라 달라집니다.

준비 확인

필수 프로그램 안내에서 .NET SDK, Node.js·npm, gulp-cli, curl을 확인하세요. install.bat과 install.sh는 이 도구를 이용해 HandStack의 패키지와 화면 자원을 구성합니다. 기본 도구 설치와는 다른 단계입니다.

기존 프로젝트와 분리된 실습 디렉터리를 사용하세요. 여기서는 압축 안의 handstack 디렉터리를 Windows의 C:/projects/handstack, Linux·macOS의 사용자 디렉터리 아래 projects/handstack에 둡니다.

HandStack 릴리스에서 OS와 CPU에 맞는 파일을 내려받으세요. 파일명에 win, linux, osx와 x64, arm64 등의 대상이 표시됩니다. 실제 제공되는 파일과 요구사항은 해당 릴리스 설명을 따릅니다.

압축을 풀고 아래 항목이 있는 디렉터리를 찾으세요. 이 문서에서는 그 위치를 HandStack 기본 경로라고 부릅니다.

handstack/
├─ app/       # ack 실행 파일과 설정
├─ modules/   # 서버 모듈과 화면 자원
├─ install.bat
└─ install.sh

운영체제와 배포본의 아키텍처를 맞추는 방법은 지원 환경 확인을 참고하세요.

PowerShell에서 HandStack 기본 경로로 이동해 구성 스크립트를 실행합니다.

Set-Location C:/projects/handstack
.\install.bat

완료 메시지를 확인한 뒤 서버를 실행하세요. 오류가 나면 먼저 누락된 도구나 다운로드 실패를 해결합니다.

Set-Location C:/projects/handstack/app
.\ack.exe

일반 사용자 터미널에서 구성합니다. 압축을 다른 위치에 풀었다면 첫 경로를 바꾸세요.

cd ~/projects/handstack
bash ./install.sh

완료 후 서버를 실행합니다.

cd ~/projects/handstack/app
chmod +x ack
./ack

배포본에 ack.dll이 있으면 dotnet ack.dll로도 실행할 수 있습니다.

일반 사용자 터미널에서 구성합니다. Apple Silicon과 Intel용 배포본·.NET의 아키텍처가 맞는지 먼저 확인하세요.

cd ~/projects/handstack
bash ./install.sh

완료 후 서버를 실행합니다.

cd ~/projects/handstack/app
chmod +x ack
./ack

배포본에 ack.dll이 있으면 dotnet ack.dll로도 실행할 수 있습니다.

서버 터미널을 열어 둔 채 호스트 기동 확인 페이지에 접속하세요. 기본 포트는 8421이며 설정을 바꿨다면 실행 로그에 표시된 주소를 사용합니다.

기동 확인 페이지가 응답하고 서버에 기동 오류가 없으면 이 단계가 완료됩니다. 업무 화면은 /view/{ProjectID}/{화면ID}.html 경로로 엽니다.

접속되지 않으면 실행·화면·거래 문제 해결을 확인하세요.