运维123 - Go
type: channel
link: https://www.sddts.cn/index.php/tag/Go/
items: EZBT-MCP：宝塔面板 MCP 服务架构与使用指南
items: Scrutiny 硬盘 S.M.A.R.T 监控工具详解
items: 爱享素材下载器（res-downloader）开源项目分析
items: graphics.gd 实现 Linux 二进制兼容性技术分析
items: Gitea 开源 Git 托管平台技术分析
items: ip2region 离线 IP 地址定位库技术分析
items: WatchYourLAN 网络IP扫描器技术分析
items: Term Everything 终端内运行 GUI 应用技术创新分析
items: Octopus LLM API 聚合服务技术分析
items: Netventory 网络扫描工具技术分析

EZBT-MCP：宝塔面板 MCP 服务架构与使用指南
type: item
date: 2026-02-25T08:17:32+00:00
description: EZBT-MCP：宝塔面板 MCP 服务架构与使用指南一、背景与目标1. 项目背景A. 业务场景宝塔 Linux 面板（BT Panel）是广泛使用的服务器运维面板，提供网站、数据库、Docker、文件等管理能力。日常运维中，管理员需要在浏览器中登录面板执行操作，或通过宝塔提供的 HTTP API 自行对接。若希望用自然语言驱动运维（例如在 AI 编辑器中说出「帮我看看这台服务器的 CPU 和内存」「把站点 example.com 停用一下」），就需要将面板能力以「工具」形式暴露给 AI，并遵循统一的协议。B. 痛点分析面板能力与 AI 对话之间缺少标准桥梁，难以被 Cursor、Claude Code 等编辑器直接调用。自行对接宝塔 API 时需处理签名、Cookie、参数封装，重复造轮子。希望用同一套协议同时支持多种 AI 客户端，便于扩展与复用。2. 设计目标A. 功能目标基于 Model Context Protocol（MCP）将宝塔面板核心能力封装为工具，供 AI 通过自然语言调用。覆盖系统监控、网站管理、文件操作、数据库、Docker、邮件等常用场景。提供清晰的工具列表与参数说明，便于集成与二次开发。B. 非功能目标鉴权符合宝塔官方签名算法，每次请求按当前时间计算 token，长时间运行无需重启。支持 stdio 与 SSE 两种传输方式，适配不同 MCP 客户端。代码结构清晰，按模块划分（system、sites、files、docker 等），便于维护与扩展。二、总体设计1. 设计原则工具与宝塔 API 一一对应或聚合对应，避免过度封装导致语义失真。所有请求经统一 HTTP 封装层（panelHttpController），统一处理 BaseURL、签名与表单编码。无状态设计，不维护会话状态，依赖环境变量配置面板地址与 API 密钥。2. 系统架构graph TB subgraph 客户端 AI[AI 编辑器 / Cursor 等] end subgraph ezbt-mcp MCP[MCP Server] SYS[system 模块] SIT[sites 模块] FIL[files 模块] DB[databases 模块] DOCK[docker 模块] EMAIL[email 模块] UTIL[utils 鉴权与 HTTP] end subgraph 宝塔面板 BT[宝塔 Linux 面板 API] end AI -->|stdio / SSE| MCP MCP --> SYS MCP --> SIT MCP --> FIL MCP --> DB MCP --> DOCK MCP --> EMAIL SYS --> UTIL SIT --> UTIL FIL --> UTIL DB --> UTIL DOCK --> UTIL EMAIL --> UTIL UTIL -->|POST + 签名| BT3. 组件说明MCP Server：基于 mcp-go 创建服务，注册全部工具并支持 stdio/SSE。system：系统监控类工具（公共配置、实时 CPU/内存/网络/负载、系统统计、磁盘、安装任务数）。sites：网站全生命周期（列表、创建、删除、停用/启用、备注、备份、域名、伪静态）。files：文件读写、保存、权限、创建文件/目录、删除。databases：MySQL 数据库列表。docker：容器列表与详情、本地镜像列表。email：邮箱创建与邮件列表。utils：封装 BaseURL、API 密钥读取，以及按当前时间计算 request_time 与 request_token，并统一发起 POST 请求。三、核心实现1. 鉴权与请求封装宝塔 API 要求每次请求携带 request_time（当前 Unix 时间戳）与 request_token。request_token 计算方式为：md5(string(request_time) + md5(api_sk))。ezbt-mcp 在 utils 层实现该算法，并在每次调用面板时重新计算，因此无需保存 token，长时间运行也不会因过期而失败。请求统一使用 POST，Content-Type 为 application/x-www-form-urlencoded，参数与宝塔官方文档一致。面板地址与 api_sk 通过环境变量 BT_BASE_URL、BT_API_TOKEN 注入。2. 工具注册模式每个能力对应一个「工具定义」和一个「处理函数」。例如 get_system_total 工具描述为「获取系统基础统计：操作系统、面板版本、CPU 核心数、内存等」，处理函数内构造 NewBTPanel，调用 system?action=GetSys…

Scrutiny 硬盘 S.M.A.R.T 监控工具详解
type: item
date: 2026-02-07T03:01:41+00:00
description: Scrutiny 硬盘 S.M.A.R.T 监控工具详解一、概述1. 简介A. 是什么Scrutiny 是一个硬盘健康仪表板和监控解决方案，将厂商提供的 S.M.A.R.T 指标与真实世界故障率相结合。它是一个基于 Web 的监控工具，用于跟踪硬盘的 S.M.A.R.T 属性历史趋势，并使用真实世界故障率来定制阈值，从而在硬盘故障前提前预警。B. 为什么需要传统 smartd 守护进程存在以下问题：S.M.A.R.T 属性超过百种，smartd 无法区分关键指标和信息性指标smartd 不记录 S.M.A.R.T 属性历史，难以判断属性是否随时间缓慢恶化厂商设定的阈值有时未设置或过高，只能确认已故障的硬盘，无法检测即将故障的硬盘smartd 仅提供命令行界面，对于无头服务器来说 Web UI 更有价值C. 核心价值历史趋势跟踪：记录 S.M.A.R.T 指标的变化历史智能阈值：基于真实世界故障率定制告警阈值可视化仪表板：Web 界面专注于关键指标多设备支持：自动检测所有连接的硬盘驱动器2. 项目背景A. 原始项目Scrutiny 最初由 AnalogJ 创建，是一个开源的硬盘监控解决方案。B. Fork 版本本文档介绍的是 Starosdev 维护的 Fork 版本。原始项目在 2024 年开发速度显著放缓，而社区贡献和功能请求持续增长。这个 Fork 版本接续原始项目的工作，合并了待处理的社区 PR 并添加了新功能。C. 版本对比特性原始版本本 Fork 版本最新版本v0.8.1 (2024年4月)v1.21.0 (2026年2月)前端框架Angular 13现代 Angular (Angular 21)维护状态最小更新积极维护社区 PR多个待处理已合并3. 前置知识A. 必备技能基本了解硬盘和 S.M.A.R.T 技术Docker 基础知识Linux 命令行操作B. 推荐知识InfluxDB 时序数据库Web 服务配置二、系统架构1. 整体架构Scrutiny 采用分层架构设计，包含数据采集层、Web 服务层和数据存储层。graph LR A[Collector] --> B[smartctl] B --> C[Physical Drives] C --> D[Device Devices] A --> E[ZFS Collector] E --> F[ZFS Pools] G[Web Container] --> H[Angular Frontend] G --> I[Go API Backend] J[InfluxDB] --> K[Time Series Data] L[SQLite] --> M[Device Metadata] A --> I I --> J I --> L H --> I2. 组件说明A. Collector（采集器）职责：定期采集硬盘 S.M.A.R.T 数据工具：集成 smartctl 二进制文件调度：默认每日执行一次类型：标准采集器、ZFS 采集器B. Web 服务前端：Angular 框架开发的 Web UI后端：Go 语言开发的 API 服务功能：提供仪表板、设备管理、配置接口C. 数据存储InfluxDB：存储 S.M.A.R.T 时序数据SQLite：存储设备元数据和配置信息3. 数据流转流程sequenceDiagram participant User as 用户 participant Web as Web UI participant API as API Backend participant Collector as Collector participant InfluxDB as InfluxDB participant SQLite as SQLite User->>Web: 访问仪表板 Web->>API: GET /api/devices API->>SQLite: 查询设备列表 SQLite-->>API: 返回设备数据 API-->>Web: JSON 响应 Web-->>User: 显示仪表板 Note over Collector: 定时执行 (默认每日) Collector->>Collector: smartctl --scan Collector->>Collector: smartctl --info Collector->>Collector: smartctl --xall Collector->>API: POST /api/collect API->>InfluxDB: 写入时序数据 API->>SQLite: 更新设备元数据 API-->>Collector: 确认成功三、部署模式1. Omnibus 部署A. 概述Omnibus 模…

爱享素材下载器（res-downloader）开源项目分析
type: item
date: 2026-02-04T12:05:04+00:00
description: 爱享素材下载器（res-downloader）开源项目分析一、新闻概述1. 标题爱享素材下载器：一款跨平台多资源类型下载工具，支持视频号、抖音、快手等主流平台2. 发布时间2025 年 12 月 30 日（最新版本 3.1.3）3. 来源GitHub 开源仓库二、核心内容1. 事件摘要A. 主要内容爱享素材下载器是一款基于 Go + Wails 框架开发的跨平台资源下载工具，采用代理抓包技术实现网络资源嗅探与下载，已获得 14.9k Star 和 1.9k Fork。B. 核心亮点跨平台支持：Windows、macOS、Linux 三大操作系统多平台兼容：支持微信视频号、小程序、抖音、快手、小红书、酷狗音乐、QQ音乐多资源类型：视频、音频、图片、m3u8、直播流等代理抓包技术：通过本地代理拦截网络请求获取资源链接免费开源：基于 Apache-2.0 协议开源2. 关键信息A. 版本号最新版本 3.1.3（2025-12-30 发布）B. 重要数据GitHub Star：14.9kGitHub Fork：1.9kWatchers：88Releases：25 个版本代码语言：Go 43.6%、Vue 39.6%、TypeScript 5.6%C. 涉及产品支持平台：微信视频号、小程序、抖音、快手、小红书、酷狗音乐、QQ音乐支持格式：m3u8 视频流、直播流、常规视频/音频/图片3. 背景介绍A. 项目历史项目由开发者 putyy 发起，采用 Wails 框架（Go + Web 前端）构建，通过代理方式实现网络抓包，类似 Fiddler、Charles 等工具，但对资源进行了更友好的筛选和展示。B. 相关上下文项目提供了 Mini 版（使用默认浏览器展示 UI）和 Electron 旧版（支持 Win7），满足不同用户需求。三、详细报道1. 主要内容A. 功能特性简单易用：操作界面清晰美观，适合大众用户使用多平台支持：Windows / macOS / Linux 全覆盖多资源类型：视频、音频、图片、m3u8、直播流等平台兼容广泛：微信视频号、小程序、抖音、快手、小红书、酷狗音乐、QQ音乐代理抓包：支持设置代理获取受限网络下的资源B. 技术架构后端技术：Go 语言（43.6%），负责代理服务、资源拦截、下载管理前端技术：Vue.js（39.6%），提供用户界面构建工具：Wails 框架，实现 Go 与 Web 前端的集成安装打包：NSIS（Windows 安装程序）C. 使用流程启动代理：打开软件后点击"启动代理"按钮选择资源类型：勾选要获取的资源类型（默认全部）访问目标页面：在外部打开资源页面（如视频号、小程序、网页等）资源列表展示：返回软件首页即可看到拦截到的资源列表下载资源：点击下载按钮保存到本地2. 技术细节A. 工作原理graph TB A[用户打开目标网页] --> B[本地代理拦截] B --> C{资源类型筛选} C -->|视频| D[视频资源列表] C -->|音频| E[音频资源列表] C -->|图片| F[图片资源列表] C -->|m3u8| G[m3u8 资源列表] D --> H[用户选择下载] E --> H F --> H G --> H H --> I[保存到本地]B. 代理设置代理地址：127.0.0.1代理端口：8899证书安装：安装时需允许安装证书文件并允许网络访问C. 资源拦截原理通过系统代理设置，将网络请求重定向到本地代理服务代理服务解析 HTTP/HTTPS 请求，提取资源 URL根据资源类型和来源平台进行筛选和分类在用户界面展示可用资源列表用户选择后直接下载或调用外部下载工具3. 数据与事实A. 开发数据项目contributors：4 名开发者代码提交次数：约 25 个 Release 版本主要开发者：putyy（项目维护者）B. 用户数据GitHub Star：14.9kGitHub Fork：1.9kWatchers：88C. 技术栈对比技术占比用途Go43.6%后端代理服务、资源拦截、下载管理Vue39.6%前端用户界面TypeScript5.6%前端类型安全NSIS6.5%Windows 安装程序打包JavaScript3.3%前端交互逻辑CSS1.2%界面样式HTML0.2%页面结构四、影响分析1. 行业影响A. 技术趋势跨平台桌面应用开发：Wails 框架展示了一种轻量级的跨平台应用开发方案代理抓包技术：降低了网络资源抓取的技术门槛，适合大众用户开源工具生态：为特定领域（资源下载）提供了开源解决方案B. 竞争格局与传统抓包工具对比：Fiddler/Charles：功能强大但学习曲线陡峭爱享素材下载器：针对特定场景优化，使用简单与专业下载工具对比：IDM/NDM：下载功…

graphics.gd 实现 Linux 二进制兼容性技术分析
type: item
date: 2026-01-27T11:15:24+00:00
description: graphics.gd 实现 Linux 二进制兼容性技术分析一、技术概述1. 核心问题Linux 图形应用分发长期面临二进制兼容性挑战，尤其是需要硬件加速图形的应用。不同 Linux 发行版使用不同的 C 标准库（主要是 glibc 和 musl），导致针对一个库编译的二进制文件无法在另一个库的系统上运行。2. 解决方案graphics.gd 项目通过 musl + dlopen 技术，实现了真正的单静态二进制文件分发，支持在任何 Linux 系统（内核 3.2+）上运行，同时具备硬件加速图形能力。3. 技术意义这是 Linux 图形应用分发领域的重大突破，实现了类似 Go 语言的单静态二进制体验，同时支持 OpenGL、Vulkan 等硬件加速图形接口。二、背景分析1. Linux 二进制兼容性问题A. 现状Go 语言通过静态编译已经很好地解决了命令行工具和服务器的分发问题，只需执行 go build 即可生成在任何 Linux 发行版上运行的单二进制文件。B. 图形应用的挑战GPU 驱动必须通过 C ABI 访问动态库，这些 C 库针对特定的 libc 编译。主要问题包括：glibc 编译的库无法在 musl 系统上运行，反之亦然Godot 引擎在 Linux 上依赖 X11、Wayland、OpenGL、Vulkan 等动态库musl 拒绝为静态二进制实现 dlopen，以防止加载 glibc 库C. 技术障碍musl 和 glibc 在 TLS（线程本地存储）实现上存在根本性不兼容，这是阻止静态二进制使用 dlopen 的核心原因。三、技术实现1. musl 支持实现A. Go 运行时补丁为了解决 Go 在 musl 环境下的 c-shared 和 c-archive 构建问题，项目引入了新的 GOOS=musl 目标，通过 build-overlay 对运行时进行补丁。B. 构建策略调整放弃 c-shared 构建，改用 c-archive 直接链接 Go 代码与 Godot，最终生成单个二进制文件。2. dlopen 技术方案A. 技术原理通过在目标机器上加载或编译一个小型 C 程序，从同一进程加载并执行该程序。该程序引入主机的动态链接器，从而"窃取"系统的 dlopen 和 longjmp 回到 graphics.gd。B. 核心机制graph TB A[graphics.gd 静态二进制] --> B{嵌入小型 C 程序} B --> C[加载主机动态链接器] C --> D[获取系统 dlopen] C --> E[获取系统 longjmp] D --> F[汇编跳板包装] E --> F F --> G[切换到系统 libc TLS] G --> H[调用动态库函数] H --> I[X11/Wayland/OpenGL/Vulkan]C. 汇编跳板技术使用汇编跳板（assembly trampoline）包装所有动态加载的函数，在调用期间切换到系统的 libc TLS。这种设计类似于 cgo 的工作方式。3. 技术借鉴A. detour 技术C 语言的 detour 技术可以在没有标准库的情况下 dlopen SDL 并显示图形。B. Cosmopolitan 的 dlopen 实现使用类似技术实现跨平台动态加载。C. 创新点将上述技术扩展到 musl 环境，实现了真正的单静态二进制 + 图形支持。四、技术架构1. 系统架构graph LR A[用户应用 Go 代码] --> B[graphics.gd 编译] B --> C{GOOS=musl 构建} C --> D[Godot c-archive] D --> E[静态链接二进制] E --> F[嵌入小型 C 程序] F --> G[运行时动态链接器] G --> H[X11/Wayland] G --> I[OpenGL/Vulkan]2. 构建流程A. 跨平台编译在任何支持的平台（Windows、macOS、Linux）上执行：GOOS=musl GOARCH=amd64 gd buildB. 前置要求需要删除 export_presets.cfg 以添加新的 musl 导出预设。C. 输出结果单个静态二进制文件，可在任何安装了 gcc 的 Linux 系统上运行（尚未嵌入辅助二进制）。3. 运行时机制A. 加载流程静态二进制启动加载嵌入的小型 C 程序C 程序引入主机动态链接器通过汇编跳板调用系统 dlopen加载 X11、Wayland、OpenGL、Vulkan 等库切换 TLS 执行图形函数B. TLS 切换汇编跳板在每次调用动态库函数前后切换 TLS，确保与系统 libc 的兼容性。五、技术优势1. 真正的单二进制分发不需要区分 g…

Gitea 开源 Git 托管平台技术分析
type: item
date: 2026-01-27T08:46:15+00:00
description: Gitea 开源 Git 托管平台技术分析一、概述1. 项目背景Gitea 是一个用 Go 语言编写的自托管 Git 服务平台，旨在提供最简单、最快、最轻松的方式来搭建私有 Git 仓库服务。A. 核心定位轻量级自托管 Git 服务类似 GitHub/GitLab 的功能集合跨平台支持的一体化软件开发服务平台B. 历史渊源Gitea 于 2016 年 11 月从 Gogs 项目 fork 而来，经过多年发展已形成独立生态，相比原项目有显著改进和变化。2. 核心特性A. 技术栈后端语言：Go（Golang）前端技术：Node.js + pnpm数据库：支持 SQLite、MySQL、PostgreSQL 等B. 功能模块Git 托管服务代码审查（Code Review）团队协作功能包注册中心（Package Registry）持续集成/持续部署（CI/CD）3. 生态系统A. 官方项目go-sdk：官方 Go 语言 SDKtea：命令行工具（CLI）act_runner：Gitea Actions 运行器B. 社区资源awesome-gitea：第三方项目集合Discord 社区：实时交流平台Discourse 论坛：技术讨论区Crowdin：多语言翻译平台二、技术架构1. 跨平台支持由于使用 Go 语言编写，Gitea 支持 Go 运行的所有平台和架构：A. 操作系统Linux（主流发行版）macOSWindowsB. 处理器架构x86/x86_64（amd64）ARM 系列PowerPC2. 构建系统A. 构建流程graph TD A[源代码] --> B{构建类型} B -->|完整构建| C[后端构建] B -->|前端已预构建| D[仅后端] C --> E[前端构建] E --> F[生成可执行文件] D --> FB. 构建命令基础构建：TAGS="bindata" make build包含 SQLite 支持：TAGS="bindata sqlite sqlite_unlock_notify" make buildC. 分离构建目标make backend：后端构建，需要 Go Stable 版本make frontend：前端构建，需要 Node.js LTS 和 pnpm3. 系统组件A. 核心模块Web 服务：HTTP/HTTPS 服务Git 服务：SSH/HTTP Git 协议支持API 服务：RESTful API 接口任务系统：异步任务处理B. 数据存储Git 仓库存储数据库（用户、权限、配置等）日志存储缓存层三、部署方式1. 从源码构建A. 环境要求Go 编译器（版本定义在 go.mod）Node.js LTS 或更高版本pnpm 包管理器B. 构建步骤# 克隆仓库 git clone https://github.com/go-gitea/gitea.git cd gitea # 构建 TAGS="bindata" make build # 运行 ./gitea webC. 网络依赖下载 Go 模块需要网络连接下载 npm 依赖需要网络连接使用官方源码包可跳过前端构建2. 容器化部署Gitea 支持 Docker 容器化部署，便于快速启动和扩展。3. 云服务A. Gitea Cloud免费试用：cloud.gitea.com托管服务：gitea.com（有限仓库数）在线演示：demo.gitea.com四、功能特性1. Git 托管A. 核心功能仓库创建与管理分支保护标签管理WebhooksB. 访问控制SSH 密钥认证HTTP Token 认证权限管理系统2. 代码审查A. Pull Request代码合并请求代码评审功能自动合并选项B. 评审功能行内评论审批流程变更请求3. 团队协作A. 组织管理组织/团队结构成员管理权限分配B. 项目管理Issue 跟踪项目看板里程碑管理4. CI/CD 集成A. Gitea Actions内置 CI/CD 支持自定义运行器（act_runner）工作流配置B. 集成能力第三方 CI 工具集成Webhook 触发状态反馈五、开发者生态1. API 支持A. RESTful API完整的 API 接口实验性支持官方文档：https://docs.gitea.com/apiB. SDKGo SDK：go-sdk第三方 SDK：多个语言支持2. 贡献流程A. 工作流程Fork -> Patch -> Push -> Pull RequestB. 贡献指南必读：CONTRIBUTING.md代码规范提交规范C. 安全报告私密报告：security@gitea.io漏洞处理流程3. 本地化A. 翻译平台Crowdin：https://translate.gitea.c…

ip2region 离线 IP 地址定位库技术分析
type: item
date: 2026-01-27T05:09:21+00:00
description: ip2region 离线 IP 地址定位库技术分析一、项目概述1. 简介A. 是什么ip2region 是一个离线 IP 地址定位库和 IP 定位数据管理框架，同时支持 IPv4 和 IPv6，10 微秒级别的查询效率，提供了众多主流编程语言的 xdb 数据生成和查询客户端实现。B. 为什么值得关注极致性能：单次查询响应时间在十微秒级别完全离线：无需外部 API 调用，降低延迟和成本多语言支持：涵盖 Golang、PHP、Java、C、Lua、Rust、Python、JavaScript、Csharp 等主流编程语言数据可控：支持自定义 region 信息，可管理自有 IP 定位数据C. 适用场景用户地理位置统计和分析访问控制和地域限制广告定向投放安全防护和反欺诈离线环境的 IP 定位需求2. 核心特性A. 离线定位库项目提供了一份 IPv4（data/ipv4_source.txt）和 IPv6（data/ipv6_source.txt）的原始数据和对应的 xdb 文件（data/ip2region_v4.xdb 和 data/ip2region_v6.xdb）用于实现精确到城市的查询定位功能。B. 数据管理框架xdb 支持亿级别的 IP 数据段行数，region 信息支持完全自定义。自带数据的 region 信息固定格式为：国家|省份|城市|ISP。可以在 region 中追加特定业务需求的数据，例如 GPS 信息、国际统一地域信息编码、邮编等。C. 数据去重和压缩xdb 格式生成程序会自动处理输入的原始数据，检查并且完成相连 IP 段的合并以及相同地域信息的去重和压缩。二、技术架构1. 系统组成ip2region 由三个核心部分组成：A. 原始数据源IPv4 原始数据：ipv4_source.txtIPv6 原始数据：ipv6_source.txt数据格式：起始 IP、结束 IP、地域信息B. xdb 数据文件二进制格式的高效索引文件支持 IPv4 和 IPv6经过去重和压缩处理C. 查询客户端多语言实现的查询 API统一的查询接口支持内存加速查询2. 工作原理graph TB A[IP 地址输入] --> B[查询客户端] B --> C{xdb 查询引擎} C --> D[Vector Index 缓存] C --> E[XDB 文件] D --> F[内存加速] E --> G[磁盘 IO] F --> H[地域信息] G --> H H --> I[返回结果]3. 查询优化策略A. vIndex 索引缓存使用固定的 512KiB 的内存空间缓存 vector index 数据，减少一次 IO 磁盘操作，保持平均查询效率稳定在 100 微秒之内。B. xdb 整个文件缓存将整个 xdb 文件全部加载到内存，内存占用等同于 xdb 文件大小，无磁盘 IO 操作，保持 10 微秒级别的查询效率。graph LR A[查询策略] --> B[vIndex 缓存] A --> C[文件缓存] B --> D[512KiB 内存] B --> E[100 微秒级] C --> F[xdb 文件大小] C --> G[10 微秒级]三、xdb 数据结构1. 数据格式设计xdb 格式是 ip2region 的核心创新，通过精巧的数据结构设计实现了极高效的查询性能。A. 存储结构Vector Index：向量索引，用于快速定位数据块Data Segment：数据段，存储 IP 范围和地域信息Region Info：地域信息，采用压缩存储B. 查询流程sequenceDiagram participant C as 客户端 participant V as Vector Index participant S as Data Segment participant R as Region Info C->>V: 输入 IP 地址 V->>V: 计算 IP 索引 V->>S: 定位数据段 S->>R: 读取地域信息 R-->>C: 返回定位结果2. 数据生成流程A. 输入数据处理读取原始 IP 数据验证数据格式合并连续 IP 段B. 去重和压缩相同地域信息去重IP 段合并优化区域信息压缩C. 索引构建生成 Vector Index构建 Data Segment写入 xdb 文件四、多语言支持1. 查询客户端实现ip2region 提供了丰富的编程语言绑定，覆盖了主流的开发场景：编程语言描述IPv4 支持IPv6 支持Golanggolang xdb 查询客户端支持支持PHPphp xdb 查询客户端支持支持Javajava xdb 查询客户端支持支持CPOSIX C xdb 查询客户端支持支持Lua_clua c 扩展 xdb 查询客…

WatchYourLAN 网络IP扫描器技术分析
type: item
date: 2026-01-26T22:24:17+00:00
description: WatchYourLAN 网络IP扫描器技术分析一、概述1. 项目简介WatchYourLAN 是一个轻量级网络 IP 扫描器，提供 Web 图形界面。该项目使用 Go 语言开发，旨在帮助用户监控局域网内的主机状态。2. 核心特性A. 主要功能发现新主机时发送通知监控主机在线/离线历史记录维护网络中所有主机的列表支持将数据发送到 InfluxDB2 或 Prometheus，用于构建 Grafana 仪表板B. 技术特点轻量级设计，资源占用少基于 ARP 协议进行主机扫描支持多种部署方式（Docker、Linux 包安装）提供友好的 Web GUI 界面3. 应用场景A. 网络管理家庭网络设备监控办公环境资产管理网络安全审计B. 运维监控设备可用性监控异常设备检测网络拓扑可视化二、系统架构1. 整体架构graph TB subgraph "扫描层" A[ARP Scanner] B[arp-scan 工具] end subgraph "数据处理层" C[数据存储] D[SQLite/PostgreSQL] E[历史记录管理] end subgraph "通知层" F[Shoutrrr 通知] G[多渠道通知] end subgraph "集成层" H[InfluxDB2 导出] I[Prometheus 导出] J[Grafana 仪表板] end subgraph "展示层" K[Web GUI] L[主题系统] end A --> B A --> C C --> D C --> E A --> F F --> G C --> H C --> I H --> J I --> J C --> K K --> L2. 核心组件A. ARP 扫描模块使用 arp-scan 工具进行网络扫描，支持：多网卡同时扫描自定义扫描参数VLAN 环境支持B. 数据存储模块SQLite：轻量级部署场景PostgreSQL：大规模部署场景历史记录可配置存储策略C. 通知系统集成 Shoutrrr 通知库，支持：DiscordEmailGotifyMatrixNtfyPushoverSlackTelegramGeneric WebhookD. 数据导出InfluxDB2：时序数据存储Prometheus：监控指标暴露3. 数据流sequenceDiagram participant S as ARP Scanner participant D as Database participant N as Notification participant E as External Storage participant U as Web UI S->>D: 存储主机信息 S->>N: 检测到新主机 N->>U: 发送通知 S->>E: 导出历史数据 U->>D: 读取主机列表 U->>D: 查询历史记录三、技术实现1. 技术栈A. 后端技术语言：Go数据库：SQLite、PostgreSQL扫描工具：arp-scan通知：ShoutrrrB. 前端技术Web 框架：Bootstrap主题：Bootswatch图标：Flaticon2. 扫描原理A. ARP 协议扫描使用 ARP（Address Resolution Protocol）请求发现局域网内的活动主机：graph LR A[扫描器] -->|发送 ARP 请求| B[广播域] B --> C[主机 1] B --> D[主机 2] B --> E[主机 3] C -->|ARP 响应| A D -->|ARP 响应| A E -->|ARP 响应| AB. 扫描配置关键参数：IFACES：指定扫描网卡TIMEOUT：扫描间隔（默认 120 秒）ARP_ARGS：arp-scan 自定义参数TRIM_HIST：历史记录保留时间（默认 48 小时）3. 通知机制A. 新主机检测首次发现主机时触发通知，配置示例：shoutrrr_url: "gotify://192.168.0.1:8083/AwQqpAae.rrl5Ob/?title=Unknown host detected&DisableTLS=yes"B. 支持的通知渠道渠道配置前缀说明Discorddiscord://Discord WebhookEmailmailto://SMTP 邮件发送Gotifygotify://Gotify 推送通知Telegramtelegram://Telegram BotSlackslack://Slack Webhook四、部署方案1. Docker 部署A. 基础部署docker run --name wyl \ -e "IFACES=$YOURIFACE" \ -e "TZ=$YOURTIMEZON…

Term Everything 终端内运行 GUI 应用技术创新分析
type: item
date: 2026-01-26T21:54:54+00:00
description: Term Everything 终端内运行 GUI 应用技术创新分析一、技术概述1. 项目简介Term Everything 是一个创新的 Linux 命令行工具，能够在终端内运行任何 GUI 应用程序。该项目本质上是一个从零构建的 Wayland 合成器，但其输出目标不是显示器，而是终端。2. 核心特性支持 X11 和 Wayland 主机系统可通过 SSH 远程运行 GUI 应用支持终端图像协议（kitty、iTerm2）纯 Go 语言开发，仅含少量 C 代码开源协议 AGPL-3.03. 技术背景在现代 Linux 系统中，显示服务器负责协调客户端程序的输入和输出。Wayland 作为新一代显示协议，不强制规定渲染模型，程序可自主决定如何绘制图形，然后交给显示服务器处理。Term Everything 正是利用了这一特性，将图形输出重定向到终端。二、技术架构1. 工作原理graph TB A[GUI 应用程序] -->|Wayland 协议| B[Term Everything 合成器] B -->|图形数据| C[chafa 转换库] C -->|UTF8 字符 + ANSI 转义码| D[终端输出] D -->|用户交互| E[stdin 键盘/鼠标输入] E -->|输入事件| B B -->|输入转发| A2. 核心组件A. Wayland 合成器自主实现的 Wayland 协议处理接收客户端应用的图形缓冲管理窗口生命周期和输入事件B. 图形转换层使用 chafa 库将图像转为终端字符支持 SIXEL、Kitty 图形协议自适应终端分辨率C. 输入处理从 stdin 捕获键盘和鼠标事件转换为 Wayland 输入事件转发给 GUI 应用程序三、技术创新点1. 协议层创新Wayland 协议本身对输出方式无限制，Term Everything 创造性地将终端作为输出目标。这种方式打破了传统显示服务器的边界，使 GUI 应用能在纯文本环境中运行。2. 渲染技术栈文本模式渲染：使用 UTF-8 字符和 ANSI 转义码图形模式渲染：利用终端图像协议（kitty、iTerm2）混合渲染：根据终端能力自动选择最佳方案3. 远程显示能力由于输出是纯文本流，天然支持 SSH 远程传输。用户可在本地终端查看远程服务器的 GUI 应用，无需 X11 转发。sequenceDiagram participant U as 用户终端 participant S as SSH 连接 participant R as 远程服务器 participant G as GUI 应用 U->>S: 发起 SSH 连接 S->>R: 建立 SSH 会话 R->>G: 启动 Term Everything G->>R: 渲染图形帧 R->>R: 转换为终端字符 R->>S: 输出字符流 S->>U: 传输字符流 U->>U: 显示终端内容 U->>S: 键盘/鼠标输入 S->>R: 转发输入事件 R->>G: Wayland 输入事件四、技术实现细节1. 显示适配终端分辨率受行列数限制，用户可通过 Ctrl-（缩小字体）提高分辨率。项目根据终端能力动态调整渲染策略：低分辨率模式：使用 ASCII 字符中分辨率模式：使用 Unicode 块字符高分辨率模式：使用终端图像协议2. 性能优化仅在内容变化时重绘按需更新屏幕区域支持硬件加速的终端图形协议3. 兼容性处理自动检测终端类型和功能降级到基础功能集支持 X11 应用的 Wayland 兼容层五、应用场景1. 远程服务器管理在无图形界面的服务器上运行图形化工具，通过 SSH 在本地查看和操作。2. 资源受限环境在低配置设备或嵌入式系统上运行需要图形界面的应用程序。3. 终端工作流集成将 GUI 应用无缝集成到命令行工作流中，避免在终端和图形界面间切换。4. 创意展示终端内运行浏览器、视频播放器、甚至游戏（如 Doom），展示技术可能性。六、技术挑战1. 性能瓶颈字符渲染的 CPU 开销大量数据传输的延迟终端刷新率限制2. 兼容性问题部分应用可能无法启动或崩溃某些图形特性无法在终端中呈现输入事件映射的复杂性3. 用户体验分辨率限制导致细节丢失色彩还原能力有限交互响应延迟七、发展现状1. 项目状态当前版本：Beta 0.7.8开发语言：Go 97.9%，C 2.1%社区活跃度：7.7k Stars，184 Forks贡献者：7 人2. 开发路线第一阶段：支持部分应用（当前阶段）第二阶段：支持大多数应用第三阶段：支持所有应用3. 已知问题部分应用启动失败或崩溃性能随分辨率提高而下降需要用户反馈问题以改进兼容性八、技术意义1. 架构创新Term Everything 重新定义了显示服务器的边界，证明了 Wayl…

Octopus LLM API 聚合服务技术分析
type: item
date: 2026-01-26T10:16:32+00:00
description: Octopus LLM API 聚合服务技术分析一、概述1. 项目简介Octopus 是一个面向个人的 LLM API 聚合与负载均衡服务，旨在为用户提供统一接入多个大语言模型提供商的能力。项目采用 Go 语言后端结合 Next.js 前端的架构设计，提供简洁优雅的 Web 管理界面。2. 核心价值A. 统一接入通过单一服务接入 OpenAI、Anthropic、Gemini 等多个 LLM 提供商，简化多模型调用流程。B. 成本优化支持多 API Key 轮询使用，智能选择最低延迟的端点，帮助用户优化使用成本和响应速度。C. 协议兼容实现 OpenAI Chat、OpenAI Responses、Anthropic API 等多种协议的无缝转换，降低客户端集成复杂度。二、系统架构1. 技术栈graph TB Client[客户端] --> API[Octopus API] API --> LB[负载均衡层] LB --> Channel1[OpenAI 通道] LB --> Channel2[Anthropic 通道] LB --> Channel3[Gemini 通道] Channel1 --> Provider1[提供商1] Channel1 --> Provider2[提供商2] Channel2 --> Provider3[提供商3] Channel3 --> Provider4[提供商4] API --> DB[(数据库)] API --> Cache[内存缓存] Cache --> DB Web[Web管理面板] --> API2. 组件说明A. 后端服务（Go）提供统一的 API 接口实现负载均衡和协议转换处理通道管理和请求路由统计数据收集与存储B. 前端管理界面（Next.js）通道配置与管理模型分组与负载均衡策略设置价格管理与统计数据展示系统配置与监控C. 数据存储支持 SQLite、MySQL、PostgreSQL存储通道配置、模型信息、统计数据自动创建表结构三、核心功能1. 通道管理通道是连接 LLM 提供商的基本配置单元。A. 多通道聚合支持同时配置多个 LLM 提供商的通道，每个通道包含：基础 URL多个 API Key多个端点地址B. 智能端点选择每个通道支持配置多个端点，系统自动选择延迟最短的端点进行请求。C. 协议类型支持协议类型自动追加路径应用场景OpenAI Chat/chat/completions对话补全OpenAI Responses/responses结构化响应Anthropic/messagesClaude 模型Gemini/models/:model:generateContentGemini 模型★ Insight ─────────────────────────────────────自动路径拼接设计：用户只需提供基础 URL，系统根据通道类型自动追加 API 路径，这种设计降低了配置复杂度，减少了用户错误。多端点智能选择：通过实时监测各端点延迟，自动选择最优路径，这种动态优化机制能有效提升用户体验。─────────────────────────────────────────────────2. 分组管理与负载均衡分组将多个通道聚合为一个统一的外部模型名称。A. 负载均衡模式graph LR Request[请求] --> Router{负载均衡器} Router -->|轮询| CH1[通道1] Router -->|随机| CH2[通道2] Router -->|故障转移| CH3[通道3] Router -->|加权| CH4[通道4] CH1 --> Provider1[提供商1] CH2 --> Provider2[提供商2] CH3 --> Provider3[提供商3] CH4 --> Provider4[提供商4]B. 模式详解模式描述适用场景轮询按顺序依次使用各通道通道能力相近，需要均匀分配请求随机随机选择可用通道通道能力相近，不需要严格顺序故障转移优先使用高优先级通道，失败时切换有主备通道之分，需要高可用性加权按配置权重分配请求通道能力不同，需要按比例分配★ Insight ─────────────────────────────────────故障转移机制：高优先级通道优先使用，失败时自动降级到低优先级通道，这种设计确保了服务的高可用性，避免了单点故障。加权负载均衡：通过权重配置实现按能力分配请求，这种方式既充分利用了高能力通道，又避免了过载风险。─────────────────────────────────────────────────3. 协议转换系统支持在不同 API 协议之间进行无缝转换。A. 转换流程sequenceDiagr…

Netventory 网络扫描工具技术分析
type: item
date: 2026-01-25T10:38:11+00:00
description: Netventory 网络扫描工具技术分析一、新闻概述1. 标题Netventory：快速单二进制网络扫描工具，支持 TUI 和 WebUI 双界面2. 发布时间2025 年 1 月（当前版本 v0.3.0n）3. 来源GitHub 开源项目4. 作者RamboRogers二、核心内容1. 事件摘要A. 主要内容Netventory 是一个用 Go 语言编写的快速网络发现工具，提供终端 TUI 和 Web 两种用户界面，无需 root 权限即可运行。B. 核心亮点单二进制可执行文件，无需额外依赖跨平台支持 Linux、macOS 和 Windows双界面设计：终端 TUI 和 WebUI高并发扫描架构，性能优异多协议主机名解析MAC 地址厂商识别2. 关键信息A. 版本号当前版本：v0.3.0nB. 技术栈语言：Go 1.21+（GPLv3 开源许可）架构：并发扫描 + Worker PoolC. 涉及技术网络扫描、端口检测NetBIOS、SMB、RDP、mDNS 协议解析WebSocket 实时通信Token 认证机制3. 背景介绍A. 项目定位网络发现和网络审计工具，替代传统的 nmap 等复杂工具，提供更友好的用户界面。B. 相关上下文网络扫描工具通常分为命令行工具（如 nmap）和图形化工具（如 Angry IP Scanner），Netventory 结合了两者的优势。三、详细报道1. 主要功能A. 网络发现快速网络扫描，可配置 Worker 数量自动检测网络接口和计算 CIDR 范围MAC 地址解析和厂商查找端口扫描（22、80、443、445、139、135、8080、3389、5900、8006）无需 root 权限B. 高级主机名解析Netventory v0.3.0n 引入了多层主机名解析策略：graph TD A[目标设备] --> B{DNS 解析} B -->|成功| F[主机名] B -->|失败| C{NetBIOS} C -->|成功| F C -->|失败| D{SMB 主机名} D -->|成功| F D -->|失败| E{RDP 证书} E -->|成功| F E -->|失败| G{mDNS/Bonjour} G -->|成功| F G -->|失败| H[使用 IP 地址]C. 设备类型检测Apple 设备：通过厂商 OUI、端口开放情况和 mDNS 发现Windows 设备：通过 SMB 和 NetBIOS 检测Proxmox 虚拟化平台：检测 8006 端口D. 协议增强SMB：支持来宾账户、匿名访问回退、共享枚举RDP：TLS 证书解析，提取 CN 和 SANmDNS：服务类型发现、Apple 专用服务检测2. 技术架构A. 系统组成graph TB subgraph 用户界面层 TUI[终端 TUI] WEB[Web UI] end subgraph 业务逻辑层 SCAN[扫描引擎] RESOLVE[主机名解析器] DETECT[设备检测器] end subgraph 协议层 DNS[DNS 客户端] NETBIOS[NetBIOS] SMB[SMB 客户端] RDP[RDP 证书解析] MDNS[mDNS 客户端] end subgraph 网络层 WORKER[Worker Pool] ICMP[ICMP Ping] TCP[TCP 端口扫描] end TUI --> SCAN WEB -->|WebSocket| SCAN SCAN --> WORKER WORKER --> ICMP WORKER --> TCP RESOLVE --> DNS RESOLVE --> NETBIOS RESOLVE --> SMB RESOLVE --> RDP RESOLVE --> MDNS SCAN --> RESOLVE SCAN --> DETECT DETECT --> SMB DETECT --> MDNSB. 并发扫描模型sequenceDiagram participant M as 主控制器 participant W as Worker Pool participant T as 目标设备 M->>W: 分配 IP 段 par 并发扫描 W->>T: ICMP Ping W->>T: TCP 端口检测 end T-->>W: 返回在线状态 W->>W: 端口扫描 W->>W: MAC 地址解析 W-->>M: 设备信息 M->>M: 主机名解析 M->>M: 设备类型判断C. Web 架构graph LR C[客户端浏览器] -->|HTTP + WebSocket| S[Web 服务器] S -->|Token 验证| A[认证中间件] A -->|通过| S…