Hostel CLI 설치 및 연결
hostel 바이너리는 사람, 에이전트, 서버, 룸 머신 모두 동일합니다. 이 기술은 사람의 컴퓨터에 설치하고 해당 컴퓨터를 서버에 연결합니다. 서버 머신의 경우 hostel-server-setup을 참조하세요. 룸 머신의 경우 hostel-rooms을 참조하세요.
macOS 및 Linux
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
이 스크립트는 최신 GitHub 릴리스를 다운로드하고, 릴리스의 SHA256SUMS와 대조하여 파일을 확인한 후 ~/.local/bin에 hostel을 설치합니다.
옵션 (sh -s -- 뒤에 추가):
| 옵션 | 효과 |
|---|---|
--dir DIR | 바이너리를 DIR에 설치합니다 (기본값: ~/.local/bin). |
--version vX.Y.Z | 이 릴리스를 설치합니다 (기본값: 최신). |
--server DIR | 룸 바이너리를 DIR/helpers에, 플랫폼 스크립트를 DIR/platforms에 함께 설치합니다. 서버 머신 전용입니다. |
예시:
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --dir /usr/local/bin
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --version v0.1.0
스크립트가 note: ... is not on your PATH라고 출력하면, 셸 프로필에 해당 디렉토리를 PATH에 추가하세요. 예:
export PATH="$HOME/.local/bin:$PATH"
지원: amd64 또는 arm64 아키텍처의 macOS 및 Linux. 환경 변수 HOSTEL_INSTALL_URL은 다운로드 URL(미러)을 대체합니다.
Windows
PowerShell에서 (관리자 권한 불필요):
irm https://raw.githubusercontent.com/csansoon/hostel/main/install.ps1 | iex
이 스크립트는 hostel.exe를 %LOCALAPPDATA%\Programs\hostel에 설치하고, SHA256SUMS와 대조하여 확인한 후 해당 디렉토리를 사용자 PATH에 추가합니다. 첫 설치 후 새 터미널을 여십시오. $env:HOSTEL_VERSION(예: v0.1.0)으로 릴리스를 선택하고, $env:HOSTEL_INSTALL_URL로 미러를 설정합니다.
참고: install.ps1은 새 스크립트입니다. 실패하면 GitHub 릴리스에서 hostel-windows-amd64.exe(또는 -arm64.exe)를 다운로드하여 hostel.exe로 이름을 바꾸고 PATH에 있는 디렉토리에 넣으세요.
설치 확인
hostel --version
hostel help
컴퓨터를 서버에 연결
서버 관리자가 초대 코드(hostel1-...)를 제공합니다. 이 코드는 한 번, 24시간 동안만 유효합니다. 관리자가 초대 코드를 만드는 방법은 hostel-users를 참조하세요.
hostel connect hostel1-...
hostel connect hostel1-... --name "홍길동"
- 기본 이름은
git config user.name에서 가져옵니다. 터미널에서connect는 이름을 묻습니다. - 출력에는 서버, 고정 TLS 키(자체 인증서를 사용하는 서버의 경우), 역할, 컴퓨터 이름이 표시됩니다.
- 연결 정보는
~/.config/hostel/config.toml(모드 0600)에 저장됩니다. Windows에서는%USERPROFILE%아래 동일한 위치에 저장됩니다. - 각 컴퓨터는 최대 하나의 연결을 가집니다. 이미 연결이 있는 경우
connect는 교체하기 전에 확인합니다.--yes는 확인 없이 교체합니다. - 이 컴퓨터의 에이전트는 동일한 연결을 사용합니다. 별도의 연결이 필요하지 않습니다.
확인:
hostel status
연결 해제 (서버가 이 컴퓨터의 토큰을 삭제합니다):
hostel disconnect
테스트 및 CI를 위해 환경 변수 HOSTEL_SERVER, HOSTEL_TOKEN, HOSTEL_SERVER_KEY가 파일을 재정의합니다.
Hostel 앱
터미널에서 인수 없이 hostel을 실행하면 전체 화면 앱이 열립니다:
- 연결되지 않음: 체크인 (초대 코드와 이름 입력) 또는 나가기.
- 로비: 플랫폼, 사용 가능한 머신, 대기열, 대기 시간.
- 룸: 머신, 상태, 사용자.
- 프론트 데스크: 서버와 사용자; 게스트 초대 (관리자), 다른 컴퓨터 추가 (멤버), 게스트 목록, 룸 추가 (관리자), 체크아웃 (연결 해제).
키: 1 2 3은 로비, 룸, 프론트 데스크로 이동; ?는 모든 키 목록 표시; q는 종료. NO_COLOR=1은 색상을 끕니다. 터미널이 없는 경우(에이전트, 파이프) hostel은 대신 도움말을 출력합니다. 에이전트는 hostel status(일반 텍스트)를 사용합니다.
업데이트
동일한 설치 명령을 다시 실행하세요. 바이너리가 교체됩니다.
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
hostel --version
Windows에서는 irm ... | iex 라인을 다시 실행하세요. 연결은 유지됩니다.
서버 머신의 경우 업데이트 후 서비스를 다시 시작하세요 (hostel-server-setup, "업데이트" 섹션 참조).
다음 단계
- 룸 사용:
hostel-use. - 문제 발생:
hostel-troubleshoot.