메인 콘텐츠로 건너뛰기

지점별 서버 여러 대를 한 번에 등록·분류하기

완성 결과: 지점 Linux 서버 또는 PC 두 대를 안전하게 등록하고, 서비스 포트를 추가로 공개하지 않고 Managed Host Group으로 관리합니다.

1단계 — 지점별 준비

각 호스트에서 DRLink Server의 등록·관리 엔드포인트로 아웃바운드 연결할 수 있는지 확인합니다. Agent 설치 권한과 Linux, Windows, macOS 별 요구사항을 확인하세요. Server 설치와 서비스 상태를 먼저 확인합니다.

2단계 — 일괄 등록 발급

실제 Data Relay Link CLI 캡처 — 실제 Enrollment 목록: completed, expired, revoked 상태를 구분합니다. 일회용 등록 코드 원문은 표시하지 않습니다. 그림 1. 실제 Enrollment 목록: completed, expired, revoked 상태를 구분합니다. 일회용 등록 코드 원문은 표시하지 않습니다. 제품 CLI 출력 예시; 일부 주소·호스트는 가렸습니다. Server REPL:
Wizard에서 수량 또는 UTF-8 CSV 입력을 선택합니다. CSV 헤더는 다음과 같습니다.
확인: 최대 한 배치당 10개, 활성 미사용 코드 10개, 기본 TTL 1시간, 최대 24시간입니다. SSH 사용자 힌트가 비어 있으면 관리 전용으로 등록되며, DRLink가 OS 계정을 자동 생성하지 않습니다. 각 등록 자격증명은 1회용이므로 공개 문서·이슈에 노출하지 마세요.

3단계 — 개별 호스트에서 설치·검증

각 지점 관리자에게 발급된 실제 일회용 설치 명령을 안전하게 전달하고 해당 호스트에서만 실행합니다. 임의로 설치 URL을 조합하거나 사용한 코드를 재사용하면 안 됩니다. 각 Linux Agent Host의 셸:
기대 결과: Role이 Agent Host, 등록 신원과 Server 연결이 정상입니다. Windows/macOS의 명령 실행 방식은 각 플랫폼 가이드를 따릅니다.

4단계 — Server에서 Managed Host 확인

실제 Data Relay Link CLI 캡처 — 실제 Server Managed Host 목록: 등록된 호스트와 connected 상태를 확인합니다. 그림 2. 실제 Server Managed Host 목록: 등록된 호스트와 connected 상태를 확인합니다. 제품 CLI 출력 예시; 일부 주소·호스트는 가렸습니다. Server REPL:
등록된 이름과 불변 ID를 확인하세요. 실제 Managed Host 이름이 다르면 다음 단계의 branch-a/branch-b를 실제 이름으로 바꿔 실행합니다.

5단계 — 지점 그룹으로 관리

실제 DRLink Server 메인 CLI 메뉴 — 1번 Managed Hosts를 선택하여 그룹과 등록 호스트 관리 그림 3. 실제 Server CLI menu 화면에서 1번 Managed Hosts를 선택합니다. 이 메뉴에서 호스트 등록·인벤토리 관련 작업을 시작합니다. Server REPL:
성공 기준: 두 Managed Host가 branches 그룹에 표시됩니다. Managed Host Group은 인벤토리 그룹이고 접근 정책의 Network Group과 다릅니다. 그룹을 만든다고 Remote Service나 접근 허용 정책이 자동 생성되지 않습니다.

장애·정리

등록이 실패하면 show enrollments, 만료·취소 여부, Agent의 system diagnostics와 Server 연결을 점검합니다. 이미 소비된 코드는 새 등록에 사용할 수 없습니다. 그룹 할당만 해제하려면 unset managed-host branch-b group branches를 사용합니다. 전체 장치 unset managed-host branch-b는 별도 신원·서비스 철회이므로 그룹 정리 목적으로 실행하면 안 됩니다.

최신 동작 확인 — 2026-10-28

UTF-8 CSV 헤더는 label,ssh_user,note이며 빈 ssh_user는 관리 전용 등록입니다. Zero-Touch는 DNS 없이 검증된 숫자 IP/Private CA 짧은 명령을 사용할 수 있고 준비 조건 실패 시 티켓을 발급하면 안 됩니다. Managed Host Group은 인벤토리 메타데이터이며 Network Group 정책 멤버십과 별개입니다. 현재 CLI 전체 목록 · MCP 호환성

이 예제의 자동 서비스 결과

CSV의 branch-a,operator,...는 SSH/22 서비스와 공인 endpoint도 자동 구성합니다. branch-b,,...는 management-only이며 SSH를 게시하지 않습니다. 두 Agent에서 show remote-services로 각각 확인하고 branch-a의 SSH를 수동으로 다시 만들지 마세요. 단건 SSH only에서 사용자명을 비우는 동작과 bulk의 빈 ssh_user는 의미가 다릅니다.
마지막 수정일 2026년 10월 29일