수동 그룹

FRP Auto Deploy v2.2.1에는 Client를 정리하기 위한 Manual Group MVP가 포함되어 있습니다. Group은 관리자용 metadata이며 CLIENT ID, 서비스 설정, public port, tunnel 동작을 변경하지 않습니다.

v2.2.1은 수동 그룹만 지원합니다. Dynamic membership rule이나 대규모 fleet orchestration은 현재 stable 범위가 아닙니다.

그룹 생성

sudo frpctl create group branch-office --description "Branch office systems"

저장된 Group에는 grp_1234abcd 같은 immutable Group ID가 있습니다. 이름과 설명은 나중에 변경할 수 있습니다.

Client 추가

가능하면 canonical CLIENT ID를 사용하세요.

sudo frpctl add client <CLIENT-ID> group branch-office

한 Client는 여러 Group에 속할 수 있습니다.

Group과 membership 확인

sudo frpctl show groups
sudo frpctl show group branch-office
sudo frpctl show clients --group branch-office
sudo frpctl show client <CLIENT-ID> groups

all과 ungrouped는 virtual selector이며 실제 저장되는 Group object가 아닙니다.

Group 이름/설명 변경

sudo frpctl rename group branch-office seoul-office
sudo frpctl set group seoul-office description "Seoul branch systems"

Group 이름을 바꿔도 immutable Group ID는 바뀌지 않습니다.

Membership 제거

sudo frpctl remove client <CLIENT-ID> group seoul-office

Membership 관계만 제거됩니다. Client enrollment, 서비스, public-port reservation은 그대로 유지됩니다.

Group 삭제

sudo frpctl delete group seoul-office

Group 삭제는 membership reference만 제거하며 Client 삭제, identity revoke, 서비스 disable, port release를 수행하지 않습니다.

Group 삭제는 Client lifecycle 작업이 아닙니다. Revoke/Release 판단은 Lifecycle을 확인하세요.

활용 예

Manual Group은 소규모 운영에서 다음과 같은 분류에 유용합니다.

고객 또는 파트너
지사/사이트
Lab / production-support 장비
임시 기술지원 대상

현재 목표 규모인 약 1–50 Clients에서는 별도 fleet-management platform 없이도 Client 목록을 단순하게 정리하는 데 충분합니다.

시작하기

클라이언트 & 서비스

frpctl

배포

운영 & 문제 해결

보안 & 참고

수동 그룹

수동 그룹

그룹 생성

Client 추가

Group과 membership 확인

Group 이름/설명 변경

Membership 제거

Group 삭제

활용 예

​수동 그룹

​그룹 생성

​Client 추가

​Group과 membership 확인

​Group 이름/설명 변경

​Membership 제거

​Group 삭제

​활용 예

수동 그룹

그룹 생성

Client 추가

Group과 membership 확인

Group 이름/설명 변경

Membership 제거

Group 삭제

활용 예