能做什么
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 |
Skill 和 MCP 有什么不同
MCP = 手
把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。
Skill = 手册
教 AI 怎么做某项工作的文本文件,不连接任何服务。
有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。
适用的应用
开发者未说明 · SKILL.md 形式的 Skill 可用于支持 Agent Skills 的应用,如 Claude Code、Codex 和 Cursor
安装
安全吗?
- 作者
GitHub 账号 291-Group(组织),已创建 1 年
- 使用与维护
★ 1,159 星 · 代码最近更新 2026年11月19日
- 有脚本吗?
没有,都是纯文本文件,由 AI 阅读后照做
- 会联网吗?
没有脚本,所以不会自己联网
- 会修改整台电脑的设置吗?
没有发现 hook 或写入电脑设置的操作
根据仓库 commit ee6952f 中的文件自动检查(只读取文件,没有运行任何内容)。这不是安全保证,请自己阅读后再决定
第一步:你用哪个 AI?
选择你用的应用,本页只显示该应用的安装方法
方式 1上传到 claude.ai(网页和应用)
无法上传到 claude.ai,因为描述超过 200 个字符(368 个字符)。请改用"让 AI 帮你安装"
方式 1让 Claude Code 帮你安装
复制这句话,粘贴到 Claude Code 的对话中
如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径
AI 会先说明要做什么,每一步都会征求你的同意
重新打开 Claude Code,输入 /lan-orangutan,或直接提出相关任务,Claude 会自动选用
Checked against official docs 2026年11月12日 · Source: code.claude.com
ChatGPT 桌面应用
ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill
方式 1让 ChatGPT 帮你安装
在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中
AI 在安装前一定会先告诉你路径
AI 会先说明要做什么,每一步都会征求你的同意
方式 2自己放入文件夹
把 lan-orangutan 文件夹放到 ~/.agents/skills/lan-orangutan
~ 是你的主文件夹($HOME)
适合使用 Terminal 的人
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
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
想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
方式 1让 Codex 帮你安装
复制这句话,粘贴到 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 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
正在检查命令 · 通过后才会显示复制按钮
重新打开 Codex 并提出相关任务,Codex 会列出这个 skill
方式 1让 Cursor 帮你安装
复制这句话,粘贴到 Cursor 的对话中
如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径
AI 会先说明要做什么,每一步都会征求你的同意
在 Cursor 的 Agent 聊天中输入 / 并选择 lan-orangutan
Checked against official docs 2026年11月12日 · Source: cursor.com
适合使用 Terminal 的人
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.cursor/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
正在检查命令 · 通过后才会显示复制按钮
在 Cursor 的 Agent 聊天中输入 / 并选择 lan-orangutan
方式 1让 AI 帮你安装
适用于其他能读取 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 的人
其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 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