CLI 명령어 전체 참조

현재 제품의 Server·Agent 공개 CLI를 정리했습니다. MCP 도구는 MCP 도구 참조에서 확인하세요. Linux 셸에서 sudo drlink로 REPL에 들어가면 아래 명령을 그대로 입력합니다. 일반 셸에서 실행할 때는 각 줄 앞에 sudo drlink를 붙이세요. 꺾쇠괄호 값은 실제 값으로 바꿔야 합니다. 이름까지만 입력한 set은 생성/수정 마법사를 열고, 필드를 모두 준 명령은 필요한 영향도 확인 후 직접 적용합니다.

명령 입력과 도움말

drlink> show status
drlink> set network-object github

drlink show status
drlink set network-object github

show
set
unset
test
system
menu
help
exit

?
help
help managed-hosts
help network-objects
help commands
<verb> ?
Tab completion

Server 조회

show status

show managed-hosts
show managed-host <HOST>
show managed-host <HOST> agent
show managed-host <HOST> addresses
show managed-host <HOST> remote-services

show managed-host-groups
show managed-host-group <GROUP>

show enrollments
show enrollment <ENROLLMENT>

show network-objects
show network-object <OBJECT>
show network-object <OBJECT> references
show network-groups
show network-group <GROUP>
show network-group <GROUP> references

show service-objects
show service-object <SERVICE>
show service-object <SERVICE> references
show service-groups
show service-group <GROUP>
show service-group <GROUP> references

show remote-access
show remote-access <RULE>

show internet-access
show internet-access <RULE>

show ai-identities
show ai-identity <IDENTITY>

show permission-objects
show permission-object <PERMISSION>
show permission-groups
show permission-group <GROUP>

show ai-access
show ai-access <RULE>

show ai-access-log
show ai-access-log identity <IDENTITY>
show ai-access-log destination <DESTINATION>
show ai-access-log permission <PERMISSION>

Server 생성과 수정

set enrollment zero-touch
set enrollment manual
set enrollment bulk

set server public-hostname <FQDN>
set server bootstrap-hostname <FQDN>
set server installer-url <URL>
set server windows-installer-url <URL>

set managed-host-group <GROUP>
set managed-host <HOST> group <GROUP>

set network-object <OBJECT>
set network-group <GROUP>

set service-object <SERVICE>
set service-group <GROUP>

set remote-access <RULE>
set remote-access enabled
set remote-access disabled

set internet-access <RULE>
set internet-access enabled
set internet-access disabled

set ai-identity <IDENTITY>

set permission-object <PERMISSION>
set permission-group <GROUP>

set ai-access <RULE>
set ai-access enabled
set ai-access disabled

set mcp-tls hostname <FQDN>
set mcp-tls mode <auto-acme|user-certificate>
set mcp-tls contact-email <EMAIL>
set mcp-tls acme-environment <production|staging>
set mcp-tls acme-directory <URL>

set network-object github type fqdn value github.com
set network-object office-admin type ip value 203.0.113.10

set network-group approved-admins members office-admin,vpn-admin

set service-object ssh type tcp port 22
set service-object dns-udp type udp port 53
set service-object legacy-db type fixed-tcp port 1521

set service-group web-services members http,https

set permission-object read-only permissions host-info,process-read,file-read
set permission-group observers members read-only

set ai-access allow-read mode whitelist source automation-ai destination ubuntu-prod permission read-only paths '/var/lib/vendor/**' enabled

일괄 등록 CSV 헤더는 label,ssh_user,note입니다. 미사용 코드 최대 10개, 기본 유효기간 1시간/최대 24시간이며 SSH 사용자명은 비워도 됩니다. Zero-Touch는 공인 HTTPS 호스트명 또는 검증된 숫자 IP/Private CA 경로의 짧은 일회용 명령을 만듭니다. DNS는 필수가 아니며 준비 조건이 없으면 발급 전에 오류를 냅니다.

접근 정책과 파일 경로 범위

set remote-access block-partner mode blacklist source partner-office destination ubuntu-prod service ssh enabled

set internet-access github-https mode whitelist source ubuntu-prod destination github service https enabled

set ai-access claude-prod mode whitelist source claude destination production-servers permission read-only paths '/var/log/myapp/**' enabled
set ai-access allow-read mode whitelist source automation-ai destination ubuntu-prod permission read-only paths '/var/lib/vendor/**,/opt/app/**' enabled

set remote-access enabled
set remote-access disabled
set internet-access enabled
set internet-access disabled
set ai-access enabled
set ai-access disabled

파일 권한에는 Rule의 paths가 필요합니다. 수정 시 생략하면 유지하고 paths none이면 비웁니다. command-exec는 OS 계정 권한으로 동작하므로 파일 경로 제한보다 강한 권한입니다. 최초 OAuth 소유자의 자동 mcp-owner-full-access Rule은 Managed Host에 7개 기능을 부여할 수 있습니다. 읽기 전용 사용자는 별도 최소 권한 identity와 기존 Rule까지 확인하세요.

Server 리소스 삭제

unset managed-host <HOST>
unset managed-host <HOST> group <GROUP>
unset managed-host-group <GROUP>
unset enrollment <ENROLLMENT>

unset server public-hostname
unset server bootstrap-hostname
unset server installer-url
unset server windows-installer-url

unset network-object <OBJECT>
unset network-group <GROUP>

unset service-object <SERVICE>
unset service-group <GROUP>

unset remote-access <RULE>
unset remote-access policy

unset internet-access <RULE>
unset internet-access policy

unset ai-identity <IDENTITY>

unset permission-object <PERMISSION>
unset permission-group <GROUP>

unset ai-access <RULE>
unset ai-access policy

unset mcp-tls
unset mcp-tls purge

삭제 전에 참조를 확인하세요. 그룹 멤버십 제거는 메타데이터 변경이고, bare unset managed-host는 신뢰·엔드포인트 예약을 폐기합니다. 리소스 삭제와 정책 초기화에는 y/N 확인이 적용될 수 있습니다. unset mcp-tls는 공개 경로를 제거하되 인증서 자료를 보존하고, purge는 대화형 확인 후 보존한 비밀 자료까지 제거합니다.

정책 테스트

test remote-access source <SOURCE> destination <DESTINATION> service <SERVICE>
test internet-access source <SOURCE> destination <DESTINATION> service <SERVICE>
test ai-access source <AI_IDENTITY> destination <DESTINATION> permission <PERMISSION> [path <PATH>]

파일 테스트에는 path를 지정하세요. Group은 원자 조합으로 확장되며 전체 ALLOW는 모든 조합이 허용될 때만 표시됩니다. 정책 테스트는 실제 통신이나 MCP 호출 성공을 대신하지 않습니다.

Server 운영·OAuth·인증서

system status
system version
system diagnostics
system audit

system revisions
system revision <REVISION>
system diff <REVISION_A> <REVISION_B>
system rollback <REVISION>

system backup
system backup validate <FILE>
system restore <FILE>

test configuration <FILE|->
system export configuration <FILE>
system diff configuration <FILE|->
system apply configuration <FILE|->

system certificate issue
system certificate import <CERT> <KEY> [CHAIN]
system certificate renew
system certificate status
system certificate preflight

system credential rotate ai-identity <IDENTITY>
system credential revoke ai-identity <IDENTITY>
system credential configure ai-identity <IDENTITY> authentication <static-bearer|oauth>
system credential approve-oauth <PENDING-ID> [AI-IDENTITY]
system credential deny-oauth <PENDING-ID>

system update product
system update engine
system update check-engine
system support-bundle
system uninstall

system backup validate는 읽기 전용이며 restore는 검증·확인 후 현재 상태를 교체합니다. OAuth 페이지의 서버·클라이언트와 새 pending ID를 확인한 뒤 해당 서버에서 승인하세요. 인증서 issue/import/renew는 프런트엔드를 재시작할 수 있으며 TLS 조회는 system certificate status입니다. 제품과 엔진 업데이트는 별도 명령입니다.

Agent Host 명령

show status
show agent

show remote-services
show remote-service <NAME>

set remote-service <NAME>
unset remote-service <NAME>

system info
system pause
system resume
system restart
system autostart enable
system autostart disable
system update product
system update engine
system synchronize

test configuration <FILE|->
system export configuration <FILE>
system diff configuration <FILE|->
system apply configuration <FILE|->

system diagnostics
system support-bundle
system version
system uninstall

set remote-service ssh-access destination this-host service ssh enabled

set remote-service internal-db-postgres destination internal-db service postgres enabled

Remote Service는 소유 Agent에서 만들고 TCP 또는 Fixed TCP Service Object 1개를 선택합니다. 공개 엔드포인트는 Server가 할당합니다. UDP·Service Group·CIDR/다중 대상·중복 destination+service는 거부됩니다. 런타임 검증 문제는 diagnostics → synchronize → show remote-service 순서로 확인하세요. autostart disable은 다음 부팅에 적용되고 resume은 시작·자동 시작을 복원합니다.

ConfigurationBundle

configurationBundle:
  context: server

test configuration <FILE|->
system diff configuration <FILE|->
system apply configuration <FILE|->
system export configuration <FILE>

:end

sudo env DRLINK_EXPECTED_REVISION=42 drlink set network-object branch-dns value 198.51.100.20

현재 역할의 새 export를 기준으로 작성하세요. apiVersion/kind 필드는 없습니다. 생략한 리소스는 유지하고 state: absent는 명시적으로 삭제합니다. 오래된 sourceRevision은 apply에서 거부됩니다. 원자성은 Server/Agent 각 컨텍스트 내부에 한정됩니다. revision 조건이 맞으면 동일 내용 재적용은 NO CHANGE입니다.

정책별 기본 동작

정책	지원 모드	정책 없음/미일치	Enforcement disabled
Remote Access	BLACKLIST / WHITELIST	초기 ALLOW; WHITELIST 미일치 DENY	ALLOW ALL
Internet Access	WHITELIST	DENY	DENY ALL
AI Access	WHITELIST	DENY	DENY ALL

Rule 순서나 Rule별 allow/deny 필드는 없습니다. 기존 모드와 충돌하는 mode 변경은 거부됩니다. 첫 Rule에는 mode가 필요합니다. 활용 사례 · Claude / ChatGPT 연결

REPL 편의 명령

system history
system clear
menu
help
help commands
exit

등록 예제의 자동 구성

SSH/RDP/Choose Remote Services로 발급하면 선택한 서비스는 자동 구성됩니다. 기본 실습은 show remote-services로 실제 이름을 확인하고 중복 생성하지 않습니다. 단건 SSH only의 빈 사용자명은 SSH 게시를 유지하지만 bulk의 빈 ssh_user는 management-only입니다. 위 명령 목록은 문법 참조이므로 Group 구성원·AI Identity·Managed Host·Service Object는 실행 전에 실제로 존재해야 합니다.

시작하기

실습: 활용 사례

Managed Host & Object

Remote Service & Access

Internet Access

AI Access

CLI & Configuration

배포

운영 & 문제 해결

보안 & 참고

CLI 명령어 참조

CLI 명령어 전체 참조

명령 입력과 도움말

Server 조회

Server 생성과 수정

접근 정책과 파일 경로 범위

Server 리소스 삭제

정책 테스트

Server 운영·OAuth·인증서

Agent Host 명령

ConfigurationBundle

정책별 기본 동작

REPL 편의 명령

등록 예제의 자동 구성

​CLI 명령어 전체 참조

​명령 입력과 도움말

​Server 조회

​Server 생성과 수정

​접근 정책과 파일 경로 범위

​Server 리소스 삭제

​정책 테스트

​Server 운영·OAuth·인증서

​Agent Host 명령

​ConfigurationBundle

​정책별 기본 동작

​REPL 편의 명령

​등록 예제의 자동 구성

CLI 명령어 전체 참조

명령 입력과 도움말

Server 조회

Server 생성과 수정

접근 정책과 파일 경로 범위

Server 리소스 삭제

정책 테스트

Server 운영·OAuth·인증서

Agent Host 명령

ConfigurationBundle

정책별 기본 동작

REPL 편의 명령

등록 예제의 자동 구성