如何搭建本地私有AI笔记空间：Open Notebook快速上手指南

如何搭建本地私有AI笔记空间：Open Notebook快速上手指南

【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook

一堆 PDF 读完记不住重点？想让 AI 帮你读，又不想把资料上传到别人的云上？Open Notebook 是个直接的答案：它是个可部署在自己机器上的开源 AI 研究助手，把 PDF、网页等材料加进来，就能跟它们对话、让它写笔记、甚至把内容变成播客，数据全程留在本地。

它解决什么：你的资料，你的规则

很多研究类工具是这样的：想用 AI，就得先把文件传到它的云里。Open Notebook 反着来——服务跑在你自己的机器上，文件不离开你的硬盘，AI 却照样能帮你总结、提问。

另一件实在事是模型随便挑：OpenAI、Anthropic、Google 等 18 个以上提供商开箱即用；想零成本，就配一个 Ollama 本地模型，完全离线也能跑（电费除外）。

从零跑通：Docker 一条命令启动

前置条件只有一个：装好 Docker。AI 的密钥稍后在网页界面里填，不用先准备环境变量。

克隆仓库并进入目录：

git clone https://gitcode.com/GitHub_Trending/op/open-notebook cd open-notebook

启动前必须改一处：打开 docker-compose.yml，把 OPEN_NOTEBOOK_ENCRYPTION_KEY 的默认占位值换成你自己的任意密字符串（它用来加密存放在数据库里的 AI 密钥，别跳过这步）。

然后一条命令启动：

docker compose up -d

等大约 20 秒，浏览器打开 http://localhost:8502。看到笔记本列表的主界面，就算成功了。API 在 5055 端口后台跑着，新手暂时不用管它。

跑起来之后的 3 个实操步骤

第一步：配置 AI 提供商

进入Settings → API Keys，点Add Credential，选提供商，粘贴密钥，保存。接着点Test Connection，看到成功提示后，再点Discover Models和Register Models。做完这两下，Models 页面里就能看到可选择的模型列表。

第二步：建笔记本，加资料

点New Notebook起个名字。进笔记本后点Add Source：可以上传 PDF 文件，也可以直接粘贴一个网页链接。处理大约 30-60 秒，完成后资料出现在列表里、状态标记为已处理——这时候它才开始"可被提问"。

第三步：开聊，让它总结

在笔记本的聊天栏问一句"这份资料的重点是什么？"。发送后 AI 会基于你刚加的资料作答，并标出引用来源。同一份资料，还可以一键生成 1-4 位主播的播客，或跑自定义的内容转换任务 🎙️。

最容易踩的 3 个坑

页面打不开，提示"cannot connect to server"？先看两个容器是否真的在跑，不在就重启一次，再刷新浏览器：

docker ps docker compose restart

Test Connection 失败，或模型列表是空的？回到 Settings → API Keys 重新测试。还失败就删掉这条凭据重建，多数情况是密钥里多了空格。测试通过后记得再跑一次 Discover Models，否则模型列表不会自己长出来。

端口 8502 已被占用？把 docker-compose.yml 里的端口映射从 "8502:8502" 改成 "8503:8502"，重启后用 http://localhost:8503 访问即可。

写在最后

一句话总结：Open Notebook 把"读完了就忘"的一堆资料，变成一个可提问、能出播客的本地 AI 研究空间，数据自始自终在你手里。

想继续深入，看这两处就够：开始指南（OpenAI、云厂商、本地 Ollama 四条路径各配了 5 分钟流程）和故障排查速查（11 个常见问题，每个 1 分钟解决）。

【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook