Skip to content

Security: Versifine/Locus

Security

SECURITY.md

🔒 安全政策

支持的版本

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

版本 支持状态
0.1.x
< 0.1

报告安全漏洞

我们非常重视 Locus 的安全性。如果你发现了安全漏洞,请负责任地披露。

🚨 请不要公开披露安全问题

请勿通过公开 Issue 报告安全漏洞。相反,请通过以下方式私下报告:

报告方式

  1. GitHub Security Advisories(推荐)

  2. 邮件报告

报告应包含的信息

请在报告中包含以下信息(如适用):

  • 漏洞类型(例如:缓冲区溢出、SQL 注入、命令注入等)
  • 受影响的文件或组件
  • 漏洞位置(文件路径、行号、函数名等)
  • 复现步骤
  • 概念验证代码或利用脚本(如果可能)
  • 潜在影响评估
  • 修复建议(如有)

响应流程

  1. 确认(24 小时内)

    • 我们会在收到报告后 24 小时内确认收到
  2. 评估(3-5 个工作日)

    • 评估漏洞的严重性和影响范围
    • 确认是否为有效漏洞
  3. 修复(取决于严重性)

    • 严重漏洞:1-7 天
    • 中等漏洞:7-30 天
    • 低危漏洞:30-90 天
  4. 发布

    • 修复后发布安全补丁
    • 发布安全公告(征得报告者同意后)
    • 在 CHANGELOG 中记录
  5. 致谢

    • 在安全公告中感谢报告者(除非要求匿名)

安全最佳实践

如果你在使用 Locus,请遵循以下安全建议:

1. 配置安全

# ❌ 不要这样做(暴露在公网)
listen:
  host: "0.0.0.0"
  port: 25565

# ✅ 推荐做法(限制本地访问)
listen:
  host: "127.0.0.1"
  port: 25565

2. API 密钥管理

  • 永远不要将 API 密钥硬编码在代码中
  • 永远不要将包含 API 密钥的配置文件提交到 Git
  • 使用环境变量存储敏感信息
# 使用环境变量
export LOCUS_LLM_API_KEY="your-api-key"

# 或使用 .env 文件(确保添加到 .gitignore)
echo "LOCUS_LLM_API_KEY=your-api-key" > .env

3. 网络隔离

  • 在生产环境中使用防火墙限制访问
  • 仅允许必要的 IP 地址连接
  • 考虑使用 VPN 或 SSH 隧道

4. 日志安全

  • 不要在日志中记录敏感信息(密码、API 密钥等)
  • 定期清理旧日志文件
  • 限制日志文件的访问权限
# 设置正确的日志文件权限
chmod 600 logs/locus.log

5. 依赖更新

  • 定期运行 go get -u 更新依赖
  • 关注安全公告
  • 使用 go mod verify 验证依赖完整性

已知安全考虑事项

1. Minecraft 协议

  • Locus 目前支持离线模式服务器
  • 在线模式的加密和认证暂不支持
  • 不建议在生产环境中暴露在公网

2. LLM 集成

  • LLM API 调用可能包含游戏内聊天内容
  • 确保你信任 LLM 服务提供商
  • 注意不要通过聊天泄露敏感信息

3. 代理透明性

  • Locus 可以看到所有客户端和服务器之间的流量
  • 确保代理运行在可信的环境中
  • 注意访问控制和日志审计

安全审计

如果你是安全研究人员,欢迎对 Locus 进行安全审计。我们感谢负责任的披露。

范围内的活动

  • 代码审计
  • 依赖漏洞扫描
  • 本地渗透测试
  • 协议分析

范围外的活动

  • 拒绝服务(DoS)攻击
  • 社会工程学
  • 物理攻击
  • 对第三方服务的攻击

安全更新订阅

要接收安全更新通知:

  1. 在 GitHub 上 Watch 本仓库
  2. 选择 "Custom" → 勾选 "Security alerts"
  3. 关注 Releases 页面

历史安全公告

目前没有已发布的安全公告。


联系方式


感谢你帮助保持 Locus 的安全! 🙏

There aren't any published security advisories