procinfo

مفتش عمليات محمول لأنظمة Linux وmacOS. احصل على تفاصيل أي عملية قيد التشغيل فورًا!

انظر أيضًا إلى procinfo_minimal.sh - تطبيق sh خالص لـ procinfo.

التثبيت

curl -fsSL https://raw.githubusercontent.com/wenekar/procinfo/main/procinfo.sh -o procinfo
chmod +x procinfo
sudo mv procinfo /usr/local/bin/

أو فقط انسخ السكربت. إنه سكربت bash لا يعتمد على أي شيء سوى أدوات يونكس القياسية (ps, lsof, pgrep). أو الأفضل من ذلك، انسخ أجزاءً منه وادمجها لتصنع سكربتًا واحدًا يلبي احتياجاتك الخاصة!

الميزات

• متعدد المنصات - يعمل على Linux وmacOS (لا ويندوز؟)
• صفر تبعيات - باستثناء bash وأدوات يونكس القياسية، وربما نظام تشغيل.
• شجرة العمليات - معرفة جميع العمليات الأب لعملية معيّنة. (صادم!)
• فحص البيئة - عرض متغيرات البيئة ENV لعملية معيّنة (-V أو --env)
• التكامل مع systemd - إذا كانت العملية تابعة لخدمة .service، يعرض المسار إلى ملف الخدمة هذا.
• التكامل مع SSH - اعرض فورًا user@IP لجلسة ssh التي بدأت العملية.
• التكامل مع git - هل تنتمي العملية إلى مستودع git؟ شاهد الفرع وعنوان URL البعيد مباشرةً في المخرجات.
• يدرك Docker - يكتشف الحاويات وملفات compose ومعرّف الحاوية واسم الصورة وارتباطات المنافذ... قد يُضاف مزيد من المعلومات لاحقًا.
• معلومات الشبكة - يعرض جميع المنافذ المستمعَة لعملية معيّنة.
• قائمة المنافذ - مخرجات ss -tunlp بشكل جميل للجميع!
• كشف الأقفال - يعرض ملفات القفل والملفات المفتوحة للعملية.
• صيغ متعددة - صيغة قابلة للقراءة البشرية، أو سطر واحد قصير، أو JSON
• غير حساس لحالة الأحرف - procinfo nginx يطابق Nginx وNGINX وغيرها.
• وضع TUI مع fzf - يتبيّن أن fzf رائع نوعًا ما! انتبه، هذا ليس بديلًا عن top، بل صُمم لرؤية المنافذ المفتوحة، وليس كل العمليات.

المتطلبات

procinfo:

• نظام شبيه بيونكس
• bash
• ps
• lsof
• pgrep

التبعيات الاختيارية:

• docker
• git
• systemctl
• whatis (مضمّن مع man)
• jq (دعم مخرجات JSON)
• fzf (وضع TUI)

procinfo_minimal:

• sh

الاستخدام

# Interactive TUI mode (requires fzf)
procinfo --tui

# By process name
procinfo nginx

# By port
procinfo --port 3306

# By PID
procinfo --pid 1234

# One-line output
procinfo --short nginx

# JSON output (requires jq)
procinfo --json nginx

مثال على المخرجات

Target      : godot

Process     : godot.linuxbsd. (pid 234167)
User        : wenekar
Command     : ./bin/godot.linuxbsd.editor.x86_64 --verbose
Started at  : Wed Dec 31 19:12:10 2025
Running for : 1 minute, 6 seconds
RSS Memory  : 330 MB

Process tree:
  systemd (pid 1) → systemd (pid 1141) → konsole (pid 1725) → fish (pid 233851) → godot.linuxbsd. (pid 234167)

Source      : interactive fish shell
git info    : godot (fix-libdecor-ssd-fallback) - [email protected]:wenekar/godot.git
Working Dir : /mnt/Sandisk480/GitHub/godot
Open files  : /memfd:kwin-xkb-keymap-shared
              /memfd:wayland-cursor

حاوية Docker

عند فحص منفذ مرتبط بحاوية Docker:

Target      : port 6379

Process     : docker-proxy (pid 31782)
User        : root
Command     : /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 6379 -container-ip 172.18.0.2 -container-port 6379 -use-listen-fd
Started at  : Wed Dec 31 01:45:01 2025
Running for : 17 hours, 28 minutes, 39 seconds
RSS Memory  : 6 MB

Process tree:
  systemd (pid 1) → dockerd (pid 25817) → docker-proxy (pid 31782)

Source      : container runtime
git info    : not found
Working Dir : /
Listening   : *:6379

Docker info :
  Container : redis (463ab2f88502)
  Image     : redis
  Compose   : backend_test (/home/wenekar/backend_test/docker-compose.yml)
  Internal  : 172.18.0.2:6379

Docker cheatsheet:
  docker logs redis
  docker exec -it redis sh
  docker top redis
  docker ps //see all containers

الخيارات

لماذا؟

رأيت إعلانًا على TikTok عن مشروع اسمه witr، رابط فيديو TikTok المذكور. ثم فكّرت في نفسي، من هو المستخدم المستهدف؟ لمن صُنع هذا الملف التنفيذي؟ أليس هذا مجرد غلاف bash لأمر ps -p؟

وهكذا وُلد procinfo، واتضح أن أنا هو المستخدم المستهدف. اطّلع أيضًا على القضية 32.

الترخيص

MIT