RepoKnow 当前为早期版本,面向可信本机或受控私有环境。尚未把公网多租户部署作为已验收能力。
- Web 服务默认仅绑定回环地址;Docker Compose 也只映射本机端口。
- 默认关闭公开注册;管理员通过团队成员管理创建、启用或停用普通账号。可通过
REPOKNOW_ALLOW_REGISTRATION=1显式开放普通账号注册。停用撤销其全部登录会话和只读 Key,保留数据;重新启用不会恢复旧 Key。 - 管理员身份仅增加成员管理权限,不额外获得他人私有知识库的读取权限。“共享”知识库向所有启用的登录账号开放,停用所有者不会自动撤销既有共享。当前不支持 SSO、部门或细分角色授权。
- MCP Key 只用于查询当前账号可见的知识库,不能访问成员管理接口。导入、同步、凭证修改通过登录后的管理 API 执行。
- 成员通过自己的登录会话创建和撤销命名 MCP Key;Key 本身不能管理 Key。数据库只保存哈希,新 Key 仅创建时显示一次,默认长期有效,每个账号最多 20 个。请为不同客户端分别签发,丢失或不再使用时撤销;不要分发初始管理员 Key。
- 只有仓库所有者可修改知识库名称和可见性,管理员不额外获得此权限。共享改为私有后,其他成员的新查询即被拒绝;已下载或传递给外部 AI 客户端的内容无法收回。
- Token 使用 AES-256-GCM 加密,密钥与数据库位于同一数据目录。获得该目录的权限意味着可能获得凭证和私有源码。
- Git 抓取不 checkout、不执行仓库代码和 hook,不自动递归子模块。HTTPS 校验不关闭,组 / 组织 API 不跟随重定向,并校验返回仓库的归属和克隆地址。
- 源码过滤和发布扫描只覆盖常见模式,不保证检测任意秘密。请只导入已授权的仓库,评估保留的业务信息。
- Markdown 不执行原始 HTML,不自动加载图片。静态调用候选不能作为完整运行时调用图使用。
不要将 .data/、备份、Git 缓存、管理员凭证、Git Token 或含认证头的 MCP 配置公开。数据库备份应和密钥一起受控保存。若凭证曾被公开,应在对应平台撤销并重新签发;仅删掉文件不足以撤销访问。
优先使用仓库的 GitHub Security → Report a vulnerability 私密报告入口。发布本仓库的维护者需要先启用该入口。
如果入口尚未开放,请先通过 Issue 请求私密沟通渠道,只描述受影响的功能,不公开漏洞细节、利用代码、真实凭证或私有数据。此源码尚未指定维护者私密联系邮箱,不提供虚构地址。
报告应包括受影响版本、复现条件、影响范围和不含真实秘密的最小复现。当前维护版本为 0.2.x;旧版本请升级;不承诺固定响应时限。