Skip to main content

macOS 클라이언트

Published stable v2.2.1은 Apple Silicon(arm64) + macOS 11 Big Sur 이상의 macOS Client를 지원합니다. Intel Mac은 이 stable release의 지원 범위가 아닙니다. macOS Client도 다른 플랫폼과 동일한 enrollment protocol과 pinned FRP 0.71.0을 사용합니다.

요구사항

  • Apple Silicon Mac (arm64)
  • macOS 11 이상
  • sudo를 사용할 수 있는 관리자 권한
  • launchd, curl, openssl, python3, tar, shasum
필요한 Command Line Tools가 없으면 다음으로 설치할 수 있습니다.
FRP Auto Deploy는 Remote Login을 켜거나, macOS 사용자 계정을 만들거나, firewall을 변경하거나, Homebrew package를 설치하지 않습니다. SSH를 게시하려면 SSH 서비스와 계정이 먼저 로컬에서 정상 동작해야 합니다.

Mac 등록

FRP Auto Deploy Server에서 Zero-Touch enrollment를 생성합니다.
그 다음:
Server가 출력한 명령을 Mac으로 안전하게 전달하고 stable server가 출력한 명령 그대로 실행하세요. Shared bootstrap이 Darwin/Apple Silicon을 감지하고, pinned macOS frpc를 다운로드해 SHA-256을 검증한 뒤 verified HTTPS enrollment와 launchd runtime 설치를 진행합니다. SSH용 profile이라면 관리자가 지정한 SSH 계정이 Mac에 이미 존재해야 하고, SSH 접속이 필요하면 Remote Login도 미리 활성화돼 있어야 합니다.

상태 확인

launchd를 직접 확인하려면:
Client state는 다음 위치에 저장됩니다.
LaunchDaemon:

재부팅 동작

Stable macOS Client는 system LaunchDaemon을 사용하므로 interactive login 없이도 재부팅 후 FRP Client가 다시 올라오도록 설계되어 있습니다. v2.2.1 qualification에는 macOS lifecycle과 reboot/autostart 검증이 포함됩니다.

서비스 게시

Mac 자체의 서비스뿐 아니라 Mac이 접근할 수 있는 다른 LAN host의 서비스도 게시할 수 있습니다. Linux와 동일하게 SSH, HTTP, HTTPS passthrough, Custom TCP 서비스에 persistent public service port가 배정됩니다. 자세한 내용은 서비스 관리를 확인하세요.

제거와 Release

Uninstall은 로컬 client software와 LaunchDaemon을 제거하지만 server-side client record와 public-port reservation은 자동으로 반환하지 않습니다. 장비를 영구 폐기할 때는 Server에서 별도로 release합니다.
Uninstall과 Release는 서로 다른 작업입니다. 단순 재설치나 일시 중지 목적이라면 Client를 release하지 마세요.
정확한 stable validation claim은 지원 플랫폼 & 제한을 확인하세요.
마지막 수정일 2026년 9월 9일