procinfo

Linux 및 macOS용 휴대용 프로세스 인스펙터. 실행 중인 모든 프로세스에 대한 세부 정보를 즉시 확인하세요!

procinfo_minimal.sh - procinfo의 순수 sh 구현도 확인하세요.

설치

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

아니면 스크립트를 복사해도 됩니다. 표준 Unix 도구(ps, lsof, pgrep) 외에는 의존성이 없는 bash 스크립트입니다. 또는 더 나은 방법은, 스크립트의 일부를 복사하여 결합하고, 특정 요구 사항을 충족하는 하나의 스크립트를 만드는 것입니다!

기능

크로스 플랫폼 - Linux 및 macOS에서 작동 (Windows는 제외?)
제로 의존성 - bash와 표준 Unix 도구, 그리고 운영체제만 있으면 됩니다.
프로세스 트리 - 주어진 프로세스의 모든 부모를 확인할 수 있습니다. (놀랍습니다!)
환경 변수 검사 - 주어진 프로세스의 ENV 변수를 확인합니다 (-V 또는 --env)
Systemd 통합 - 프로세스가 .service에 속한 경우 해당 .service 파일의 경로를 표시합니다.
SSH 통합 - 프로세스를 시작한 ssh 세션의 user@IP를 즉시 확인할 수 있습니다.
git 통합 - 프로세스가 git 저장소에 속해 있나요? 브랜치와 원격 URL을 출력에서 직접 확인하세요.
Docker 인식 - 컨테이너, 컴포즈, 컨테이너 ID, 이미지 이름, 포트 바인딩 등을 감지합니다. 나중에 더 많은 정보를 추가할 수도 있습니다.
네트워크 정보 - 프로세스의 모든 리스닝 포트를 표시합니다.
포트 목록 - 모두를 위한 예쁜 ss -tunlp 출력!
잠금 감지 - 프로세스의 잠금 파일과 열린 파일을 표시합니다.
여러 형식 - 사람이 읽을 수 있는 형식, 짧은 한 줄 형식, 또는 JSON
대소문자 구분 없음 - procinfo nginx는 Nginx, NGINX 등과 일치합니다.
fzf를 이용한 TUI 모드 - 알고 보니 fzf 꽤 괜찮네요! 주의: 이건 top 대체용이 아닙니다. 열린 포트를 확인할 때 사용하기 위한 것이지, 모든 프로세스를 보려는 것이 아닙니다.

요구 사항

procinfo:

UNIX 계열 시스템
bash
ps
lsof
pgrep

선택적 의존성:

docker
git
systemctl
whatis (man에 포함)
jq (JSON 출력 지원)
fzf (TUI 모드)

procinfo_minimal:

사용법

# 대화형 TUI 모드 (fzf 필요)
procinfo --tui

# 프로세스 이름으로
procinfo nginx

# 포트로
procinfo --port 3306

# PID로
procinfo --pid 1234

# 한 줄 출력
procinfo --short nginx

# JSON 출력 (jq 필요)
procinfo --json nginx

출력 예시

대상      : godot

프로세스     : godot.linuxbsd. (pid 234167)
사용자        : wenekar
명령어     : ./bin/godot.linuxbsd.editor.x86_64 --verbose
시작 시간  : Wed Dec 31 19:12:10 2025
실행 시간 : 1분 6초
RSS 메모리  : 330 MB

프로세스 트리:
  systemd (pid 1) → systemd (pid 1141) → konsole (pid 1725) → fish (pid 233851) → godot.linuxbsd. (pid 234167)

소스      : 대화형 fish 쉘
git 정보    : godot (fix-libdecor-ssd-fallback) - [email protected]:wenekar/godot.git
작업 디렉토리 : /mnt/Sandisk480/GitHub/godot
열린 파일  : /memfd:kwin-xkb-keymap-shared
              /memfd:wayland-cursor

Docker 컨테이너

Docker 컨테이너에 바인딩된 포트를 검사할 때:

대상      : 포트 6379

프로세스     : docker-proxy (pid 31782)
사용자        : root
명령어     : /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
시작 시간  : Wed Dec 31 01:45:01 2025
실행 시간 : 17시간 28분 39초
RSS 메모리  : 6 MB

프로세스 트리:
  systemd (pid 1) → dockerd (pid 25817) → docker-proxy (pid 31782)

소스      : 컨테이너 런타임
git 정보    : 찾을 수 없음
작업 디렉토리 : /
리스닝   : *:6379

Docker 정보 :
  컨테이너 : redis (463ab2f88502)
  이미지     : redis
  컴포즈   : backend_test (/home/wenekar/backend_test/docker-compose.yml)
  내부  : 172.18.0.2:6379

Docker 요령:
  docker logs redis
  docker exec -it redis sh
  docker top redis
  docker ps //모든 컨테이너 보기

옵션

왜 만들었나?

TikTok에서 witr라는 프로젝트 광고를 봤습니다. 해당 TikTok 동영상 링크. 그리고 나서 생각했습니다, 이 바이너리의 대상 사용자는 누구일까? 이건 그냥 ps -p의 bash 래퍼 아닌가?

그래서 procinfo가 탄생했습니다. 알고 보니, 내가 그 대상 사용자였습니다. 이슈 32도 참고하세요.

라이선스

MIT

`-p, --port <port>`	포트에서 리스닝 중인 프로세스 찾기
`-P, --pid <pid>`	특정 PID 검사
`-a, --all-ports`	모든 리스닝 포트 나열
`-t, --tui`	대화형 TUI 모드 (fzf 필요)
`-s, --short`	한 줄 출력 (프로세스 체인만)
`-j, --json`	JSON 출력 (jq 필요)
`-d, --description`	프로세스 설명 기다리기 (macOS에서 느림)
`--no-color`	색상 출력 비활성화
`-h, --help`	도움말 표시
`-v, --version`	버전 표시

procinfo

인기

procinfo

설치

기능

요구 사항

사용법

출력 예시

Docker 컨테이너

옵션

왜 만들었나?

라이선스