境變量與命令行參數(shù)優(yōu)先級詳解)
Whosthere 配置完全指南YAML、環(huán)境變量與命令行參數(shù)優(yōu)先級詳解【免費(fèi)下載鏈接】whosthereLocal Area Network discovery tool with an interactive Terminal User Interface (TUI) written in Go. Discover, explore, and understand your LAN in an intuitive way. Knock Knock.. whos there? 項(xiàng)目地址: https://gitcode.com/gh_mirrors/wh/whosthereWhosthere 是一款用 Go 編寫的局域網(wǎng)發(fā)現(xiàn)工具它通過 mDNS、SSDP 和 ARP 掃描識別你的內(nèi)網(wǎng)設(shè)備并提供直觀的 TUI 界面。本文詳解 Whosthere 配置的三種方式——YAML 配置文件、環(huán)境變量與命令行參數(shù)——以及它們的優(yōu)先級順序幫助你快速完成網(wǎng)絡(luò)掃描配置。 四重配置通道一張圖看懂優(yōu)先級Whosthere 允許同一個配置項(xiàng)來自四個不同的來源。當(dāng)多個來源同時設(shè)置同一個值時按以下優(yōu)先級從高到低生效配置加載邏輯見 load.go優(yōu)先級配置方式適用場景1命令行參數(shù)Flags一次性臨時覆蓋如whosthere --timeout5s2環(huán)境變量WHOSTHERE__前綴容器/腳本中注入配置3YAML 配置文件日常持久化配置4內(nèi)置默認(rèn)值什么都不配時的兜底源碼在 config.go記住一個原則越臨時的方式優(yōu)先級越高方便你隨時臨時改寫而不污染配置文件。 配置文件放在哪里Whosthere 按以下順序查找 YAML 配置文件找到第一個即生效解析邏輯在 loader.go--config參數(shù)或WHOSTHERE_CONFIG環(huán)境變量指定的路徑$XDG_CONFIG_HOME/whosthere/config.yaml如果設(shè)置了XDG_CONFIG_HOME~/.config/whosthere/config.yamlLinux/macOS 默認(rèn)位置Windows 為%APPDATA%/whosthere見 xdg.go 貼心設(shè)計首次運(yùn)行 TUI 時如果配置文件不存在會自動生成一份帶注釋的默認(rèn)配置loader.go你直接打開改就行不用手寫。?? YAML 配置文件核心字段速查自動生成后的config.yaml每一項(xiàng)都有注釋常用字段如下配置項(xiàng)默認(rèn)值作用network_interface系統(tǒng)默認(rèn)接口指定掃描網(wǎng)卡如eth0、en0all_interfacesfalse同時展示所有網(wǎng)卡上的設(shè)備target_subnets自動探測接口子網(wǎng)手動指定要掃的 IPv4 CIDR 子網(wǎng)scan_interval20s周期性發(fā)現(xiàn)掃描的間隔scan_timeout10s單次掃描超時建議小于間隔scanners.mdns/ssdp/arp.enabled均開啟三個發(fā)現(xiàn)器的開關(guān)至少要留一個sweeper.enabledtrue子網(wǎng) sweeping 探測觸發(fā) ARP 解析的主力port_scanner.tcp28 個常見端口對發(fā)現(xiàn)的設(shè)備做 TCP 端口掃描splash.enabled/delaytrue/1sTUI 啟動畫面的開關(guān)與時長theme.namedefaultTUI 主題可設(shè)custom自定義顏色?? 配置不是寫了就生效加載后會經(jīng)過校驗(yàn)與歸一化非法的target_subnetsCIDR、不存在的網(wǎng)卡名、全關(guān)掃描器等都會被糾正或報錯config.go。 環(huán)境變量配置法雙下劃線即嵌套任何 YAML 里能寫的配置項(xiàng)都能用環(huán)境變量設(shè)置規(guī)則很簡單實(shí)現(xiàn)見 env.go統(tǒng)一前綴WHOSTHERE__注意雙下劃線嵌套層級用__分隔鍵名不區(qū)分大小寫常用示例# 禁用啟動畫面等價于 splash.enabled: false export WHOSTHERE__SPLASH__ENABLEDfalse # 指定掃描主題等價于 theme.name: cyberpunk export WHOSTHERE__THEME__NAMEcyberpunk # 只掃兩個子網(wǎng)等價于 target_subnets 列表 export WHOSTHERE__TARGET_SUBNETS10.0.0.0/24,10.0.1.0/24 # 關(guān)閉 mDNS 掃描器 export WHOSTHERE__SCANNERS__MDNS__ENABLEDfalse # 自定義端口掃描列表 export WHOSTHERE__PORT_SCANNER__TCP80,443,8080另有三個通用環(huán)境變量與具體配置項(xiàng)無關(guān)變量說明WHOSTHERE_CONFIG覆蓋配置文件路徑與--config同效WHOSTHERE_LOG日志級別debug/info/warn/errorNO_COLOR完全關(guān)閉 TUI 的 ANSI 彩色輸出 命令行參數(shù)速查表所有全局參數(shù)注冊在 settings.go運(yùn)行whosthere --help可隨時查看。最常用的參數(shù)參數(shù)短選項(xiàng)對應(yīng)配置項(xiàng)示例--config-c配置文件路徑--config/etc/whosthere.yaml--interface-inetwork_interface--interfaceen0--interval-nscan_interval--interval30s--timeout-tscan_timeout--timeout10s--mdns/--ssdp/--arp-m-s-a對應(yīng)掃描器開關(guān)--mdnsfalse--sweeper-Ssweeper.enabled--sweeperfalse--sweeper-interval/--sweeper-timeout-W/-Tsweeper 周期/超時--sweeper-interval5m--all-interfaces—all_interfaces--all-interfaces--target-subnets—target_subnets--target-subnets10.0.0.0/24注意并非每項(xiàng)配置都有對應(yīng)參數(shù)——scan_large_subnets、port_scanner.*、splash.*、theme.*只支持 YAML 與環(huán)境變量命令行里找不到它們。 一個容易踩的坑scan 子命令不讀 YAML這是閱讀 load.go 才能發(fā)現(xiàn)的行為差異TUI 模式直接運(yùn)行whosthere完整走YAML 環(huán)境變量 參數(shù)三層合并CLI 模式whosthere scan跳過 YAML 配置文件只使用環(huán)境變量和命令行參數(shù) 默認(rèn)值。所以whosthere scan -t 5的表現(xiàn)與你在config.yaml里寫的sweeper.interval等無關(guān)。想讓 CLI 單次掃描也生效請把值寫進(jìn)環(huán)境變量或參數(shù)whosthere scan --timeout5s --sweeperfalse whosthere scan --timeout5s --json --pretty devices.json 驗(yàn)證配置是否生效先跑whosthere --help確認(rèn)參數(shù)名拼寫正確設(shè)置WHOSTHERE_LOGdebug開啟調(diào)試日志查看日志文件TUI 模式下日志只寫文件Linux/macOS~/.local/state/whosthere/app.logWindows%LOCALAPPDATA%/whosthere/app.log非 TUI 模式如scan、daemon的日志會同時輸出到控制臺排查更方便。小結(jié)需求推薦做法長期個性化主題、端口、掃描節(jié)奏編輯~/.config/whosthere/config.yaml腳本、CI、容器里注入WHOSTHERE__前綴環(huán)境變量臨時調(diào)試、一次性覆蓋命令行參數(shù)指定多個配置文件環(huán)境--config或WHOSTHERE_CONFIG掌握參數(shù) 環(huán)境變量 YAML 默認(rèn)值這條主線再注意scan子命令跳過 YAML 的特性你就完全掌控了 Whosthere 的全部配置行為可以放心去敲敲門看看局域網(wǎng)里都有誰 。【免費(fèi)下載鏈接】whosthereLocal Area Network discovery tool with an interactive Terminal User Interface (TUI) written in Go. Discover, explore, and understand your LAN in an intuitive way. Knock Knock.. whos there? 項(xiàng)目地址: https://gitcode.com/gh_mirrors/wh/whosthere創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Whosthere 配置完全指南：YAML、環(huán)境變量與命令行參數(shù)優(yōu)先級詳解
Whosthere 配置完全指南YAML、環(huán)境變量與命令行參數(shù)優(yōu)先級詳解【免費(fèi)下載鏈接】whosthereLocal Area Network discovery tool with an interactive Terminal User Interface (TUI) written in Go. Discover, explore, and understand your LAN in an intuitive way. Knock Knock.. whos there? 項(xiàng)目地址: https://gitcode.com/gh_mirrors/wh/whosthereWhosthere 是一款用 Go 編寫的局域網(wǎng)發(fā)現(xiàn)工具它通過 mDNS、SSDP 和 ARP 掃描識別你的內(nèi)網(wǎng)設(shè)備并提供直觀的 TUI 界面。本文詳解 Whosthere 配置的三種方式——YAML 配置文件、環(huán)境變量與命令行參數(shù)——以及它們的優(yōu)先級順序幫助你快速完成網(wǎng)絡(luò)掃描配置。 四重配置通道一張圖看懂優(yōu)先級Whosthere 允許同一個配置項(xiàng)來自四個不同的來源。當(dāng)多個來源同時設(shè)置同一個值時按以下優(yōu)先級從高到低生效配置加載邏輯見 load.go優(yōu)先級配置方式適用場景1命令行參數(shù)Flags一次性臨時覆蓋如whosthere --timeout5s2環(huán)境變量WHOSTHERE__前綴容器/腳本中注入配置3YAML 配置文件日常持久化配置4內(nèi)置默認(rèn)值什么都不配時的兜底源碼在 config.go記住一個原則越臨時的方式優(yōu)先級越高方便你隨時臨時改寫而不污染配置文件。 配置文件放在哪里Whosthere 按以下順序查找 YAML 配置文件找到第一個即生效解析邏輯在 loader.go--config參數(shù)或WHOSTHERE_CONFIG環(huán)境變量指定的路徑$XDG_CONFIG_HOME/whosthere/config.yaml如果設(shè)置了XDG_CONFIG_HOME~/.config/whosthere/config.yamlLinux/macOS 默認(rèn)位置Windows 為%APPDATA%/whosthere見 xdg.go 貼心設(shè)計首次運(yùn)行 TUI 時如果配置文件不存在會自動生成一份帶注釋的默認(rèn)配置loader.go你直接打開改就行不用手寫。?? YAML 配置文件核心字段速查自動生成后的config.yaml每一項(xiàng)都有注釋常用字段如下配置項(xiàng)默認(rèn)值作用network_interface系統(tǒng)默認(rèn)接口指定掃描網(wǎng)卡如eth0、en0all_interfacesfalse同時展示所有網(wǎng)卡上的設(shè)備target_subnets自動探測接口子網(wǎng)手動指定要掃的 IPv4 CIDR 子網(wǎng)scan_interval20s周期性發(fā)現(xiàn)掃描的間隔scan_timeout10s單次掃描超時建議小于間隔scanners.mdns/ssdp/arp.enabled均開啟三個發(fā)現(xiàn)器的開關(guān)至少要留一個sweeper.enabledtrue子網(wǎng) sweeping 探測觸發(fā) ARP 解析的主力port_scanner.tcp28 個常見端口對發(fā)現(xiàn)的設(shè)備做 TCP 端口掃描splash.enabled/delaytrue/1sTUI 啟動畫面的開關(guān)與時長theme.namedefaultTUI 主題可設(shè)custom自定義顏色?? 配置不是寫了就生效加載后會經(jīng)過校驗(yàn)與歸一化非法的target_subnetsCIDR、不存在的網(wǎng)卡名、全關(guān)掃描器等都會被糾正或報錯config.go。 環(huán)境變量配置法雙下劃線即嵌套任何 YAML 里能寫的配置項(xiàng)都能用環(huán)境變量設(shè)置規(guī)則很簡單實(shí)現(xiàn)見 env.go統(tǒng)一前綴WHOSTHERE__注意雙下劃線嵌套層級用__分隔鍵名不區(qū)分大小寫常用示例# 禁用啟動畫面等價于 splash.enabled: false export WHOSTHERE__SPLASH__ENABLEDfalse # 指定掃描主題等價于 theme.name: cyberpunk export WHOSTHERE__THEME__NAMEcyberpunk # 只掃兩個子網(wǎng)等價于 target_subnets 列表 export WHOSTHERE__TARGET_SUBNETS10.0.0.0/24,10.0.1.0/24 # 關(guān)閉 mDNS 掃描器 export WHOSTHERE__SCANNERS__MDNS__ENABLEDfalse # 自定義端口掃描列表 export WHOSTHERE__PORT_SCANNER__TCP80,443,8080另有三個通用環(huán)境變量與具體配置項(xiàng)無關(guān)變量說明WHOSTHERE_CONFIG覆蓋配置文件路徑與--config同效WHOSTHERE_LOG日志級別debug/info/warn/errorNO_COLOR完全關(guān)閉 TUI 的 ANSI 彩色輸出 命令行參數(shù)速查表所有全局參數(shù)注冊在 settings.go運(yùn)行whosthere --help可隨時查看。最常用的參數(shù)參數(shù)短選項(xiàng)對應(yīng)配置項(xiàng)示例--config-c配置文件路徑--config/etc/whosthere.yaml--interface-inetwork_interface--interfaceen0--interval-nscan_interval--interval30s--timeout-tscan_timeout--timeout10s--mdns/--ssdp/--arp-m-s-a對應(yīng)掃描器開關(guān)--mdnsfalse--sweeper-Ssweeper.enabled--sweeperfalse--sweeper-interval/--sweeper-timeout-W/-Tsweeper 周期/超時--sweeper-interval5m--all-interfaces—all_interfaces--all-interfaces--target-subnets—target_subnets--target-subnets10.0.0.0/24注意并非每項(xiàng)配置都有對應(yīng)參數(shù)——scan_large_subnets、port_scanner.*、splash.*、theme.*只支持 YAML 與環(huán)境變量命令行里找不到它們。 一個容易踩的坑scan 子命令不讀 YAML這是閱讀 load.go 才能發(fā)現(xiàn)的行為差異TUI 模式直接運(yùn)行whosthere完整走YAML 環(huán)境變量 參數(shù)三層合并CLI 模式whosthere scan跳過 YAML 配置文件只使用環(huán)境變量和命令行參數(shù) 默認(rèn)值。所以whosthere scan -t 5的表現(xiàn)與你在config.yaml里寫的sweeper.interval等無關(guān)。想讓 CLI 單次掃描也生效請把值寫進(jìn)環(huán)境變量或參數(shù)whosthere scan --timeout5s --sweeperfalse whosthere scan --timeout5s --json --pretty devices.json 驗(yàn)證配置是否生效先跑whosthere --help確認(rèn)參數(shù)名拼寫正確設(shè)置WHOSTHERE_LOGdebug開啟調(diào)試日志查看日志文件TUI 模式下日志只寫文件Linux/macOS~/.local/state/whosthere/app.logWindows%LOCALAPPDATA%/whosthere/app.log非 TUI 模式如scan、daemon的日志會同時輸出到控制臺排查更方便。小結(jié)需求推薦做法長期個性化主題、端口、掃描節(jié)奏編輯~/.config/whosthere/config.yaml腳本、CI、容器里注入WHOSTHERE__前綴環(huán)境變量臨時調(diào)試、一次性覆蓋命令行參數(shù)指定多個配置文件環(huán)境--config或WHOSTHERE_CONFIG掌握參數(shù) 環(huán)境變量 YAML 默認(rèn)值這條主線再注意scan子命令跳過 YAML 的特性你就完全掌控了 Whosthere 的全部配置行為可以放心去敲敲門看看局域網(wǎng)里都有誰 。【免費(fèi)下載鏈接】whosthereLocal Area Network discovery tool with an interactive Terminal User Interface (TUI) written in Go. Discover, explore, and understand your LAN in an intuitive way. Knock Knock.. whos there? 項(xiàng)目地址: https://gitcode.com/gh_mirrors/wh/whosthere創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考