fscan/plugins/local/envinfo.go
ZacharyZcR 8f54702c02 refactor: 精准修复插件系统三个设计问题
经Linus式架构审计,发现并修复插件系统中的具体问题:

## 核心修复

### 1. 消除local插件GetPorts()方法冗余
- 删除21个local插件中无意义的GetPorts()方法
- 简化local.Plugin接口:移除端口概念
- 理由:本地插件不涉及网络,端口概念完全多余

### 2. 消除web插件GetPorts()方法冗余
- 删除2个web插件中无用的GetPorts()方法
- 简化web.WebPlugin接口:专注智能HTTP检测
- 理由:Web插件使用动态HTTP检测,预定义端口无价值

### 3. 统一插件命名规范
- 统一所有插件接口使用Name()方法(符合Go惯例)
- 消除GetName()与Name()不一致问题
- 简化适配器:不再需要方法名转换

## 技术改进

接口精简:
- local插件:GetName() + GetPorts() → Name()
- web插件:GetName() + GetPorts() → Name()
- services插件:GetName() → Name()(保留GetPorts(),业务必需)

代码减少:
- 删除23个无用GetPorts()方法
- 重命名52个Name()方法
- 简化3个插件接口定义

## 影响范围

修改文件:55个插件文件
代码变更:-155行 +61行(净减少94行)
功能影响:零破坏性,保持所有业务逻辑不变

这是基于业务需求分析的精准重构,消除真正多余的部分,
保持系统架构合理性和向后兼容性。
2025-08-26 20:38:39 +08:00

167 lines
4.2 KiB
Go

package local
import (
"context"
"fmt"
"os"
"sort"
"strings"
"github.com/shadow1ng/fscan/common"
)
// EnvInfoPlugin 环境变量信息收集插件 - Linus式简化版本
//
// 设计哲学:"做一件事并做好"
// - 专注于环境变量收集
// - 过滤敏感信息关键词
// - 简单有效的实现
type EnvInfoPlugin struct {
name string
}
// NewEnvInfoPlugin 创建环境变量信息插件
func NewEnvInfoPlugin() *EnvInfoPlugin {
return &EnvInfoPlugin{
name: "envinfo",
}
}
// GetName 实现Plugin接口
func (p *EnvInfoPlugin) Name() string {
return p.name
}
// Scan 执行环境变量收集 - 直接、有效
func (p *EnvInfoPlugin) Scan(ctx context.Context, info *common.HostInfo) *ScanResult {
var output strings.Builder
var sensitiveVars []string
output.WriteString("=== 环境变量信息收集 ===\n")
// 获取所有环境变量
envs := os.Environ()
output.WriteString(fmt.Sprintf("总环境变量数: %d\n\n", len(envs)))
// 敏感关键词 - 直接硬编码,简单有效
sensitiveKeywords := []string{
"password", "passwd", "pwd", "secret", "key", "token",
"auth", "credential", "api", "access", "session",
"密码", "令牌", "密钥", "认证",
}
// 重要环境变量 - 系统相关
importantVars := []string{
"PATH", "HOME", "USER", "USERNAME", "USERPROFILE", "TEMP", "TMP",
"HOMEPATH", "COMPUTERNAME", "USERDOMAIN", "PROCESSOR_ARCHITECTURE",
}
output.WriteString("=== 重要环境变量 ===\n")
for _, envVar := range importantVars {
if value := os.Getenv(envVar); value != "" {
// PATH特殊处理 - 只显示条目数
if envVar == "PATH" {
paths := strings.Split(value, string(os.PathListSeparator))
output.WriteString(fmt.Sprintf("%s: %d个路径\n", envVar, len(paths)))
} else {
output.WriteString(fmt.Sprintf("%s: %s\n", envVar, value))
}
}
}
// 扫描所有环境变量寻找敏感信息
output.WriteString("\n=== 潜在敏感环境变量 ===\n")
for _, env := range envs {
parts := strings.SplitN(env, "=", 2)
if len(parts) != 2 {
continue
}
envName := strings.ToLower(parts[0])
envValue := parts[1]
// 检查是否包含敏感关键词
for _, keyword := range sensitiveKeywords {
if strings.Contains(envName, keyword) {
// 脱敏显示:只显示前几个字符
displayValue := envValue
if len(envValue) > 10 {
displayValue = envValue[:10] + "..."
}
sensitiveInfo := fmt.Sprintf("%s: %s", parts[0], displayValue)
sensitiveVars = append(sensitiveVars, sensitiveInfo)
output.WriteString(sensitiveInfo + "\n")
common.LogSuccess(fmt.Sprintf("发现敏感环境变量: %s", parts[0]))
break
}
}
}
if len(sensitiveVars) == 0 {
output.WriteString("未发现明显的敏感环境变量\n")
}
// 统计信息
output.WriteString(fmt.Sprintf("\n=== 统计结果 ===\n"))
output.WriteString(fmt.Sprintf("总环境变量: %d个\n", len(envs)))
output.WriteString(fmt.Sprintf("潜在敏感变量: %d个\n", len(sensitiveVars)))
// 按长度统计
shortVars, longVars := 0, 0
for _, env := range envs {
if len(env) < 50 {
shortVars++
} else {
longVars++
}
}
output.WriteString(fmt.Sprintf("短变量(<50字符): %d个\n", shortVars))
output.WriteString(fmt.Sprintf("长变量(≥50字符): %d个\n", longVars))
return &ScanResult{
Success: len(sensitiveVars) > 0,
Output: output.String(),
Error: nil,
}
}
// getAllEnvsByPrefix 获取指定前缀的环境变量 - 实用工具
func (p *EnvInfoPlugin) getAllEnvsByPrefix(prefix string) map[string]string {
result := make(map[string]string)
prefix = strings.ToUpper(prefix)
for _, env := range os.Environ() {
parts := strings.SplitN(env, "=", 2)
if len(parts) == 2 {
envName := strings.ToUpper(parts[0])
if strings.HasPrefix(envName, prefix) {
result[parts[0]] = parts[1]
}
}
}
return result
}
// getSortedEnvNames 获取排序后的环境变量名列表
func (p *EnvInfoPlugin) getSortedEnvNames() []string {
var names []string
for _, env := range os.Environ() {
parts := strings.SplitN(env, "=", 2)
if len(parts) >= 1 {
names = append(names, parts[0])
}
}
sort.Strings(names)
return names
}
// 注册插件
func init() {
RegisterLocalPlugin("envinfo", func() Plugin {
return NewEnvInfoPlugin()
})
}