Skip to main content

frpctl 사용법

일상 운영에서는 다음 하나만 기억하면 됩니다.

처음 사용하는 사람을 위한 기본 키

무엇을 하고 싶은지로 명령을 찾으세요

기본 문법

CLIENT ID가 관리 기준입니다

Canonical client selector는 immutable CLIENT ID입니다. Label/hostname은 사람이 보기 위한 metadata이며 바뀔 수 있습니다. show clients에서 CLIENT ID를 먼저 확인하세요. Ambiguous selector는 추측해서 진행하지 않고 실패하는 것이 원칙입니다.

Server에서 자주 쓰는 명령

Client에서 자주 쓰는 명령

Client service 변경은 staged 상태이고 apply 후 live가 됩니다. 잘못 수정했다면 applydiscard할 수 있습니다.

Disable / Release / Revoke

Stable와 development 구분

이 사이트의 운영 baseline은 stable v2.1.2입니다. main은 2.1.3 development이고 추가 lifecycle/retention command가 있을 수 있습니다. Stable 서버에서는 현재 설치된 frpctl help와 immutable release 문서를 기준으로 하세요.

안전성

  • doctor는 read-only
  • frpctl history는 session-only
  • show upstream은 정보용이며 최신 FRP를 자동 설치하지 않음
  • Identity가 ambiguous하면 fail closed
마지막 수정일 2026년 9월 7일