Skip to content
KitploitKITPLOIT
도구블로그
Log in
제출
도구블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
sonar — localhost 포트에서 수신 중인 서비스를 검사하고 관리하기 위한 CLI 도구 | Kitploit
도구/GitHubGitHub/raskrebs/sonar
General Purpose UtilitiesNetwork MappingPort ScanningScripting & AutomationInformation GatheringDevSecOps
GitHubraskrebs/sonar

sonar

localhost 포트에서 수신 중인 서비스를 검사하고 관리하기 위한 CLI 도구

저장소 보기
1.1k336712일 전Kitploit 검토 완료
공유
<div align="center">

```
██████    ███    ██████    ██    ██████
██           ██      ██  ██  ██      ██
██      ██   ██  ██  ██  ██  ██      ██
  ██  ██   ██  ██  ██  ██  ██  ████
    ██  ██       ██  ██  ██  ██  ██  ██
██████    ███    ██  ██  ██  ██  ██  ██
```
여러분의 머신에서 무엇이 실행 중인지 파악하세요.

</div>

Sonar는 localhost에서 수신 대기 중인 모든 것을 보여주고 정리합니다: 모든 포트는
**그룹**에 속하며 — 일반적으로 해당 포트가 시작된 저장소 — 그 그룹 내에서는
이름이 지정된 **서비스**에 속합니다. `sonar start`로 개발 서버를 시작하면
프로젝트 전체가 하나의 트리로 나열하고, 대기하고, tail하고, 단일 명령으로
중지할 수 있는 하나의 대상이 됩니다. Docker 컨테이너, Compose 프로젝트,
직접 시작한 프로세스도 별도 설정 없이 함께 감지됩니다.

```
$ sonar list --tree
my-app  (3 ports, running)                        ~/code/my-app
├─ 5432  db          postgres:17                  http://localhost:5432
├─ 5173  frontend    vite (v5.4)                  http://localhost:5173
└─ 8000  api         uvicorn app:app              http://localhost:8000
ungrouped (1 port)
└─ 3000  next-server (v16.1.6)                    http://localhost:3000
```

## 설치

### Homebrew (macOS / Linux)

```sh
brew install raskrebs/sonar/sonar
```

Homebrew 6은 신뢰할 수 있는 탭으로 한 번 신뢰할 때까지 서드파티 탭의 포뮬러를 거부합니다
(`Error: Refusing to load formula raskrebs/sonar/sonar from untrusted tap`):

```sh
brew trust raskrebs/sonar
```

### 설치 스크립트

```sh
curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | bash
```

최신 바이너리를 `~/.local/bin`에 다운로드하고 필요하면 PATH에 추가합니다. 터미널을 재시작하거나 `source ~/.zshrc`를 실행하세요.

Windows(PowerShell)에서는:

```powershell
irm https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.ps1 | iex
```

사용자 지정 설치 위치:

```sh
curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | SONAR_INSTALL_DIR=/usr/local/bin bash
```

특정 버전 설치:

```sh
curl -sfL https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.sh | SONAR_VERSION=vX.Y.Z bash
```

```powershell
$env:SONAR_VERSION="vX.Y.Z"; irm https://raw.githubusercontent.com/raskrebs/sonar/main/scripts/install.ps1 | iex
```

### Go 사용하기

```sh
go install github.com/raskrebs/sonar@latest
```

셸 자동 완성(탭으로 포트 번호 자동 완성):

```sh
sonar completion zsh > "${fpath[1]}/_sonar"   # zsh
sonar completion bash > /etc/bash_completion.d/sonar  # bash
sonar completion fish | source                 # fish
```

## 60초

저장소 루트의 `dev.sh` 대신 `sonar.yaml`에 프로젝트가 어떻게 실행되는지 설명하세요:

```yaml
name: my-app
services:
  - name: db
    cmd: docker compose up db
    port: 5432
  - name: api
    cmd: uv run uvicorn app:app --port ${port}
    port: auto
    depends_on: [db]
  - name: frontend
    cmd: npm run dev -- --port ${port} --strictPort
    port: auto
    depends_on: [api]
    env:
      VITE_API_URL: ${api.url}
```

그런 다음 시작하세요:

```sh
sonar start
```

```
  ✓ db        http://localhost:5432   pid 41022  ~/.config/sonar/logs/my-app/db.log
  ✓ api       http://localhost:21408  pid 41040  ~/.config/sonar/logs/my-app/api.log
  ✓ frontend  http://localhost:21409  pid 41077  ~/.config/sonar/logs/my-app/frontend.log

3 started
following the logs; Ctrl+C stops the 3 services started here
api      | INFO:     Uvicorn running on http://127.0.0.1:21408
frontend | VITE v5.4  ready in 312 ms
```

Sonar는 모든 `port: auto` 서비스에 대해 사용 가능한 포트를 선택하고 각 서비스에 다른 서비스의 위치를 알려주므로, 두 번째 worktree가 첫 번째 옆에서 포트 충돌 없이 실행됩니다. `sonar start -d`는 백그라운드에서 동일한 작업을 수행하며, `sonar down`은 이를 중지하고 포트를 반환합니다. 다른 터미널에서:

```sh
sonar list --tree
```

```
my-app  (3 ports, running)                        ~/code/my-app
├─ 5432   db          postgres:17                 http://localhost:5432
├─ 21408  api         uvicorn app:app             http://localhost:21408
└─ 21409  frontend    vite (v5.4)                 http://localhost:21409
```

`sonar.yaml`이 없나요? `sonar start -- npm run dev`는 하나의 명령을 이름이 지정된 서비스로 실행하며, `sonar list`와 `sonar kill`은 수신 대기 중인 모든 항목에 대해 작동합니다.

아래에서 `# check`로 표시된 예제는 매 CI 실행 시 `scripts/readme-check.sh`에 의해 새 빌드에 대해 실행됩니다.

## 명령어

### `sonar list`

```sh
sonar list
sonar list --tree
sonar list --group my-app
sonar list --json
# check
```

```sh
sonar list --stats             # CPU, memory, threads, uptime, state
sonar list --health            # HTTP health checks
sonar list --filter docker     # only Docker ports
sonar list --sort name         # port | pid | name | type
sonar list -a                  # include desktop apps
sonar list -c port,process,group,cpu,mem
sonar list --host user@server  # scan a remote machine over SSH
```

기본 열은 `port`, `process`, `group`, `container`, `image`,
`containerport`, `url`이며, 여기서 `process`는 포트에 지정한 이름
(`sonar rename`)을, 그다음 서비스 이름을, 그다음 감지된 항목을
표시합니다.

사용 가능한 열: `port`, `process`, `pid`, `type`, `url`, `group`, `cpu`,
`mem`, `threads`, `uptime`, `state`, `connections`, `health`, `latency`,
`container`, `image`, `containerport`, `compose`, `project`, `user`, `bind`,
`ip`.

우연히 리스닝 중인 데스크톱 앱과 시스템 서비스 — Figma, Discord,
Spotify, ControlCenter, macOS `.app` 번들, `/System/Library/` 데몬 — 는
`-a`를 전달하지 않는 한 숨겨집니다.

### `sonar start`

`sonar.yaml`에서 프로젝트를 시작합니다:

```sh
sonar start                    # every service in the nearest sonar.yaml
sonar start api frontend       # only these (they still wait for their dependencies)
sonar start ../other-project   # the sonar.yaml in or above another directory
sonar start -d                 # in the background, like `sonar up`
```

포그라운드에서 sonar는 데몬을 통해 서비스를 시작하고, 모든 줄 앞에 서비스 이름을 붙여 로그를 따라가며, Ctrl+C를 누르면 자신이 시작한 서비스를 중지합니다. 이미 실행 중이던 서비스는 그대로 두고, sonar가 시작한 모든 서비스가 종료되면 sonar도 스스로 종료됩니다.

`--` 앞의 인수는 디렉터리나 서비스를 지정하며, `--` 뒤의 모든 것은 명령입니다. 또는 하나의 명령을 그룹 내 이름 있는 서비스로 실행할 수도 있습니다:

```sh
sonar start -- npm run dev
sonar start --group my-app --name frontend -- npm run dev
sonar start --port 5173 -- npm run dev        # expected port, before it binds
sonar start --detach --name api -- uv run uvicorn app:app
sonar start --list
```

아무것도 전달할 필요가 없습니다:

- **Group** — `--group`, 그렇지 않으면 가장 가까운 `sonar.yaml`의 `name`, 그렇지 않으면
  git 루트의 디렉터리 이름(워크트리는 `repo@worktree`가 됨), 그렇지 않으면 현재
  디렉터리의 이름.
- **Name** — `--name`, 그렇지 않으면 `cmd`가 일치하는 `sonar.yaml` 서비스, 그렇지 않으면
  명령에서 추론됨(`npm run dev` → `dev`, `uv run api` → `api`,
  `python -m uvicorn` → `uvicorn`, `./dev.sh` → `dev.sh`).
- **Port** — `--port`는 힌트일 뿐 바인딩이 아닙니다: 포트가 실제로 리스닝될 때까지
  실행은 `starting`으로 표시되며, 데몬은 이를 사용해 프로세스를 포트에
  매칭합니다.

자식 프로세스는 stdin, stdout, stderr, cwd 및 환경을 상속받고, 추가로
`SONAR_GROUP`, `SONAR_NAME`, `SONAR_RUN_ID`를 받습니다. 자체 프로세스 그룹을
가지므로 `sonar kill`이 전체 트리 — 워처와 워커를 포함한 개발 서버 — 를
종료시킵니다. Ctrl+C는 전달되며, sonar는 자식의 종료 코드로 종료됩니다.

`--detach`는 즉시 반환하고 출력을
`~/.config/sonar/logs/<group>/<name>.log`에 기록합니다. `--list`는 sonar가 시작한
것과 그 아래에 이후 종료된 것 — 종료 코드, 그리고 크래시했는지 중지되었는지와
함께 — 을 보여줍니다(기계 판독 가능한 형식은 `--json`):

```sh
sonar start --list
sonar start --detach --name demo --port 8123 -- sleep 5
sonar start --list --json
# check
```

### `sonar.yaml`

프로젝트는 저장소 루트의 `sonar.yaml`에서 자신과 서비스를 명명합니다. 이 파일은 선택 사항이며 — sonar는 없어도 git 루트를 기준으로 그룹화합니다 — 커밋하는 것을 의도한 것입니다:

```yaml
name: my-app
services:
  - name: db
    cmd: docker compose up db
    port: 5432
    health: /
    description: Postgres 17
    icon: database
    color: "#4f8cc9"
  - name: api
    cmd: uv run uvicorn app:app --port 8000
    cwd: backend
    port: 8000
    health: /healthz
    depends_on: [db]
  - name: frontend
    cmd: npm run dev
    port: 5173
    depends_on: [api]
ports: [9229]        # ports that belong to this project without a service
```

- `name` — 그룹 이름. 슬래시 없음, 공백 없음.
- `cmd`, `cwd`, `port` — `sonar start`가 서비스를 시작하는 방식. `cwd`는
  파일 기준 상대 경로이며 해당 디렉터리를 벗어날 수 없다.
- `health` — 서비스가 실행 중일 때 데몬이 폴링하는 HTTP 경로로, 서비스가
  *실행 중*이지만 아직 *정상*이 아닐 수 있다. `ok`, `fail` 또는
  `unknown`을 보고하며, 실패 시 그 이유를 함께 보고한다.
- `description`, `icon`, `color` — 데스크톱 앱을 위한 자유 형식 메타데이터로, sonar는
  이를 절대 추론하지 않는다.
- `depends_on` — 시작 순서. 파일에 없는 서비스를 지정하거나 순환이 있으면
  오류이다. 유효하지 않은 파일은 한 번 보고되며 스캔을 중단시키지 않는다.
- `env` — sonar가 서비스를 시작할 때 해당 서비스에 설정되는 변수.

#### `port: auto`와 참조

서비스는 포트를 sonar에 맡길 수 있으며, 하드코딩된 `localhost:8080` 대신
환경 변수를 통해 다른 서비스를 찾을 수 있다:

```yaml
services:
  - name: api
    cmd: uv run uvicorn app:app --port ${port}
    port: auto
  - name: frontend
    cmd: npm run dev -- --port ${port} --strictPort
    port: auto
    depends_on: [api]
    env:
      VITE_API_URL: ${api.url}
```

`sonar start`는 시작하는 모든 `port: auto` 서비스에 대해 사용 가능한 포트를 점유한다. 같은 체크아웃에서는 매번 동일한 포트를, 다른 체크아웃에서는 각기 다른 포트를 점유하므로, 워크트리가 메인 체크아웃과 충돌하지 않는다. 서비스는 이 포트를 `PORT`, `SONAR_PORT`, `${port}`로 받으며, 반드시 이를 사용해야 한다 — `PORT`를 읽거나 명령줄에서 `${port}`를 전달해야 한다. 이미 실행 중인 서비스는 자신의 포트를 유지하므로, 나중에 시작된 서비스도 그 포트를 찾을 수 있다. 할당된 포트에 대한 점유는 마지막 시작 시점으로부터 하루 동안 유지되며, `claims.ttl`로 이를 변경할 수 있다 (The daemon 참조).

`${port}`와 `${url}` (`http://localhost:<port>`)은 서비스 자신의 것이고, `${<service>.port}`와 `${<service>.url}`은 다른 서비스의 것이다. 이들은 `cmd`와 `env`에서 동작한다. 파일에 없는 서비스나 포트가 없는 서비스를 참조하면 파일을 로드할 때 오류가 발생한다. `${`와 `}` 사이의 다른 것들, 예를 들어 `${HOME}`은 작성된 그대로 남는다.

`sonar.yml`이라고 표기해도 읽힌다. `sonar init`은 항상 `sonar.yaml`을 작성한다. 이 파일은 예전에 닷파일 `.sonar.yaml`이었으며, 그 이름도 여전히 동작한다. sonar는 `sonar.yaml`, `sonar.yml`, `.sonar.yaml`, `.sonar.yml` 순서로 찾아서 처음 발견한 것을 읽는다. 편집 내용은 sonar가 읽은 파일로 다시 기록되므로, 몰래 이름이 바뀌는 일은 없다. `sonar doctor`는 예전 이름의 파일을 지적하고, `sonar doctor --fix`는 이름을 변경한다 (파일이 추적 중이면 `git mv` 사용). 데몬은 자신이 알고 있는 프로젝트를 감시하며 재시작 없이 파일 편집을 반영한다. sonar가 수행하는 모든 편집 — 데스크톱 앱에서, `sonar groups add`, `rename`, `remove`에서, 에이전트에서 — 은 데몬을 거치며, 데몬은 자체 구문 트리에서 파일을 다시 렌더링하므로, 서비스를 추가·이름 변경·제거하는 편집에서도 주석, 키 순서, 레이아웃이 메타데이터 변경에서와 마찬가지로 유지된다. 단 하나의 예외: 후행 주석을 정렬하기 위한 추가 공백(`cmd: x     # note`)은 하나로 축소되는데, YAML 라이브러리가 주석은 유지하지만 그 열 위치는 유지하지 않기 때문이다.

#### `sonar env`

파일이 무엇으로 해석되는지는 아무것도 시작하지 않고도 확인할 수 있다:

```sh
sonar env                      # every service: port, url and its expanded env
sonar env frontend             # one service, as export lines
sonar env --json               # for tools
```

```
SERVICE   PORT   URL                     ENV
db        5432   http://localhost:5432
api       21408  http://localhost:21408  DB_URL=postgres://localhost:5432/app
frontend  21409  http://localhost:21409  VITE_API_URL=http://localhost:21408
```

`port: auto`인 서비스가 실행 중이 아닐 경우 여기에서 클레임이 부여되며, 이는 `sonar start`가 하는 것과 동일한 클레임이므로 `sonar env`가 출력하는 것이 나중에 시작할 때 바인딩되는 것입니다. 이미 실행 중인 서비스는 현재 사용 중인 포트를 유지합니다. 이름이 지정된 경우 서비스는 `export` 줄로 출력되므로 셸에서 해당 서비스가 무엇을 할지 확인할 수 있습니다:

```sh
eval "$(sonar env frontend)" && npm test
```

그 뒤에는 데몬의 `groups.env`가 있으며, 이는 서비스가 존재하기 전에 워크트리를 연결하는 편집기나 에이전트를 위한 것입니다.

### `sonar up`

```sh
sonar up                       # the sonar.yaml at or above this directory
sonar up my-app                # a group by name
sonar up --only api,frontend
sonar up --json
```

`sonar up`은 `sonar start -d`이며, 어디서든 그룹의 이름을 지정하여 다른 호스트에서 시작할 수도 있습니다. 그룹의 `sonar.yaml`이 선언한 모든 서비스를 `depends_on` 순서대로 시작합니다:
서비스는 시작되기 전에 의존성이 선언한 포트를 기다리며, 이미 수신 중인 서비스는 건너뜁니다. 각 서비스는 자체 프로세스 그룹에서 분리되어 실행되며, 출력은 `~/.config/sonar/logs/<group>/<service>.log`에 저장되고, `sonar up`을 실행한 셸의 환경에 포트가 있는 서비스의 경우 `PORT`가 추가됩니다.

```
  ✓ db        http://localhost:5432  pid 41022  ~/.config/sonar/logs/my-app/db.log
  - api       already running
  ✓ frontend  http://localhost:5173  pid 41108  ~/.config/sonar/logs/my-app/frontend.log

2 started, 1 already running
```

시작에 실패한 서비스는 별도의 줄에 보고되며, 다른 어떤 문제가 발생하더라도 명령이 0이 아닌 값으로 종료되게 합니다. `sonar down`으로 모두 다시 중지하세요.
`sonar up`은 데몬이 필요하며, 아직 실행 중이 아니면 시작합니다.

### `sonar down`

```sh
sonar down                     # the project in the nearest sonar.yaml
sonar down my-app              # a group by name
sonar down --only api,worker   # only these services
```

프로젝트의 모든 서비스를 중지합니다 — 프로젝트가 수신 대기하는 모든 포트와, 워커처럼 포트를 점유하지 않으면서 sonar가 프로젝트를 위해 시작한 모든 서비스를 중지하고, sonar가 `port: auto` 서비스를 위해 점유한 포트를 해제합니다. `--only`는 이 모든 동작을 지정된 서비스로 좁히며, 이는 `sonar up --only`가 일부만 시작하는 방식과 같습니다. 파일이 선언하지 않은 이름은 오류입니다. `sonar kill -g my-app`은 포트를 중지하고 아무것도 해제하지 않습니다.

### `sonar groups` 및 `sonar init`

```sh
sonar init --dry-run
sonar init --service api:8000:/healthz --service web:5173
sonar groups
sonar groups --json

group=$(basename "$PWD")           # sonar init names the group after the directory
sonar groups add "$group" worker --port 9000 --cmd 'uv run worker' --depends-on api
sonar groups rename "$group" worker jobs
sonar groups remove "$group" jobs
# check
```

`sonar groups`는 sonar가 볼 수 있는 모든 그룹과 각 이름의 출처를 나열합니다:
`manual`(`sonar assign`으로 직접 고정), `start`(`sonar start` 실행),
`file`(`sonar.yaml`) 또는 `auto`(git 루트 또는 Compose 프로젝트).
`sonar groups <name>`은 한 그룹의 포트와 서비스, 그리고 선언되었지만
실행 중이 아닌 서비스를 보여줍니다.

`sonar init`은 파악할 수 있는 내용을 바탕으로 git 루트에 `sonar.yaml`을 작성합니다:
현재 프로젝트 내부에서 수신 대기 중인 포트(데스크톱 앱과 1024 미만 포트는 제외),
그리고 compose 파일이나 `package.json`이 명시적으로 선언한 내용 — compose 서비스당
하나의 서비스, 게시된 포트와 `depends_on`, 그리고 lockfile이 지정하는 패키지
관리자로 실행되는 `dev` 스크립트. 둘이 불일치할 경우 수신 대기 포트가 우선합니다:
그것은 진술이 아니라 증거이기 때문입니다. 작성된 파일에는 파악하지 못한 내용이
명시됩니다.

그 외에는 아무것도 감지되지 않습니다. Makefile 타깃, Procfile 줄, 프레임워크
내부에 묻혀 있는 진입점 — 이들은 저장소에 대한 추측일 뿐이며, 그것들을 표로
만드는 일은 끝나지 않을 것입니다. 그 부분은 에이전트에게 맡깁니다:

```sh
sonar init --agent              # whichever agent is installed
sonar init --agent codex        # name one
sonar init --agent claude -- --allow-dangerously-skip-permissions
```

`--agent`는 이미 가지고 있는 코딩 에이전트를 이 터미널에서 열고, 프롬프트를 이미 전송한 상태로 실행합니다: sonar가 알고 있는 것, 작성했을 초안, 형식, 그리고 파일을 작성하고 아무것도 시작하지 않는다는 규칙을 전달합니다. 여러분은 평소처럼 에이전트가 저장소를 읽고 편집을 승인하는 것을 지켜봅니다 — 그것은 여러분의 에이전트이고, 여러분의 권한 아래에 있습니다 — 그리고 `--` 뒤의 내용은 에이전트에게 전달됩니다. sonar는 `claude`, `codex`, `cursor-agent`, `opencode`를 알고 있으며, 여러 개가 설치되어 있으면 하나를 지정하세요. 에이전트가 종료되면 sonar는 파일을 로드하고 선언된 서비스를 출력하거나, 로드되지 않는 이유를 출력합니다. 터미널이 없는 경우 — 파이프, CI — `--agent`는 아무것도 시작하지 않고 프롬프트를 출력합니다.

`--force` 없이는 덮어쓰기를 거부하며, `--dry-run`은 파일을 작성하는 대신 출력합니다. `--merge`는 이미 존재하는 파일에 추가하는 대신 거부하며, `--service name:port[:health]` — 반복 가능 — 는 발견한 서비스 대신 지정한 서비스를 작성하고, 유지한 포트에 대해 추측한 명령을 유지합니다. `--force`와 `--merge`는 상호 배타적입니다.

`sonar groups add <group> <name> --port N`은 해당 그룹의 `sonar.yaml`에 서비스를 추가하며, 나머지 항목을 위해 `--cmd`, `--cwd`, `--health`, `--description`, `--icon`, `--color`와 반복 가능한 `--depends-on`을 사용합니다. `sonar groups rename <group> <old> <new>`는 파일 전체에서 하나의 이름을 바꾸며, `depends_on` 참조도 포함합니다. 그리고 `sonar groups remove <group> <name>`은 하나를 삭제하고 그것을 지명한 모든 `depends_on`에서 제거합니다. 세 명령 모두 파일을 유효하지 않게 만들 편집 — 중복 이름, 다른 서비스가 이미 차지한 포트, 존재하지 않는 서비스 — 을 거부하며, 전체 편집이 유효하다고 확인되기 전까지 단 한 바이트도 작성하지 않습니다.

데몬이 작성을 수행하기 때문에, 편집이 CLI, 데스크톱 앱 또는 에이전트에서 왔든 파일은 주석과 키 순서가 그대로 유지된 채로 돌아옵니다. `sonar groups add`, `rename`, `remove`는 데몬이 필요하며 실행 중이 아니면 시작합니다. 세 이름은 하위 명령이므로, 실제로 `add`라는 그룹은 `sonar groups --json`으로 읽습니다.

### `sonar kill`

```sh
sonar kill 3000                            # SIGTERM, then SIGKILL after 5s
sonar kill 3000 5432 -f                    # SIGKILL both straight away
sonar kill 3000 --tree                     # the listener and everything below it
sonar kill --pid 12345 --tree              # by process id
sonar kill -g my-app                       # a whole group, confirms unless -y
sonar kill --all --filter docker -y        # every container publishing a port
sonar kill --all --project my-app          # one Compose project
sonar kill 3000 --ip 127.0.0.1             # one bind address of several
sonar kill --all --dry-run --json          # the plan for the whole machine
```

`--dry-run`은 어떤 선택자든 받아들이고 아무것도 변경하지 않습니다. 종료가 수행할 작업을 자식부터 먼저 출력하고 모든 것을 실행 상태로 둡니다. 직접 만든 리스너를 대상으로 한 엔드 투 엔드 테스트:

```sh
sonar start --detach --name plan --port 8231 -- sonar map 3000 8231
sonar wait 8231
sonar kill 8231 --dry-run --json           # the plan; the mapping keeps running
sonar kill 8231 -y                         # and now for real
# check
```

위치 인수는 포트로 읽히고, 해당 번호에서 수신 대기 중인 것이 없을 때만 pid로 읽힌다. `-g`는 해석된 그룹, 레거시 실행 태그 또는 id, 그리고 Compose 프로젝트를 대소문자 구분 없이 매칭한다.

SIGTERM을 무시하는 프로세스는 `--grace`(5초) 후에도 포트가 여전히 수신 대기 중이면 SIGKILL이 전송된다. `--no-escalate`는 이를 비활성화한다. 자식이 부모보다 먼저 시그널을 받으므로 트리는 순서대로 종료된다. Docker 컨테이너는 `docker stop`으로 중지되며 시그널을 받지 않는다. `sonar start`로 시작된 리스너는 항상 해당 프로세스 그룹과 함께 중지된다.

`--json`은 프로세스당 한 행을 출력한다:
`{port, bind_address, pid, name, method, ok, error}`, 여기서 `method`는 `sigterm`, `sigkill`, `docker_stop`, `map_stop` 또는 `none`이다. 빈 스윕은 0으로 종료되고, 알 수 없는 그룹은 1로 종료된다.

### `sonar map`

```sh
sonar map 6873 3002        # also serve the service on 6873 from port 3002
```

포그라운드에서 TCP 프록시를 중지할 때까지 실행합니다. `sonar kill`은 중지한 매핑을 `map_stop`으로 보고합니다.

### `sonar rename`, `sonar assign`, `sonar history`

```sh
sonar rename 3000 storefront     # a name of your own, survives restarts
sonar rename 3000 --clear
sonar assign 3000 my-app         # pin a port to a group by hand
sonar assign 3000 --clear
sonar history                    # everything that came up, went down, restarted
sonar history 3000 --since 24h --limit 20
```

```sh
sonar history --since 1h
sonar history --json
# check
```

이름과 핀은 sonar의 데이터베이스에 저장되며, 포트에 대해 알려진 가장 구체적인 항목을 기준으로 키가 지정됩니다: 실행(`run:<group>/<name>`), 컨테이너(`docker:<project>/<service>`), 작업 디렉터리, 그리고 마지막으로 포트 번호 순입니다. 이름이 변경된 개발 서버는 재시작 후에도 이름을 유지하며, 포트 3000에만 핀된 이름은 그곳에 응답하는 모든 항목에 적용됩니다. 이 세 가지 명령은 데몬이 필요하며, 실행 중이 아니면 데몬을 시작합니다.

### 포트 읽기

```sh
sonar info 3000                            # command, user, bind, stats, health
sonar logs 3000                            # tail; docker logs for containers
sonar wait 5432 3000 --timeout 60s         # block until ready
sonar wait 5432 --http=/health             # wait for HTTP 200-399, not just TCP
sonar next 3000                            # first free port from 3000
sonar next 3000-3100 -n 3                  # three consecutive free ports
sonar graph                                # who is connected to whom
sonar graph --dot                          # Graphviz
sonar open 3000                            # open in the browser
sonar attach 3000                          # shell into the container, or TCP
sonar watch                                # live view
sonar watch --stats --notify
```

```sh
sonar next 3000
sonar next 3000-3100 -n 3 --json
sonar graph --json
sonar info --help
# check
```

`sonar wait`는 `0`(준비됨), `1`(시간 초과) 또는 `2`(중단됨)로 종료되므로,
무언가를 시작한 뒤 테스트하기 전에 넣기에 적합합니다:

```sh
docker compose up -d
sonar wait 5432 3000 --timeout 60s && npm run migrate && npm run test
```

**데몬 또는 직접 스캔.** 모든 읽기 명령은 데몬이 실행 중인지 확인하는데, 데몬이 이미 답을 가지고 있어 `lsof`를 포크할 필요가 없기 때문이다. 실행 중인 데몬이 없으면 직접 스캔하고 그 사실을 stderr에 한 줄로 출력한다. `sonar kill`도 같은 규칙을 따른다. 접근 가능한 데몬이 종료를 수행하므로 즉시 재스캔하고, 그 다음 답변과 포트 이력은 이미 해당 포트가 사라졌음을 알고 있다. 읽기도 종료도 몰래 데몬을 시작하지 않는다. `--no-daemon`은 직접 스캔을 조용히 강제하며 모든 명령에서 작동한다:

```sh
sonar list --no-daemon --json
# check
```

### `sonar host`

```sh
sonar host          # cpu, load, memory and disk of the machine sonar watches
sonar host --json
```

```sh
sonar host
# check
```

데몬은 스캔 주기에 맞춰 자신이 실행 중인 머신을 측정하고, 이를 스냅샷의 `hosts` 컬렉션에서 `localhost` 행으로 게시한다. 여기에는 OS와 커널, 업타임, CPU 사용률, 로드 평균, 메모리, 그리고 `/`를 담고 있는 디스크가 포함된다. CPU 사용률은 두 스캔 사이에 수행된 작업량이므로, 데몬이 두 번 스캔하기 전까지는 null이다. 플랫폼이 산출할 수 없는 수치 — 이를테면 로드 평균이 없는 Windows의 로드 평균 — 는 0이 아니라 null이다. `sonar remote add`로 등록된 모든 호스트는 자체 부하와 함께 같은 테이블에 합류한다. 이 명령에는 실행 중인 데몬이 필요하다. 백분율을 측정하는 기준이 되는 이전 샘플을 보유하는 것이 바로 데몬이기 때문이다.

GPU는 호스트 아래에 사용률과 메모리와 함께 나열된다. macOS에서는 `ioreg`에서 가져오며(Apple silicon 메모리는 통합되어 있으므로 GPU가 보유한 것만 표시된다), Linux에서는 `nvidia-smi` 또는 amdgpu의 sysfs 카운터에서 가져온다. 데몬은 이를 백그라운드에서 5초마다 읽으며, 명령의 경로에서는 결코 읽지 않는다. 소스가 없는 곳(Windows, Intel 전용 Linux)에서는 `gpus`가 null이고, GPU가 없는 머신에서는 `[]`이다.

### `sonar remote install`

```sh
sonar remote install [email protected]        # same version as this sonar
sonar remote install hetzner --version v0.6.0  # a Host from ~/.ssh/config
sonar remote install deploy@box --no-service   # the binary, no daemon
```

이미 ssh로 접속할 수 있는 호스트에 sonar를 설치하고 그곳에서 데몬을 시작한다. 릴리스 아카이브는 **원격 호스트에서** 다운로드되고 체크섬이 검증된다 — 이 머신에서 복사되는 것은 아무것도 없다 — 그리고 바이너리는 `~/.local/bin/sonar`에 위치하므로, 어느 것도 root 권한이 필요하지 않다. 데몬은 호스트에 systemd user unit이 있으면 그곳에서 실행되고(`~/.config/systemd/user/sonar.service`), 없으면 분리된 프로세스로 실행된다; 사용자 세션이 로그아웃 시 종료되어 데몬을 함께 가져갈 상황에서는 `loginctl enable-linger`가 조언으로 출력된다.

설치되는 버전은 실행한 sonar의 버전이므로, 양쪽 끝이 동일한 프로토콜로 통신한다. 다시 실행하면 제자리에서 업그레이드하고 데몬을 재시작하는데, 이것이 설치와 업데이트를 동일한 명령으로 만드는 이유다.

대상은 `ssh`에 그대로 전달된다: `~/.ssh/config`의 `Host` 별칭이 작동하며, 그것이 설정하는 `ProxyJump`, `IdentityFile`, `Port`도 마찬가지다. `--identity`와 `--ssh-arg`는 config가 다루지 않는 플래그를 위해 존재한다.

### `sonar remote`

```sh
sonar remote add [email protected]            # name taken from the target
sonar remote add hetzner [email protected]    # or given
sonar remote list                              # status, latency, version, load
sonar remote remove hetzner

sonar list --host hetzner                      # that host's ports
sonar list --host "*"                          # every host, with a HOST column
sonar info 3000 --host hetzner
```

등록된 호스트는 동일한 데몬을 실행하며, 이 머신의 데몬은 그 호스트에 대한 SSH 연결을 하나 유지한다 — `ssh <target> sonar daemon stdio`, 원격 `PATH`보다 `~/.local/bin`을 먼저 찾는다 — 그리고 보고하는 내용을 모든 클라이언트가 이미 읽는 상태로 멀티플렉싱한다. 어디에도 새로운 리스닝은 없다: 원격 데몬의 소켓은 SSH 사용자에게만 비공개로 유지되며, 클라이언트는 결코 직접 SSH를 사용하지 않는다.

이제 모든 행은 자신이 온 호스트를 함께 가진다. 로컬 행은 `localhost`라고 표시하고 원래부터 가지고 있던 키를 그대로 유지하므로, 오늘 sonar를 읽는 어떤 것도 바뀌지 않는다; 원격 행은 등록된 이름을 표시하고 `<host>/<port>:<bind>`로 키가 지정되며, 이것이 두 머신의 포트 3000이 두 개의 행이 되게 하는 것이다. 구독자는 더 요청하지 않는 한 localhost만 본다 (`state.subscribe {"hosts": ["*"]}`).

대상은 그대로 `ssh`로 전달되므로 `~/.ssh/config` 별칭, `ProxyJump` 및 아이덴티티가 모두 적용된다; `--ssh-arg`, `--identity` 및 `--port`는 config가 다루지 않는 부분을 커버하며, `--remote-bin`은 다른 곳에 있는 sonar를 지정한다. 기본 명령은 `sh`를 통해 실행되므로, sonar가 PowerShell 설치 프로그램에서 오는 Windows 호스트는 `--remote-bin sonar`가 필요하다. sonar는 비밀번호도 키도 저장하지 않는다. 사라진 호스트는 데몬이 재시도하는 동안 행과 상태를 유지하며, 등록된 상태로 남아 있는 한 1초에서 30초까지 백오프한다.

`--host`는 또한 sonar가 전혀 알지 못하는 단순한 `user@host`도 여전히 받는다: 이 경우 에이전트 없는 `ssh` + `ss`/`lsof` 스캔으로 폴백하고 `sonar remote install` 힌트를 출력한다.

#### 다른 머신에서 작업하기

---

[Read more](https://github.com/raskrebs/sonar)
도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →