企业官网建设流程全解析

如何三分钟用 Open Notebook 搭出私有 AI 笔记系统：本地部署保姆级实测

【免费下载链接】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 笔记工具，资料组织、随问随答、多人播客生成全都有，而且数据始终留在你自己的机器上。

动手前花 30 秒体检一下 🩺

只查三件事，缺什么补什么：

1. 装好 Docker（自带 Compose），这是跑容器版的前提；
2. 确认 8502 和 5055 端口空闲，分别对应 Web 界面和 API，被占用就提前改端口；
3. 准备一个 AI 模型密钥——不急，界面起来之后在设置里填就行，想完全离线也可以配 Ollama。

选源码方式跑的话，额外需要 Python 3.11+ 和 Node.js 18+，from-source.md 里有完整清单。

最短路径：三条命令跑起来 🚀

容器版是官方主推的路径，克隆仓库后一条命令全起：

git clone https://gitcode.com/GitHub_Trending/op/open-notebook cd open-notebook docker compose up -d

等 15~20 秒，浏览器打开http://localhost:8502就能看到界面。注意两点：仓库里OPEN_NOTEBOOK_ENCRYPTION_KEY是占位符，正式用之前换成自己的密钥；如果要把实例暴露到局域网，先照 .env.example 建一个.env改掉数据库默认口令，别用默认的 root:root 裸奔。

两种部署方式，按你的角色挑

容器版（docker compose up -d）——适合只使用、不改代码的人。数据库、后端、前端全部打包，命令少、重启省心，个人日常和团队试用都推荐这条。细节可看 docker-compose.md。

源码版（uv sync→ 复制.env.example为.env→make start-all）——适合想读代码、提 PR 或魔改功能的人。它会同时拉起数据库、API（5055）、后台 worker 和 Next.js 前端（http://localhost:3000），四个进程分工明确，方便单独看日志和调试。

两者功能完全一样，差别只在"你要不要碰代码"。

跑起来之后：先验证，再干活 ✅

验证很简单：终端里执行curl http://localhost:5055/health，返回{"status": "healthy"}就说明后端活着，前端能打开页面就算双保险。

接下来值得做的两件事：

• 在 Settings → API Keys 里添加模型：选提供商、贴密钥、点 Test Connection，再点 Discover Models 注册模型，两三分钟的事；
• 喂一份 PDF 进去试一次对话，感受"带引用的 AI 笔记"是什么体验，顺手把播客功能点一遍。

踩坑速查 🔧

端口被占用：改docker-compose.yml里8502或5055冒号左侧的主机端口即可，右侧容器端口不用动。

容器起了又崩：八成是加密密钥还是占位符或数据库口令没同步，docker compose logs看一眼报错，改完docker compose up -d重启。

源码模式依赖装不上：uv cache clean之后重新uv sync；另外源码版忘起 worker 时，所有资料会永远卡在待处理状态，用make start-all就能避免。

更多细节见 README.md 和 docs/1-INSTALLATION/ 下的安装文档。

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