명령어 레퍼런스
찾아보는 장입니다. 순서대로 읽지 않아도 됩니다.
모든 명령은 어느 폴더에서든 실행할 수 있습니다.
한눈에
| 명령 | 하는 일 |
|---|---|
hyperteams | 이 터미널에 붙여서 켜기. Ctrl-C로 종료 |
hyperteams start --background | 창을 닫아도 계속 돌게 켜기 |
hyperteams stop | 이 설치본이 띄운 것을 전부 내리기 |
hyperteams restart | 멈추고 백그라운드로 다시 띄우기 |
hyperteams setup | 접속 주소와 비밀번호 다시 정하기 |
hyperteams upgrade | 최신 버전으로 올리기 |
hyperteams upgrade --check | 새 버전이 있는지만 확인 |
hyperteams uninstall | 설치 폴더와 명령 정리 |
켜기
이 터미널에 붙어서 돕니다. 창을 닫으면 같이 꺼집니다.
주소를 확인하고 나면 프롬프트가 돌아옵니다. 창을 닫아도 계속 돕니다.
| 로그 | |
|---|---|
| 현재 실행분 | logs/server.log |
| 직전 실행분 | logs/server.log.prev (한 세대 보관) |
부팅 시 자동 실행하려면 이 명령을 시스템 시작 항목에 등록하세요 — macOS는 launchd, Linux는 systemd, Windows는 작업 스케줄러입니다.
끄기
보통은 띄운 터미널에서 Ctrl-C입니다. 그 터미널이 없어졌다면(창을 닫았거나 접속이 끊겼거나):
이 설치본이 띄운 것을 전부 내립니다 — 앱도, 터널도, 열어둔 터미널도.
진행 중인 작업이 있으면 알려주고 한 번 물어봅니다. 다시 시작해도 그 작업은 이어지지 않기 때문입니다.
다시 시작
멈추고 백그라운드로 다시 띄웁니다 — 이 창을 붙잡지 않습니다. 꺼져 있었다면 그냥 켭니다.
이 창에 붙여서 띄우고 싶으면:
언제 쓰나: 터널을 연결한 뒤, 설정을 바꾼 뒤.
설정 바꾸기
접속 주소와 비밀번호를 다시 정합니다. 비밀번호를 잊었을 때도 이걸 씁니다.
업데이트
이 컴퓨터에 맞는 최신 빌드를 받아 프로그램 파일만 제자리에서 바꿉니다.
내 것들은 손대지 않습니다:
애초에 빌드에 들어 있지 않기 때문입니다. 실행 중이면 먼저 멈추므로, 끝난 뒤
hyperteams로 다시 시작하세요.
바꾸지 않고 확인만:
재설치는 업데이트 방법이 아닙니다. 설치 스크립트를 다시 돌리면 기록과 설정이 어떻게 될지 보장되지 않습니다.
다른 포트로 실행
기본 번호가 이미 쓰이고 있을 때 씁니다. 매번 지정하기 번거로우면
hyperteams setup으로 기본값을 바꾸세요.
삭제
설치 폴더와 hyperteams 명령을 함께 정리합니다.
저장된 기록도 같이 지워지므로 지우기 전에 한 번 더 물어봅니다.
남는 것:
상황별 찾아보기
| 이럴 때 | 이 명령 |
|---|---|
| 터미널을 계속 쓰고 싶다 | hyperteams start --background |
| 창을 닫았는데 끄고 싶다 | hyperteams stop |
| 설정을 바꿔서 적용해야 한다 | hyperteams restart |
| 비밀번호를 잊었다 | hyperteams setup |
| 새 버전이 있는지 궁금하다 | hyperteams upgrade --check |
| 포트가 충돌한다 | PORT=9000 hyperteams |
command not found | 새 터미널 창을 열기 |
문제가 생겼을 때는 → 문제 해결