할 수 있는 일
LAN-Orangutan is a self-hosted network discovery tool. Find every device on your LAN, label and group them, snapshot your network and compare it later, and get flagged when something unexpected shows up. Single binary, no setup, Tailscale built in. Built by 291 Group.
제작자가 쓴 원문
- 연결 방식 AI가 읽는 지시 파일이며, 외부 서비스를 호출하는 단계가 있습니다
- 계정 또는 키 ORANGUTAN_TOKEN의 키가 필요한 단계가 있습니다 (README 기준)
- 분류 기타
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/291-group-lan-orangutan)비슷한 Skill
같은 종류의 작업, Skill 목록과 같은 순서
| 이 항목 LAN-Orangutan | llmfit | claude-video | VideoCaptioner | claude-cookbooks | |
|---|---|---|---|---|---|
| 제작자 | 291-Group | AlexsJones | bradautomates | WEIFENG2333 | anthropics |
| Skill 수 | 1 | 1 | 1 | 1 | 4 |
| GitHub 별 | 1,159 | 39,096 | 21,249 | 16,577 | 54,867 |
| 마지막 코드 변경 | 2026년 11월 19일 | 2026년 11월 18일 | 2026년 9월 25일 | 2026년 9월 12일 | 2026년 11월 17일 |
| 라이선스 | MIT | MIT | MIT | GPL-3.0 | MIT |
291-Group의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
Skill과 MCP의 차이
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
쓸 수 있는 앱
제작자가 밝히지 않음 · SKILL.md 형식 Skill은 Claude Code, Codex, Cursor 같은 Agent Skills 지원 앱에서 써요
설치
안전한가요?
- 만든 사람
GitHub 계정 291-Group(조직), 만든 지 1년
- 사용 현황과 관리
★ 1,159개 · 코드 마지막 수정 2026년 11월 19일
- 스크립트가 있나요?
없습니다. 텍스트 파일뿐이며 AI가 읽고 그대로 따릅니다
- 인터넷을 사용하나요?
스크립트가 없어서 스스로 인터넷에 접속하지 않습니다
- 컴퓨터 전체 설정을 바꾸나요?
hook이나 컴퓨터 설정을 쓰는 동작을 찾지 못했습니다
저장소 commit ee6952f의 파일을 자동으로 검사했습니다(읽기만 했고 아무것도 실행하지 않았습니다). 안전을 보증하는 것은 아니니, 직접 읽어 보고 판단하세요
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
방법 1claude.ai에 업로드(웹과 앱)
설명이 200자를 넘어서(368자) claude.ai에 업로드할 수 없습니다. 대신 "AI가 대신 설치하기"를 사용하세요
방법 1Claude Code에게 설치 맡기기
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Claude Code를 다시 열고 /lan-orangutan를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
Terminal을 쓰는 분께
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
ChatGPT 데스크톱 앱
ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
방법 1ChatGPT에게 설치 맡기기
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
방법 2폴더를 직접 넣기
lan-orangutan 폴더를 ~/.agents/skills/lan-orangutan에 넣으세요
~는 홈 폴더($HOME)입니다
Terminal을 쓰는 분께
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.agents/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
설치한 뒤
- ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
- 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
- Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
웹과 모바일의 ChatGPT
직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다
이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
방법 1Codex에게 설치 맡기기
이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
Terminal을 쓰는 분께
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.agents/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요
방법 1Cursor에게 설치 맡기기
이 문장을 복사해 Cursor 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Cursor Agent 채팅에서 /를 입력하고 lan-orangutan 선택
Checked against official docs 2026년 11월 12일 · Source: cursor.com
Terminal을 쓰는 분께
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.cursor/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Cursor Agent 채팅에서 /를 입력하고 lan-orangutan 선택
방법 1AI가 대신 설치하기
Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · 이 문장을 복사해서 앱의 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Terminal을 쓰는 분께
Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.
2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인
원본 SKILL.md 보기
아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요
처음 8,000자 표시 · GitHub에서 전체 파일 열기
---
name: lan-orangutan
description: Install, run and operate LAN Orangutan, a self-hosted network scanner that discovers and tracks the devices on a local network. Use when the user wants to find what is on their network, install or set up LAN Orangutan, scan, list, rename, label, group or locate devices, compare snapshots, set up change notifications (webhooks), or script against its CLI or REST API.
---
# LAN Orangutan
LAN Orangutan discovers the devices on a local network with nmap and the machine's own ARP and neighbour tables, and keeps an inventory of them: addresses, MAC, manufacturer, type, and whatever names, groups, locations and notes the user adds. It is one binary with a web dashboard (port 291 by default), a CLI that can do everything the dashboard can, and a REST API.
Project and full documentation: https://github.com/291-Group/LAN-Orangutan
## Ground rules
- Scanning a network is only appropriate on networks the user owns or administers. If it is unclear whose network it is, ask.
- Ask before anything that removes or replaces data: `device delete`, `groups delete`, `groups reset`, `locations delete`, `locations prune`, `snapshot delete`, `webhook delete`, `restore`, and `token create` (which replaces the existing token).
- Never put LAN Orangutan on a public interface or forward port 291 from the internet. Never suggest `allow_insecure` unless a reverse proxy or firewall in front of it already handles authentication.
- Treat the API token and webhook URLs as secrets. Do not echo them back into the conversation, write them into shared files, or put them in command history when an environment variable will do.
- The user sets the dashboard password themselves in the browser. Do not choose one for them unless they ask for an unattended install, and then use `ORANGUTAN_PASSWORD_FILE` rather than a plain variable.
## Installing
nmap is required on every platform except Docker, where it is bundled.
| Platform | Install |
|---|---|
| macOS | `brew install nmap` then `brew install 291-group/tap/lan-orangutan` |
| Windows | Install nmap from nmap.org, then `scoop bucket add 291group https://github.com/291-Group/scoop-bucket` and `scoop install lan-orangutan` |
| Debian, Ubuntu, Raspberry Pi OS | `sudo apt install nmap`, then the `.deb` for the architecture from the Releases page. Runs as a root service |
| Fedora, RHEL | `.rpm` from the Releases page |
| Alpine | `.apk` from the Releases page |
| Docker | Linux only, with host networking: `curl -O https://raw.githubusercontent.com/291-Group/LAN-Orangutan/main/docker-compose.yml` then `docker compose up -d` |
| Anything else | The binary for the platform from https://github.com/291-Group/LAN-Orangutan/releases |
Do not install the Docker image on Docker Desktop for macOS or Windows. The container runs inside a virtual machine there, so it cannot see the real network and a scan reports devices that do not exist. Use the native binary on those systems. On Linux, the container needs `network_mode: host` plus the `NET_RAW` and `NET_ADMIN` capabilities, which the compose file already sets; on bridge networking it finds nothing.
### Running it
```bash
sudo orangutan serve # Linux and macOS; Windows: run orangutan.exe serve as Administrator
```
Then open `http://localhost:291`, or `http://<that-machine>:291` from another computer. The first visit asks for a password, and nothing is reachable until one is set. That is the whole setup.
Root or Administrator is what lets nmap read MAC addresses and manufacturers. Without it, discovery still works but those two columns stay empty.
Useful variations:
- `orangutan serve --bind 127.0.0.1` keeps it to this machine, and then no password is needed.
- `orangutan serve --port 8080` uses another port.
- `ORANGUTAN_NETWORKS=192.168.10.0/24,10.0.5.0/24` adds networks reached through a router or VLAN, which are never detected on their own. Those results have no MAC or manufacturer, because ARP does not cross a router.
## Using the CLI
The CLI reads and writes the same data folder as the server. A running server sees device, group, location, snapshot and webhook changes straight away, and settings changes by its next scan. That only holds when both use the same folder, which means the same user and the same data directory:
- Run the CLI as the same user as the server. A server started with `sudo` or installed as a package service runs as root, so use `sudo orangutan ...` for the CLI too.
- In Docker, run the CLI inside the container: `docker exec lan-orangutan orangutan list`.
- `orangutan config` prints the `data_dir` in use. `ORANGUTAN_DATA_DIR` overrides it.
- `orangutan config` and `orangutan status` show the port and bind address from the config file. A server started with `--port` or `--bind` differs; `GET /api/status` reports what the running server actually uses.
- A "permission denied" on the device list means the data belongs to another user, usually root.
For anything a program will read, ask for JSON. Most commands take `--format json`, and `list` also takes `--format csv`.
### Seeing the network
```bash
sudo orangutan scan all # Scan every detected network
sudo orangutan scan 192.168.1.0/24 # Scan one network
orangutan list --format json # Every device
orangutan list --online # Only what is up now
orangutan list --type Printer # Also --group, --location, --offline
orangutan device show 192.168.1.20 # Everything stored for one device
orangutan networks # Networks that would be scanned
orangutan status --format json # Tools found, storage, networks, config
```
`scan` exits with 0 when every network was scanned, 1 when nothing could be scanned, and 2 when nmap failed everywhere but the ARP table still gave a partial list.
In the CLI's JSON, `hostname` is what to show: the user's own name when one is set (`custom_hostname`), otherwise the scanned one (`scanned_hostname`). The API differs, see below. `online` is a boolean; a device counts as offline after an hour unseen.
### Organising devices
```bash
orangutan device set 192.168.1.20 --hostname "Living Room TV" --group Family --location "Living Room"
orangutan device set 192.168.1.20 --hostname "" # Back to the scanned name
orangutan device set 192.168.1.30 --type Printer # Or --type auto to detect again
orangutan device set 192.168.1.30 --label NAS --notes "Rack, shelf 2" --expected
orangutan device expect-all # Mark everything present now as expected
orangutan groups add Office
orangutan groups rename Office Work
orangutan locations add Garage
orangutan locations rename "Living Room" Lounge
orangutan groups # List groups with device counts
orangutan locations # List locations with device counts
orangutan device set 192.168.1.20 --group "" --location "" --expected=false # Clear them
```
Only the flags passed are changed, and `""` clears a text field. Setting a location that does not exist yet adds it to the list, and it stays there after its last device leaves; `locations prune` removes empty ones (ask first). Types are Phone, Computer, Printer, TV, Media Player, Router, Server, IoT, Game Console, or auto. Labels are up to 64 characters and notes up to 1000. A custom hostname or type survives every later scan.
Marking devices as expected is what makes "unexpected device" and "missing device" notifications meaningful, so after a first scan on a quiet network, offer `device expect-all`.
### Tracking change
```bash
orangutan snapshot save "Before new router"
orangutan snapshot list # Newest is 1
orangutan snapshot compare 1 # Snapshot 1 against the network now
orangutan snapshot compare 2 1 # Between two snapshots
orangutan report # Self-contained HTML report of the whole network
orangutan backup 토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
GitHub 정보
- GitHub 스타
- 1,159
- 제작자
- 291-Group
- 라이선스
- MIT
- 최근 코드 수정
- 2026년 11월 19일
- repo 안 SKILL.md(번역본과 템플릿 포함)
- 1
- 토픽
- cli, device-discovery, golang, homelab, internet-of-things, lan, network-discovery, network-monitoring, network-monitoring-tool, network-scanner, networking, nmap