설치

Herdr는 Linux, macOS 및 Windows용 안정적인 채널 바이너리를 게시합니다. Windows는 일반적으로 사용 가능하며 문서화된 플랫폼별 제한 사항과 지속적인 수정 사항이 포함되어 있습니다.

Linux 또는 macOS에서는 다음을 실행합니다.

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

Windows에서는 다음을 실행합니다.

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

엔드포인트 보안이 파일 없는 PowerShell 명령을 차단하는 경우 명령 프롬프트를 열고 다음을 실행합니다.

curl.exe -fsSLo install.cmd https://herdr.dev/install.cmd && install.cmd && del install.cmd

설치 프로그램은 해당 플랫폼에 대한 릴리스 바이너리를 다운로드하여 PATH에 배치합니다. 새로운 직접 설치는 안정적인 업데이트 채널을 사용합니다. 기존 Windows 미리보기 설치는 herdr channel set stable로 전환할 때까지 미리보기 상태로 유지됩니다. Windows에서 PATH는 활성 버전의 릴리스 디렉터리를 가리킵니다. 설치 프로그램은 current 및 안정적인 bin 호환성 별칭도 업데이트하므로 업데이트 시 실행 중인 herdr.exe을 덮어쓸 필요가 없습니다.

이미 Homebrew를 사용하고 있는 경우:

brew install herdr

이미 mise를 사용하고 있다면:

mise use -g herdr

mise가 herdr not found in mise tool registry을 보고하면 mise를 업데이트하고 다시 시도하십시오. 이전 버전은 Herdr 레지스트리 항목보다 이전 버전입니다. mise use -g github:herdrdev/herdr은 임시 대체 수단으로 작동합니다.

이미 Nix를 사용하고 있다면 Herdr는 소스에서 Herdr를 빌드하는 플레이크를 제공합니다.

nix run github:herdrdev/herdr/v0.x.y
nix build github:herdrdev/herdr/v0.x.y
nix profile install github:herdrdev/herdr/v0.x.y

v0.x.y을 최신 릴리스 태그로 바꿉니다. master을 추적하기 위해 태그를 생략할 수 있지만 일반 설치에는 릴리스 태그를 사용하는 것이 좋습니다.

플레이크는 또한 개발 셸을 노출합니다.

nix develop github:herdrdev/herdr

동일한 Nix 워크플로를 사용하여 Herdr를 업데이트합니다. 프로필 설치의 경우 프로필 항목을 나열하고 Herdr 항목을 업그레이드합니다.

nix profile list
nix profile upgrade <index-or-name>

Herdr가 자체 플레이크의 입력인 경우 해당 입력을 업데이트하고 시스템, 홈 관리자 또는 개발 환경을 다시 구축하십시오.

nix flake update herdr

GitHub 릴리스에서 바이너리를 다운로드할 수도 있습니다.

귀하의 시스템과 일치하는 자산을 선택하십시오:

Linux 또는 macOS에서는 실행 가능하게 만들고 PATH의 어딘가로 이동합니다.

chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr

안정적인 릴리스와 미리 보기 시험판에는 모두 herdr-windows-x86_64.zip이 포함되어 있습니다. 아카이브에는 herdr.exe 및 해당 앱-로컬 ConPTY 런타임이 포함되어 있습니다. 추출된 디렉터리를 함께 보관하십시오. herdr.exe만 복사하지 마세요.

목자 시작:

herdr

쉘이 herdr을 찾을 수 없으면 터미널을 다시 시작하거나 설치 디렉터리가 PATH에 있는지 확인하십시오.

Herdr는 새로운 릴리스를 확인하고 앱에서 알려줍니다. 수동으로 업데이트할 수 있습니다.

herdr update

Herdr의 자체 설치 프로그램이 관리하는 설치에만 herdr update을 사용하세요. 대신 해당 패키지 관리자를 통해 Homebrew, mise 및 Nix 설치를 업데이트하세요.

Linux, macOS 및 Windows에 직접 설치하면 기본적으로 안정적인 업데이트 채널을 사용합니다. master에서 미리보기 빌드를 선택하려면 채널을 설정하세요.

herdr channel set preview

같은 방식으로 직접 설치를 다시 안정 버전으로 전환합니다.

herdr channel set stable

직접 설치의 경우 채널을 변경하면 선택한 채널을 확인하고 최신 바이너리를 설치합니다. 해당 업데이트가 실패하면 herdr update을 실행하여 구성된 채널에서 다시 시도하십시오.

미리보기 빌드는 현재 개발 분기에서 정기적으로 게시되는 GitHub 사전 릴리스입니다. 다음 안정 릴리스 이전에 수정 사항을 원할 때 유용하지만 회귀할 수 있습니다. Homebrew, mise 및 Nix 설치는 미리보기 채널을 사용하지 않습니다.

Stable은 일반적인 Windows 사용에 권장되는 채널입니다. 미리 보기는 더 빨리 수정 사항을 받지만 회귀할 수 있으므로 절충을 원하는 경우에만 선택하세요. 기존 Windows 미리 보기 설치는 명시적으로 전환할 때까지 미리 보기 상태로 유지됩니다. 이전 미리 보기 빌드가 herdr channel set stable을 거부하는 경우 미리 보기에서 herdr update을 한 번 실행한 다음 채널 전환을 다시 시도하세요.

기본적으로 herdr update은 새 바이너리를 설치하고 끝점 생성-1 서버와 해당 패널 프로세스를 실행 상태로 둡니다. 업데이트된 클라이언트에 다시 연결하려면 Herdr를 다시 시작하세요. 클라이언트 전용 변경 사항은 즉시 적용됩니다. 새로운 서버 측 작업은 해당 서버가 업데이트되고 다시 시작될 때까지 사용할 수 없습니다. 클라이언트는 연결을 끊는 대신 알림을 표시합니다. 엔드포인트 1세대 이전의 서버는 업데이트 중에 마지막으로 한 번 중지해야 합니다.

작업이 완료되면 herdr update은 다시 시작하는 명령을 사용하여 여전히 이전 버전에서 실행 중인 서버와 자체 Herdr를 실행하는 저장된 SSH 시스템을 나열합니다. 업데이트하려면 각 기기에서 herdr update을 실행하세요.

지원되는 실행 세션에 대한 실험적 라이브 서버 핸드오프를 선택하려면 다음을 실행하세요.

herdr update --handoff

두 서버 모두 에이전트 상태 전송을 지원하는 경우 라이브 핸드오프는 다음 보고서가 도착할 때까지 훅 보고 에이전트 상태를 유지합니다. 이전 서버에서 핸드오프하면 실행 중인 에이전트가 일시적으로 유휴 상태로 표시될 수 있습니다.

실시간 핸드오프는 Homebrew, mise 또는 Nix 패키지 관리자 업데이트에 적용되지 않습니다. 해당 설치의 경우 패키지 관리자로 업데이트한 다음 Herdr를 다시 실행하여 업데이트된 클라이언트에 다시 연결하세요. 호환되는 이전 서버가 계속 실행됩니다. 새 릴리스에서 서버측 변경을 원하는 경우에만 herdr server stop 또는 herdr session stop <name>을 사용하여 나중에 다시 시작하십시오.

안정적인 채널 바이너리는 Linux, macOS 및 Windows x86_64에서 사용할 수 있습니다. 지원되는 워크플로 및 알려진 제한 사항은 Windows 지원을 참조하세요. Windows ARM64는 Windows 에뮬레이션에서 x86_64 빌드를 실행합니다.