一、前言WeKnora 是腾讯开源的轻量化企业级知识库RAG系统支持本地私有部署、文档解析、语义检索、大模型问答。常规官方部署方案依赖Docker Desktop WSL2但大量Windows用户会遇到WSL内核损坏、服务启动失败、虚拟化异常、内存溢出等顽固问题。本文记录一套纯Windows原生、零Docker、零WSL、无需虚拟机的 WeKnora 完整部署方案搭配本地 Ollama 大模型实现私有化本地知识库同时汇总全程所有真实踩坑点与终极解决方案适合低配笔记本、WSL故障、不想折腾容器环境的用户。适配本机配置i7-8850H / 16G内存 / MX130 2G无GPU推理能力纯CPU运行二、整体部署架构摒弃官方Docker容器化方案采用轻量化原生架构最大化降低硬件、系统依赖大模型服务Ollama Windows 原生客户端本地离线运行知识库系统WeKnora 源码本地Go编译运行数据库SQLite 文件数据库无需安装PostgreSQL任务队列内存模式无需安装Redis向量检索内置数据库向量能力无需Qdrant/Milvus文件存储本地磁盘存储无需MinIO对象存储优势零依赖、零虚拟化、零容器、占用内存极低、普通Windows电脑即可稳定运行。三、前置环境准备1. 安装依赖工具Go 1.23用于编译运行WeKnora源码安装时勾选自动配置环境变量Ollama Windows版本地离线大模型推理服务2. 拉取适配本机的大模型16G内存、纯CPU设备最优模型组合稳定不卡顿、无内存溢出ollama pull qwen2.5:7b ollama pull nomic-embed-text模型说明qwen2.5:7b通用问答大模型默认Q4量化适配16G内存CPU推理nomic-embed-text文档向量嵌入模型用于知识库语义检索验证Ollama服务正常浏览器访问http://127.0.0.1:11434显示Ollama is running即为成功。3. 下载WeKnora源码从官方Github下载源码压缩包解压至全英文无空格路径禁止中文路径。四、核心配置文件 .env 适配改造官方默认.env是Docker容器专用配置直接使用必报错。针对Windows原生运行进行全套适配改造核心修改点如下1. 关键改造逻辑容器域名host.docker.internal / postgres / redis全部废弃替换为本地127.0.0.1数据库从PostgreSQL改为SQLite免安装、零配置队列从Redis改为内存模式去除中间件依赖密钥严格规范修复AES密钥长度报错2. 完整可用.env配置Windows原生专用# WeKnora Windows 原生部署配置无Docker、无WSL # 基础运行配置 WEKNORA_VERSIONlatest GIN_MODErelease TZAsia/Shanghai AUTO_MIGRATEtrue AUTO_RECOVER_DIRTYtrue # 本地服务地址 APP_HOST127.0.0.1 APP_PORT8080 DOCREADER_ADDR127.0.0.1:50051 DOCREADER_TRANSPORTgrpc # 轻量化数据库配置SQLite 无需额外安装 DB_DRIVERsqlite DB_PATH./weknora.db # 内存队列禁用Redis STREAM_MANAGER_TYPEmemory # 本地文件存储 STORAGE_TYPElocal LOCAL_STORAGE_BASE_DIR./data/files MAX_FILE_SIZE_MB50 # Ollama本地模型配置 OLLAMA_OPTIONALtrue OLLAMA_BASE_URLhttp://127.0.0.1:11434 LLM_MODELqwen2.5:7b EMBED_MODELnomic-embed-text # 文档解析参数 DOCREADER_GRPC_MAX_WORKERS4 DOCREADER_PDF_RENDER_DPI200 WEKNORA_DOCUMENT_PROCESS_TIMEOUT2h # 安全密钥请勿照搬可自定义AES严格32位字符 JWT_SECRETwk-local-win-secret-20260820 SYSTEM_AES_KEYabcdef123456abcdef123456abcdef12 # 账号注册配置 DISABLE_REGISTRATIONfalse WEKNORA_AUTH_DEFAULT_TENANT_MODEcreate_personal # 智能体超时 WEKNORA_AGENT_LLM_TIMEOUT300 # 并发限制 CONCURRENCY_POOL_SIZE5五、WeKnora 启动步骤1. 配置Go代理解决依赖下载失败go env -w GOPROXYhttps://goproxy.cn,direct2. 下载项目依赖go mod download3. 启动服务go run main.go4. 启动成功标识终端输出以下日志即为正常启动Loaded env from .envusing sqlite driverauto migrate database successserve http on 127.0.0.1:80805. 访问系统浏览器打开http://127.0.0.1:8080注册账号即可创建本地私有知识库、上传文档问答。六、部署全程核心踩坑汇总 终极解决方案本文汇总本次部署所有真实报错、坑点每一条均对应原因精准解决办法全网通用。坑1WSL内核更新报错无法安装Docker报错现象执行wsl --update提示「配置成在该可执行程序中运行的这个服务不能执行该服务」WSL服务损坏无法启动Docker。根因Windows系统WSL组件注册表/服务异常无法通过命令行修复。解决方案彻底放弃DockerWSL方案改用Windows原生源码部署完全规避虚拟化、容器所有问题。坑2Ollama模型拉取报错 file does not exist报错现象执行ollama pull qwen2.5:7b-q4_K_M提示模型不存在。根因错误拼接量化后缀Ollama官方qwen2.5:7b默认就是Q4量化无需手动加后缀。解决方案使用标准命令拉取模型ollama pull qwen2.5:7b坑3Docker环境配置照搬Ollama连接失败报错现象WeKnora无法调用大模型提示Ollama连接拒绝。根因原生Windows环境不识别Docker专属域名host.docker.internal。解决方案.env中Ollama地址改为本地回环地址http://127.0.0.1:11434坑4启动报错 AES key length must be 32报错现象服务启动直接崩溃提示AES密钥长度非法。根因官方示例密钥长度不标准SYSTEM_AES_KEY必须严格32个字符。解决方案替换为32位固定密钥不增不减。坑5必须依赖PostgreSQL/Redis启动失败报错现象默认配置连接postgres、redis容器地址本地无服务直接报错。解决方案数据库改为sqlite、队列改为memory零中间件依赖。坑6中文路径导致服务启动异常、文件解析失败根因Go项目、Ollama、知识库系统均不支持中文、空格路径。解决方案全程使用纯英文路径部署项目。坑7MX130 2G显卡无法加速大模型问题显卡显存过低无法承载任何7B模型GPU推理。解决方案无需配置GPUOllama自动CPU推理7B量化模型完美适配16G内存。坑8网页解析失败、URL报错、内网地址无法访问现象系统自动抓取docker内网域名、空域名、无效地址提示解析失败。根因默认配置残留大量容器环境无效路由。解决方案改用轻量化原生配置清除所有容器环境冗余配置。坑9重启电脑后模型丢失误区用户误以为重启需要重新拉取模型。真相Ollama模型存储在系统隐藏目录C:\Users\Administrator\.ollama\models重启、关机不会丢失无需重复下载。七、最终总结1.低配Windows机器最优方案放弃官方Docker/WSL容器部署采用「Ollama本地模型 WeKnora源码原生运行 SQLite轻量化架构」适配绝大多数普通笔记本无虚拟化开销、不卡死、不报错。2.核心避坑核心容器环境配置绝对不能直接用于Windows原生部署必须修改Ollama地址、数据库、队列、密钥四大核心配置。3.硬件适配结论i7-8850H16G内存纯CPU环境qwen2.5:7b nomic-embed-text是唯一稳定可用组合13B及以上模型会内存溢出、卡顿严重。4.部署优势全程零收费、零联网依赖、数据本地私有化存储、无第三方接口调用完全实现离线私有知识库问答。