본문 바로가기
ColliePWA

01/Documentation

5분 안에 설치하기

단계별 권장 설정: 컴퓨터에 Tailscale, Herdr, Collie를 설치한 다음, 홈 화면에 Collie가 있는 페어링된 휴대전화를 사용합니다

이 가이드는 휴대전화에 Collie를 설정합니다. 컴퓨터에 세 가지 도구를 설치하고 Collie를 시작한 다음 휴대전화를 페어링하십시오.

권장 설정을 사용합니다: 전면 도어 역할을 하는 Tailscale, 멀티플렉서 역할을 하는 Herdr, 그리고 설치 스크립트입니다. 다른 설정은 설치을(를) 참조하십시오.

참고. Collie는 설계상 시스템에 대한 원격 셸 액세스를 제공합니다. 설치하기 전에 보안을(를) 읽으십시오.

준비물

  • Linux 또는 macOS 컴퓨터(호스트). Mac에는 Apple Silicon 및 macOS 13 이상이 필요합니다.
  • iPhone 또는 Android 휴대폰.
  • Tailscale 계정.

1. Tailscale 설치

Tailscale은 호스트와 휴대전화를 하나의 사설 네트워크인 tailnet으로 연결합니다. Collie는 해당 네트워크에서만 접근할 수 있습니다.

Linux 호스트의 경우:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --operator=$USER

--operator=$USER을(를) 사용하면 사용자가 tailscale serve을(를) 실행할 수 있으며, 이는 4단계에서 Collie에 필요합니다.

Mac의 경우, tailscale.com/download에서 Tailscale을 설치하고 로그인하십시오. 앱 설정에서 tailscale 명령을 설치하십시오. Collie가 이를 호출합니다.

다음으로 tailnet과 휴대전화를 설정합니다:

  1. 관리 콘솔을(를) 열고 Enable HTTPS을(를) 선택하십시오. Collie에 필요합니다.
  2. 휴대전화에 Tailscale 앱을 설치하십시오. 동일한 계정으로 로그인하십시오.

2. Herdr 설치

Herdr는 연결이 끊어져도 호스트에서 터미널 창과 코딩 에이전트를 계속 실행합니다. Collie는 휴대전화에 해당 창을 표시합니다.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr

Herdr가 창을 엽니다. 해당 창에서 에이전트(예: claude)를 시작하십시오. Herdr를 계속 실행해 두십시오.

3. Collie 설치

호스트에서 두 번째 터미널을 열고 설치 스크립트를 실행하십시오:

curl -fsSL https://colliepwa.dev/install.sh | sh

스크립트는 collie 바이너리를 ~/.local/bin에 저장합니다. sudo은(는) 사용하지 않습니다. 셸에서 collie을(를) 찾을 수 없는 경우 PATH에 ~/.local/bin을(를) 추가하십시오. 자세한 내용은 독립형에서 다룹니다.

4. Collie 시작

COLLIE_MUX=herdr collie start

start은(는) Collie를 백그라운드에서 실행하고 tailscale serve을(를) 사용하여 tailnet에 노출합니다. 멀티플렉서로 herdr을(를) 저장합니다. 다음 실행부터는 collie start만 입력하면 됩니다. 준비가 되면 Collie가 실행 중입니다을(를) 출력하고 tailnet 줄에 URL(예: https://myhost.tail1234.ts.net)을 표시합니다.

SSH로 접속한 원격 Linux 호스트에서 로그아웃 후에도 Collie가 계속 실행되도록 유지하려면 다음을 수행하십시오:

loginctl enable-linger $USER

5. 휴대전화에 Collie를 추가하고 페어링하기

collie qr
  1. 휴대폰 카메라로 QR 코드를 스캔하여 브라우저에서 Collie를 엽니다.
  2. 앱처럼 전체 화면으로 열리도록 Collie를 홈 화면에 추가합니다. - iPhone: Safari에서 공유을 탭하고, 홈 화면에 추가을 탭한 다음, 추가을 탭합니다. - Android: Chrome에서 Collie Settings을 열고 상단 카드에서 설치을 탭합니다.
  3. 새 아이콘에서 Collie를 엽니다.
  4. 호스트에서 collie pair을 실행하여 10분 동안 유효한 8자리 코드를 출력합니다.
  5. Collie에서 설정 → 시스템 → 페어링된 기기을 엽니다.
  6. 코드와 이름(예: my phone)을 입력하고 이 기기 페어링을 탭합니다.

브라우저 탭이 아닌 홈 화면 앱 내에서 페어링하십시오. iPhone의 경우 홈 화면 앱은 Safari와 분리된 자체 저장소를 유지합니다. Safari에서 수행한 페어링은 이어지지 않습니다.

기기가 하나 페어링되면 페어링된 기기만 창에 입력할 수 있습니다. 그 전까지는 tailnet의 모든 기기에서 입력할 수 있습니다. start 직후에 페어링하십시오. 다른 사람과 공유하는 tailnet에서는 COLLIE_TRUSTED_USER도 설정하십시오 (설정).

대시보드에 Herdr 창 목록이 표시됩니다. 입력을 기다리는 창이 먼저 나타납니다. 창을 탭하여 출력을 확인하고 응답합니다.

다음 단계

GitHub에서 이 페이지 수정하기

The rest of the documentation