企业官网建设流程全解析

SocratiCode全本地部署指南：零云端、零API Key的隐私优先企业级代码搜索

【免费下载链接】SocratiCodeEnterprise-grade (40m+ LOC) codebase intelligence, zero-setup, local & private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis & call-flow, interactive HTML viewer, cross-project & branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.项目地址: https://gitcode.com/gh_mirrors/so/SocratiCode

SocratiCode 是一款开源的代码库智能搜索引擎，本指南带你完成它的全本地部署：混合语义代码搜索、多语言依赖图谱、符号级影响分析全部运行在你自己的机器上，零云端、零 API Key，源码与索引永不出内网，天然适配企业级隐私场景。

小彩蛋：标识中苏格拉底像背后的代码，来自阿波罗 11 号制导计算机（AGC）的原始源码（Comanche055），一个"古老代码"与"代码智能"的巧妙呼应。

一、为什么选择全本地的代码搜索？

AI 编程助手默认靠"读文件 + grep"理解代码库，既费 Token 又依赖网络。SocratiCode 把理解工作提前算好并存在本地，带来三重收益：

默认部署由三个部分组成，全部自动管理：

二、部署前提：只需准备 2 样东西

1. Node.js 18.17 或更新版本（PATH 中可用npx）——运行 MCP 引擎。
2. Docker 处于运行状态——自动托管 Qdrant 和 Ollama 容器。

💡 macOS / Windows 用户提示：Docker 容器无法调用 GPU。中小项目直接用默认配置即可；中大型仓库建议额外安装原生 Ollama，SocratiCode 启动时会自动探测（端口 11434）并优先使用它，获得 Metal/CUDA 加速，无需改动任何配置。

三、第 1 步：三行配置接入你的 AI 助手

SocratiCode 是一个标准的本地 stdio MCP 服务器。在你的 MCP 宿主（Claude Code、VS Code、Cursor、Zed 等）配置中加入我们仓库里现成的 mcp.json 即可：

{ "mcpServers": { "socraticode": { "command": "npx", "args": ["-y", "--prefer-online", "socraticode@latest"] } } }

不同宿主（Claude Code 插件、VS Code 扩展、Cursor、Gemini CLI 等）各有专用安装方式，官方提供了按宿主划分的快速指南，入口在 docs/guides/README.md，纯本地场景可重点参考 docs/guides/local-only.md。

四、第 2 步：零配置，本地栈自动拉起

重启宿主后什么都不用做。首次使用时，引擎会自动完成：

1. 检查 Docker，拉取所需镜像；
2. 启动托管容器socraticode-qdrant与socraticode-ollama，并挂载持久化数据卷；
3. 首次调用时自动下载本地 Embedding 模型（nomic-embed-text）。

这套栈的容器编排定义在 docker-compose.yml 中，几个贴心的设计：

• 非标端口（Qdrant 用 16333/16334，Ollama 用 11435），避免与你已有的 Qdrant/Ollama 实例冲突；
• --restart unless-stopped，容器自动恢复；
• 数据存于本机卷，重启不丢索引。

初始设置约需 5 分钟（取决于网速），之后再启动只需几秒。

五、第 3 步：首次索引与第一次搜索

打开任意代码项目，对 AI 助手说：

"Index this codebase"（索引这个代码库）

后台开始索引，随时问"What is the codebase index status?"查看进度。300 万行代码首次索引在 Mac M4 上不到 10 分钟；中断、崩溃都会自动断点续传，已处理文件凭哈希跳过。索引完成后：

文件监听器默认开启：之后每次文件变更，索引自动增量更新，无需任何手动操作。

六、进阶：更严格的"纯本地"姿势

默认配置已经完全本地，但官方为"源码必须全程不离开机器"的场景提供了 local-only 指南，核心是给 MCP 服务器加两个环境变量：

OLLAMA_MODE=external OLLAMA_URL=http://localhost:11434

即强制使用你原生安装的 Ollama（而非 Docker 容器），其余全部保持默认：Embedding 走本地 Ollama（默认nomic-embed-text）、向量库走托管本地 Qdrant。修改后重启 MCP 服务器生效。

⚠️ 注意一条边界：SocratiCode 保证的是索引与搜索链路不出本机；你使用的 AI 编程助手本身（提示词与工具结果的传输）遵循其自身服务商的策略，涉及敏感源码前请先确认这条边界。

七、常见问题速查

Q1：内网/离线环境能用吗？初始下载 npm 包、Docker 镜像和模型需要一次联网；之后索引、搜索、图谱可视化（HTML 资源全部随包内置）全程零网络，适合气隙部署。

Q2：索引到一半断网/关机了？直接重新发起索引即可——引擎按批检查点，自动跳过已完成的文件，从断点继续，进度不丢。

Q3：换了 Embedding 模型会怎样？已有集合保留原模型构建的向量继续可用，状态工具会提示"待生效"；确认切换后再删除并重建索引即可。

Q4：多个 AI 助手能共用一个索引吗？可以。多实例通过跨进程文件锁自动协调：一个负责索引与监听，其余并发搜索，互不冲突。

Q5：只想让 AI 读文档里的配置和数据库结构？在项目根目录放一个.socraticodecontextartifacts.json，把 SQL schema、OpenAPI 规范、K8s 清单登记为"上下文工件"，它们会和代码一起被本地索引与语义搜索。

写在最后

从三行配置到完整跑通，SocratiCode 的全本地部署没有任何云账号、没有 API Key、没有配置文件的繁琐——你得到的是一套代码不出内网的企业级代码搜索与智能分析能力。更多安装路径与全部环境变量，请查阅 README.md 的 Quick Start 与 Environment Variables 章节。

【免费下载链接】SocratiCodeEnterprise-grade (40m+ LOC) codebase intelligence, zero-setup, local & private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis & call-flow, interactive HTML viewer, cross-project & branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.项目地址: https://gitcode.com/gh_mirrors/so/SocratiCode