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으로 종료합니다 |
4 | TinyShield PRO가 필요합니다 |
69 | TinyShield에 연결할 수 없습니다. 서버가 꺼져 있거나, TinyShield가 설치되어 있지 않거나 실행 중이 아닙니다(--no-launch 사용 시) |
명령줄에서 내린 결정은 TinyShield의 Decisions 목록에 Command Line으로 표시됩니다.