본문으로 건너뛰기

TinyShield 명령줄 도구 (tinyshield-cli)

tinyshield-cli는 터미널과 직접 작성한 스크립트에서 TinyShield를 제어합니다. MCP 서버와 같은 도구를 제공합니다. 예를 들어 빌드 스크립트가 실행할 도구를 승인하거나, cron 작업이 규칙을 내보낼 수 있습니다.

명령줄은 TinyShield PRO 기능입니다. TinyShield › Settings › MCP에서 MCP 서버와 함께 켭니다.

1. 설정하기​

도구는 앱 안에 있습니다.

"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli" --help

Settings › MCP에 표시된 대로 셸 프로필(~/.zshrc)에 별칭을 추가합니다.

alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'

Setapp 버전이라면 /Applications/Setapp/Tiny Shield.app을 대신 사용하세요. TinyShield가 실행 중이 아니면 명령이 먼저 백그라운드에서 TinyShield를 엽니다.

2. 명령​

명령하는 일
tinyshield status버전, 라이선스, 연결 모드, Network Extension, 규칙 수
tinyshield mode [allow-all|require-approval|block-all]연결 모드 표시 또는 전환
tinyshield pending list승인을 기다리는 앱과 연결하려던 대상
tinyshield pending allow <app>… / block <app>…대기 중인 앱을 이름, 번들 ID, 경로, pid, ID로 허용 또는 차단(전체는 --all)
tinyshield pending wait [--timeout 60]승인이 필요한 앱이 생길 때까지 대기
tinyshield decisions [list|allow|block|remove]Require Approval 모드의 App Connection Decisions
tinyshield block-list [list|add|remove|enable|disable]Block List
tinyshield allow-list [list|add|remove]Allow List
tinyshield apps [--range 1h] [--status blocked]네트워크를 사용한 앱
tinyshield app <app> 또는 --pid <pid>앱 하나의 서명, 규칙, 활동, 대역폭
tinyshield connections <app> 또는 --pid <pid>앱이 연결한 도메인과 IP 주소
tinyshield domain <domain> / tinyshield ip <ip>도메인이나 IP에 연결한 앱과 일치하는 규칙
tinyshield tree메인 창의 목록을 트리로 표시
tinyshield countries앱이 연결한 국가(지도와 동일)
tinyshield recently-blocked [--clear]최근에 차단된 연결
tinyshield bandwidth [--timeframe day] [--app Safari] / tinyshield live데이터 사용량과 현재 속도
tinyshield settings [get|set <setting> on|off]block-list, dns, apple-programs, launch-at-login 등의 설정
tinyshield export <file> / tinyshield import <file> [--replace]구성 저장 또는 불러오기
tinyshield open <window> [--search text]main, block_list, mcp_settings 같은 TinyShield 창 표시
tinyshield clear-activity --yes기록된 네트워크 활동 삭제(규칙은 유지)
tinyshield tools / tinyshield call <tool> '<json>'모든 도구 나열 또는 JSON 인수로 도구 호출

모든 옵션은 tinyshield <command> --help로 확인하세요.

block-list add와 allow-list add에서 /, ~, ./로 시작하는 값은 앱이나 실행 파일입니다. 그 밖의 값은 도메인, 와일드카드(*.example.com), IP 주소입니다.

3. 예시​

빌드에서 사용하는 패키지 관리자를 승인한 다음 빌드를 실행합니다.

tinyshield pending allow ~/.local/bin/uv
uv pip install -r requirements.txt

오래 걸리는 무인 작업 전에 도구를 미리 승인합니다.

tinyshield allow-list add /opt/homebrew/bin/node ~/.local/bin/uv

앱이 승인을 기다리면 알림을 보냅니다.

if tinyshield pending wait --timeout 600 --only-new; then
osascript -e 'display notification "An app is waiting for approval" with title "TinyShield"'
fi

트래커를 모든 앱에서 차단하고, 어떤 앱이 연결했는지 확인합니다.

tinyshield block-list add '*.doubleclick.net'
tinyshield domain doubleclick.net --subdomains --range 7d

4. 스크립트에서 사용하기​

  • 기계가 읽을 수 있는 출력이 필요하면 명령에 --json을 추가합니다.
  • TinyShield를 여는 대신 실패하게 하려면 --no-launch를 추가합니다.
  • 종료 코드:
코드의미
0성공
1명령이 실패했습니다. TinyShield가 Require Approval 모드가 아니면 pending wait도 1로 종료합니다
3찾을 수 없습니다. 시간 초과 전에 승인을 요청한 앱이 없으면 pending wait도 3으로 종료합니다
4TinyShield PRO가 필요합니다
69TinyShield에 연결할 수 없습니다. 서버가 꺼져 있거나, TinyShield가 설치되어 있지 않거나 실행 중이 아닙니다(--no-launch 사용 시)

명령줄에서 내린 결정은 TinyShield의 Decisions 목록에 Command Line으로 표시됩니다.