版本: v1.1.0
最后更新: 2026-04-10
状态: 活跃

本文件合并自 .gitcode/SECURITY.md 与根目录 SECURITY.md，消除重复并整合双版本独有内容。

AgentOS 采用安全内生设计，将安全机制内置于系统设计的每一个环节。我们重视社区反馈，鼓励负责任的漏洞披露。

• 漏洞报告流程
• 安全支持范围
• 安全最佳实践
• 安全架构
• 安全开发生命周期
• 已公开安全公告
• 联系方式
• 相关文档

我们鼓励负责任的漏洞披露。如果您发现任何安全漏洞，请：

• ✅ 立即通过安全邮箱联系我们
• ✅ 给我们合理的时间来修复问题（通常 15-90 天）
• ✅ 在公开披露前与我们协调
• ❌ 不要在修复前公开披露漏洞细节
• ❌ 不要利用漏洞进行未授权测试

发现安全问题时，请发送详细信息至：

为了帮助我们更好地理解和修复漏洞，请尽可能提供：

• 漏洞类型: SQL 注入、XSS、缓冲区溢出、权限提升等
• 漏洞描述: 详细的漏洞说明和影响范围
• 受影响版本: AgentOS 版本号
• 复现步骤: 详细的复现步骤和 PoC 代码
• 环境信息: 操作系统、编译器版本等
• 潜在影响: 漏洞可能造成的危害评估
• 修复建议: 如有可能，提供修复建议

报告模板:

## 漏洞类型
[例如：缓冲区溢出]

## 受影响版本
[例如：v1.0.0.6]

## 漏洞描述
[详细描述漏洞]

## 复现步骤
1. ...
2. ...
3. ...

## 环境信息
- OS: Ubuntu 22.04
- Compiler: GCC 11.4
- AgentOS: v1.0.0.6

## 潜在影响
[描述可能的危害]

## 修复建议
[可选]

我们承诺：

我们使用 CVSS v3.1 标准评估漏洞严重程度：

• Critical/High级别: 修复后30天内公开
• Medium/Low级别: 修复后90天内公开
• 特殊情况: 可与报告者协商调整披露时间

我们仅为以下版本提供安全更新：

建议: 始终使用最新版本以获得最佳安全保障。

# 定期检查依赖漏洞
pip audit
npm audit
cargo audit
go list -m all | nancy sleuth

• ✅ 遵循 安全编码规范
• ✅ 启用编译器安全选项（-fstack-protector, -D_FORTIFY_SOURCE=2）
• ✅ 使用静态分析工具（clang-tidy, cppcheck）
• ✅ 进行代码审查和安全审计
• ✅ 编写安全测试用例
• 关注以下安全问题：
  • 缓冲区溢出
  • 注入攻击（SQL/XSS/命令注入）
  • 认证和授权缺陷
  • 敏感信息泄露

✅ 遵循最小权限原则 ✅ 启用 cupolas 安全穹顶所有防护层 ✅ 配置防火墙和网络隔离 ✅ 使用加密通道传输敏感数据 ✅ 定期更新和打补丁

cupolas 安全配置 (YAML):

cupolas:
  workbench:
    isolation: container  # 容器隔离
    resource_limit:
      cpu: 2
      memory: 4GB
    
  permission:
    model: RBAC
    default_policy: deny  # 默认拒绝
    
  sanitizer:
    enabled: true
    rules:
      - sql_injection
      - xss
      - command_injection
    
  audit:
    enabled: true
    log_level: INFO
    retention_days: 90

Docker网络隔离示例:

docker network create agentos-internal
docker run --network=agentos-internal agentos:latest

• ✅ 启用审计日志
• ✅ 监控异常行为
• ✅ 定期安全扫描
• ✅ 备份关键数据
• ✅ 制定应急响应计划

审计日志配置示例:

import logging

audit_logger = logging.getLogger('agentos.audit')
audit_logger.setLevel(logging.INFO)

handler = logging.FileHandler('/var/log/agentos/audit.log')
formatter = logging.Formatter(
    '%(asctime)s [%(levelname)s] %(message)s'
)
handler.setFormatter(formatter)
audit_logger.addHandler(handler)

AgentOS 采用内生安全设计理念，实现四重防护：

┌─────────────────────────────────────┐
│         应用层 (openlab)            │
│    输入验证 → 业务逻辑 → 输出编码   │
└───────────────────┬─────────────────┘
                    ↕
┌───────────────────▼─────────────────┐
│       安全层 (cupolas)              │
│  ┌─────────┐ ┌─────────┐          │
│  │ 虚拟工位 │→│ 权限裁决 │         │
│  └─────────┘ └─────────┘          │
│  ┌─────────┐ ┌─────────┐          │
│  │ 输入净化 │→│ 审计追踪 │         │
│  └─────────┘ └─────────┘          │
└───────────────────┬─────────────────┘
                    ↕
┌───────────────────▼─────────────────┐
│       内核层 (atoms)                │
│  系统调用 → 权限检查 → 资源访问      │
└─────────────────────────────────────┘

• 进程隔离
• 容器隔离
• WASM沙箱
• 资源限制

• RBAC模型
• YAML规则引擎
• 细粒度访问控制
• 权限缓存加速

• 正则过滤
• 类型检查
• 注入攻击防护
• 输入长度限制

• 全链路追踪
• 不可篡改日志
• 合规审计支持
• 异常行为检测

需求分析 → 设计阶段 → 开发阶段 → 测试阶段 → 部署阶段 → 运行阶段
   ↓           ↓           ↓           ↓           ↓           ↓
威胁建模    安全架构    安全编码    安全测试    安全部署    安全监控

完整列表: 安全公告归档

• 紧急安全事件: wangliren@spharx.cn (24小时响应)
• 一般安全咨询: security@spharx.cn (48小时响应)
• PGP公钥: [即将提供]

• cupolas 安全穹顶文档
• 安全编码规范
• 权限配置指南
• 审计日志规范
• ARCHITECTURAL_PRINCIPLES.md - 工程观章节
• CONTRIBUTING.md - 安全相关贡献规范
• CHANGELOG.md - 安全更新记录

感谢所有为 AgentOS 安全做出贡献的研究者、开发者和社区成员！

特别感谢：

• 发现并报告漏洞的安全研究者
• 参与安全审查的贡献者
• 提供安全建议的社区成员

名人堂: 安全贡献者名单