Skip to content
KitploitKITPLOIT
أدواتعمليات الاستغلالالمدونة
Log in
إرسال
أدواتعمليات الاستغلالالمدونة
إرسال

أدوات الاختراق واختبار الاختراق والأمن السيبراني لترسانتك الأمنية!

Kitploit هو دليل لأدوات الاختراق والأمن السيبراني واختبار الاختراق. اكتشف آخر تحديثات المشاريع للعثور على الثغرات وتحليل الأنظمة وأتمتة الاختبارات وتعزيز أمنك.

الخلاصاتاتصالالخصوصية© 2026 Kitploit

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
sonar — أداة سطر أوامر لفحص وإدارة الخدمات التي تستمع على منافذ localhost | Kitploit
أدوات/GitHubGitHub/raskrebs/sonar
أدوات عامةتخطيط الشبكةمسح المنافذالبرمجة النصية والأتمتةجمع المعلوماتDevSecOps
GitHubraskrebs/sonar

sonar

أداة سطر أوامر لفحص وإدارة الخدمات التي تستمع على منافذ localhost

عرض المستودع
1.1k3367منذ 12 أيامتمت المراجعة من قبل Kitploit
مشاركة
<div align="center">

```
██████    ███    ██████    ██    ██████
██           ██      ██  ██  ██      ██
██      ██   ██  ██  ██  ██  ██      ██
  ██  ██   ██  ██  ██  ██  ██  ████
    ██  ██       ██  ██  ██  ██  ██  ██
██████    ███    ██  ██  ██  ██  ██  ██
```
اعرف ما الذي يعمل على جهازك.

</div>

يعرض Sonar كل ما يستمع على localhost ويرتّبه: كل منفذ
ينتمي إلى **مجموعة** — عادةً المستودع الذي بدأ منه — وداخل
تلك المجموعة إلى **خدمة** مُسمّاة. ابدأ خوادم التطوير الخاصة بك باستخدام
`sonar start` وسيصبح المشروع بأكمله شيئًا واحدًا يمكنك سرده كشجرة،
والانتظار له، وتتبّع سجلاته، وإيقافه بأمر واحد. كما يتم التقاط حاويات 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
```

## ستون ثانية

صف كيفية تشغيل مشروعك في `sonar.yaml` في جذر المستودع، بدلاً من `dev.sh`:

```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` تُنفَّذ مقابل بناء جديد بواسطة
`scripts/readme-check.sh` في كل تشغيل لـ CI.

## الأوامر

### `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، حزم `.app` في macOS، خدمات `/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 الخدمات عبر الخدمة الخلفية (daemon)، ويتابع سجلاتها مع اسم الخدمة أمام كل سطر، وعندما تضغط على Ctrl+C يوقف الخدمات التي بدأها. أما الخدمة التي كانت تعمل بالفعل فيُتركها دون مساس، ويعود 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`، وإلا فإن `name` في أقرب `sonar.yaml`، وإلا فإن اسم دليل جذر git (تصبح worktree `repo@worktree`)، وإلا فإن اسم الدليل الحالي.
- **Name** — `--name`، وإلا فإن خدمة `sonar.yaml` التي يطابق `cmd` الخاص بها، وإلا فإنه يُستنتج من الأمر (`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` يشغّلها: المنفذ نفسه في كل مرة داخل نفس نسخة العمل، ومنفذ مختلف في كل نسخة عمل أخرى، بحيث لا يتعارض worktree مع النسخة الرئيسية أبدًا. تحصل الخدمة عليه عبر `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` عندما يكون الملف متتبعًا). يراقب الـ daemon المشاريع التي يعرفها ويلتقط التعديلات على الملف دون إعادة تشغيل. كل تعديل يجريه sonar — من تطبيق سطح المكتب، أو من `sonar groups add` و`rename` و`remove`، أو من وكيل — يمر عبر الـ daemon، الذي يعيد توليد الملف من شجرة الصياغة الخاصة به، فتبقى التعليقات وترتيب المفاتيح والتخطيط بعد تعديل يضيف خدمة أو يعيد تسميتها أو يحذفها تمامًا كما تبقى بعد تغيير في البيانات الوصفية. الاستثناء الوحيد: المسافات الإضافية التي تصفّف تعليقًا في نهاية السطر (`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
```

تُبلَّغ الخدمة التي تفشل في البدء على سطرها الخاص وتجعل الأمر
يخرج بقيمة غير صفرية، مهما ظهر غير ذلك. أوقفها جميعًا مرة أخرى باستخدام `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` يكتب ملف `sonar.yaml` في جذر git بناءً على ما يمكنه تحديده: المنافذ
المستمع عليها داخل المشروع الآن (تطبيقات سطح المكتب والمنافذ الأقل من 1024 مستبعدة)،
بالإضافة إلى ما يعلنه ملف compose أو `package.json` صراحةً — خدمة واحدة لكل خدمة compose،
مع منفذها المنشور و`depends_on` الخاص بها، وسكربت `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
```

يُقرأ الوسيط الموضعي كمنفذ، وكمعرّف عملية فقط عندما لا يستمع أي شيء على ذلك الرقم. يطابق `-g` المجموعة المُحلَّلة، أو وسم تشغيل قديم أو معرّفًا، ومشروع Compose، دون حساسية لحالة الأحرف.

تُرسل العملية التي تتجاهل SIGTERM إشارة SIGKILL بمجرد أن يظل المنفذ يستمع بعد `--grace` (5 ثوانٍ)؛ ويوقف `--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
```

**الخادم الخفي أو الفحص المباشر.** كل أمر قراءة يسأل الخادم الخفي إذا كان قيد التشغيل، لأنه يملك الإجابة بالفعل ولا يحتاج إلى fork `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
```

يقيس الخادم (daemon) جهازه الخاص وفق إيقاع الفحص وينشره كصف `localhost` في مجموعة `hosts` الخاصة باللقطة: نظام التشغيل والنواة، ومدة التشغيل، ونسبة المعالج، ومتوسط الحمل، والذاكرة، والقرص الذي يحتوي على `/`. نسبة المعالج هي العمل المنجز بين فحصين، لذا تكون فارغة (null) حتى يقوم الخادم بالفحص مرتين؛ وأي رقم لا تستطيع المنصة إنتاجه — مثل متوسط الحمل على Windows، الذي لا يملكه — يكون فارغًا (null) بدلًا من صفر. كل مضيف مسجَّل عبر `sonar remote add` ينضم إلى الجدول نفسه بحمله الخاص. يحتاج الأمر إلى خادم قيد التشغيل: فالخادم هو الذي يحتفظ بالعينة السابقة التي تُقاس النسبة مقابلها.

تُدرج وحدات معالجة الرسومات (GPUs) تحت مضيفها مع الاستخدام والذاكرة: من `ioreg` على macOS (ذاكرة Apple silicon موحّدة، لذا يُعرض فقط ما تحتفظ به وحدة معالجة الرسومات)، ومن `nvidia-smi` أو عدّادات sysfs الخاصة بـ amdgpu على Linux. يقرأها الخادم كل خمس ثوانٍ في الخلفية، وليس أبدًا في مسار أي أمر؛ تكون `gpus` فارغة (null) حيث لا يوجد مصدر (Windows، أو Linux بمعالج Intel فقط) و`[]` على جهاز بلا وحدة معالجة رسومات.

### `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
```

يضع sonar على مضيف يمكنك بالفعل الاتصال به عبر ssh ويبدأ خفيته هناك. يتم تنزيل أرشيف الإصدار والتحقق من مجموع التحقق **على المضيف البعيد** — لا يتم نسخ أي شيء من هذا الجهاز — ويستقر الملف التنفيذي في `~/.local/bin/sonar`، لذا لا يحتاج أي من ذلك إلى صلاحيات الجذر. تعمل الخفية كوحدة مستخدم systemd حيث يتوفر ذلك على المضيف (`~/.config/systemd/user/sonar.service`)، ومنفصلة حيث لا يتوفر؛ يتم طباعة `loginctl enable-linger` كنصيحة عندما تنتهي جلسة المستخدم عند تسجيل الخروج وتأخذ الخفية معها.

الإصدار المثبَّت هو إصدار sonar الذي شغّلته منه، لذا يتحدث الطرفان نفس البروتوكول. تشغيله مرة أخرى يرقّي في المكان ويعيد تشغيل الخفية، وهذا ما يجعل التثبيت والتحديث نفس الأمر.

---

[Read more](https://github.com/raskrebs/sonar)
تنزيل الأداة

الأكثر شعبية

عرض الكل →

اكتشف الأدوات الأكثر استخدامًا من قبل مجتمعنا.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 مجموعة أدوات OSINT المثالية: رسم بياني للتحقيق، وتقييم الثقة، وعائلات الأسماء المستعارة، وخريطة، وخط زمني، وتقارير. 49 وحدة، وأكثر من 400 موقع، دون الحاجة إلى مفاتيح API.

    891
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # تطبيق GhostLock للتنفيذ بنقرة واحدة (CVE-2026-43499)

    547
  • 3

    ARTEX

    baarai/artex

    منصة اختبار اختراق مستقلة متعددة الوكلاء تعتمد على LLM، مع وكلاء تخطيط وتنفيذ، ومخططات للأصول والاستكشاف، وتسجيل حركة مرور MITM، وإعادة اختبار الثغرات.

    369
  • 4

    redforge

    cybersecurity91/redforge

    مجموعة أدوات الفريق الأحمر في المتصفح مع 102 أداة دون اتصال للاستطلاع، وتوليد الحمولات، وهجمات بيانات الاعتماد، والتشفير، والترميز، وإعداد تقارير المهام.

    366
  • 5

    looking-glass

    anonghosty/looking-glass

    منصة CSIRT تستقبل تقارير Shadowserver في MongoDB وتعيد عرضها كخرائط تفاعلية وتحليلات ونتائج وإرشادات ولوحات معلومات تنفيذية.

    309
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    نظام العمل للأمن السيبراني الأصلي بالذكاء الاصطناعي — حيث تتحول النية إلى تنفيذ محكوم، وتصبح الأدلة ذاكرة تشغيلية، وكل عملية تحسن التي تليها.

    282

استكشف جميع الأدوات

تصفح مجموعتنا من الأدوات

عرض جميع الأدوات →