前言¶
自托管环境需要同时管理大量端口、监控开放服务，并防范未授权访问。开发者常面临三个问题：端口清单分散、无法快速确认端口归属、缺少对端口状态漂移和威胁情报的持续监控。传统手动审计效率低且容易遗漏。
是什么¶
portkeep 是一个运行在 SkillHub 上的 Agent Skill，用于自托管基础设施的端口管理、安全扫描、资产归属确认与审计。由社区用户 user_15292d5a 发布，版本为 1.0.0，分类为 it-ops-security。它通过接口返回实时威胁情报，帮助团队及时发现异常端口和漂移状态。
核心功能¶
- 端口扫描与清单管理
- 端口归属声明（claim）
- 审计检查，识别未声明或可疑端口
- 状态漂移检测，发现配置变化
- 联动实时威胁情报进行安全评估
安装与启用¶
portkeep 在 SkillHub 上以社区 Skill 形式提供，需要通过 SkillHub 平台安装并启用。根据 SkillHub 的通用 SKILL.md 格式，安装步骤通常包含：
- 打开 SkillHub 官方地址
- 搜索或导航至 portkeep
- 点击安装/启用，完成初始化配置
由于该 Skill 标注 requires_api_key=true，安装后需在配置中提供 API Key 以启用威胁情报等能力。具体配置项以 SkillHub 提供的文档为准。
典型用法¶
- 运行端口扫描：向 portkeep 发起扫描请求，获取当前开放的端口清单。
- 声明端口归属：对确认归口的端口执行 claim 操作，记录责任人。
- 执行审计：对比已声明端口与实际开放端口，识别未声明或异常端口。
- 检测漂移：定期对比配置与实际状态，发现未预期的端口变更。
- 联动威胁情报：结合 API Key 获取的实时威胁情报，对高风险端口进行标记和处置。
适用场景与注意¶
portkeep 适合自托管基础设施团队，需要集中管理端口、审计安全状态和检测漂移的场景。使用时需注意：
- 需要配置 API Key 以启用威胁情报功能
- 建议结合定期扫描与人工复核，避免过度依赖自动化结果
- 某些环境可能需要额外权限才能执行端口扫描
总结¶
portkeep 提供了一体化的端口管理与安全审计能力，帮助团队在自托管环境中快速识别端口归属、监控状态漂移并联动威胁情报。官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-portkeep
