腾讯ima知识库本地部署时数据完全保留在私有环境，但需主动配置安全策略：禁用公网暴露、上传前强制脱敏、设置四级权限隔离、启用本地模型推理闭环，并做好备份与操作审计。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯ima知识库本地部署时，数据完全保留在你自己的服务器或私有云环境中，但必须主动配置安全策略才能真正守住数据边界。不设置权限、不脱敏上传、不隔离网络，等于把机房大门敞开。
确认部署模式与数据归属
使用WeKnora开源框架部署ima知识库时，默认所有数据存储在本地磁盘或你指定的私有数据库中，【不连接腾讯任何远程服务，也不上传原始文档到腾讯服务器】。这是本地部署最根本的安全前提，务必在启动前检查config.yaml中disable_telemetry: true和upload_enabled: false两项已设为true。
若误启用ima.copilot的桌面小组件或AI搜索推荐功能，部分元数据（如知识库名称、访问频次）可能回传至腾讯用于基础运维统计——这一步必须手动关闭。
四步加固本地知识库数据链路
第一步：禁用公网暴露接口
Docker部署时，不要使用-p 8080:8080直接映射端口；改用--network=host并配合iptables仅放行内网IP段（如192.168.1.0/24），或通过Nginx反向代理加Basic Auth认证层。
第二步：文档上传前强制脱敏
对含用户ID、手机号、身份证号、银行卡号等字段的TXT/PDF/Excel文件，必须用Python脚本或专用工具（如Presidio）批量替换或删除。WeKnora本身不提供自动脱敏能力，【上传即入库，脱敏失败将永久留存敏感信息】。
第三步：设置四级权限隔离
在Web管理后台→团队设置→权限模板中，为“文档解析员”“问答调用者”“知识编辑者”“系统管理员”分别创建独立角色。特别注意：普通成员默认拥有“上传+查看+下载”全权限，需手动取消下载按钮权限（download_enabled: false）。
第四步：启用本地模型推理闭环
在model_config.yaml中将llm_provider设为ollama，model_name设为deepseek-r1:latest，并确保Ollama服务运行在同一内网机器上。避免配置openai_api_key或qwen_api_url等云端模型密钥——一旦泄露，所有知识库问答记录可能被上游API服务商缓存。
备份与审计要点
方法一：每日定时导出全量知识库快照
执行weknora-cli export --all --output /backup/ima_$(date +%Y%m%d).tar.gz，再用gpg加密后同步至离线NAS。
方法二：开启操作日志审计
修改logging.yaml，将audit_log_level设为INFO，并挂载宿主机目录/var/log/ima-audit/作为日志输出路径。重点监控upload_document、delete_knowledge、update_permission三类事件。
注意：WeKnora默认不记录用户提问内容，仅记录提问时间、用户ID、知识库ID和命中文档ID。如需完整问答审计，必须修改src/rag/core/retriever.py，在retrieve()函数末尾追加日志写入逻辑。
