企业官网建设流程全解析

3 步部署 open-notebook：5 分钟跑通本地 AI 笔记助手

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

想让自己的文档、链接能被 AI 检索并带引用地回答，却被数据库、环境配置劝退？下面用官方推荐的 Docker Compose 路线，带你 3 步、约 5 分钟部署 open-notebook 这个开源 AI 笔记系统。每一步都有明确的验证信号，你随时知道进行到哪了。

open-notebook 是什么

open-notebook 是一个 Notebook LM 的开源实现：把 PDF、网页链接等作为「来源」喂给它，就能与内容对话（回答带来源引用）、自动生成摘要笔记、还能把研究内容做成播客。它不绑定某一家模型，支持 OpenAI、Anthropic、Google 等 17 家以上提供商，也支持完全离线的本地模型。部署完成后，它就是一个跑在浏览器里的网页应用，数据全部留在你自己的机器上。

准备清单

开始前，确认这 4 项即可：

• ✅ Docker Desktop 已安装并在运行（唯一的硬性软件要求）
• 🔑 一家 AI 提供商的 API 密钥（OpenAI、Anthropic、Google 任选其一；若后面选本地模型则不需要）
• 本机 8502（网页）与 5055（API）两个端口空闲
• ⏱️ 5–10 分钟时间

不需要的东西：不用装 Python、Node.js，不用手动装数据库，也不用改任何代码——Docker Compose 会把应用和 SurrealDB 数据库一起拉起来。

三步启动服务

第 1 步：获取部署文件

做什么：把项目克隆到本地，部署配置docker-compose.yml就在仓库根目录，无需另外下载。

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

验证信号：目录里能看到docker-compose.yml，里面定义了surrealdb和open_notebook两个服务。

第 2 步：更换加密密钥

做什么：用编辑器打开docker-compose.yml，把OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string里的占位值改成你自己的随机字符串（比如my-secret-key-123）。

它是什么：这个密钥用来加密你存在数据库里的各家 API 密钥。对你有什么用：保持默认占位值的话，等于把自己的密钥敞着。

验证信号：文件里不再出现change-me字样。

第 3 步：启动服务

做什么：一条命令启动应用与数据库两个容器。

docker compose up -d

验证信号：约 20–30 秒后（首次要拉取镜像，会久一些），运行docker compose ps，看到surrealdb与open_notebook两个容器状态均为 Up。

验证部署成功并完成首次使用

按下面顺序走一遍，全部通过才算部署成功：

1. 终端执行curl http://localhost:5055/health，返回{"status": "healthy"}，说明后端就绪。
2. 浏览器打开http://localhost:8502，看到 open-notebook 主界面。
3. 进入Settings → API Keys → Add Credential，选你的提供商、粘贴密钥并保存。
4. 点击Test Connection确认成功，再点Discover Models → Register Models，模型就注册好了。
5. 点New Notebook建第一个笔记本，Add Source粘贴一个网页链接，等 30–60 秒处理完成，到 Chat 里提问——回答会带上来源引用，这就是它最核心的体验。

可选定制

以下都是可选项，按需要取用，默认配置已可用。

• （可选）改用本地模型：把docker-compose.yml换成 examples/docker-compose-ollama.yml，多了一个 Ollama 容器。不需要任何 API 密钥，数据不出机器；代价是首次拉模型较慢、对内存有要求。
• （可选）更换端口：8502 被占用时，把端口映射改成"8503:8502"，再用http://localhost:8503访问。
• （可选）数据位置：笔记本数据在./notebook_data，数据库在./surreal_data，定期备份这两个目录即可，无需额外导出工具。

另外说明一点：官方已弃用单容器镜像（v1-latest-single），新部署请直接走本文的 Docker Compose 路线。

常见坑

• 现象：启动时报Port 8502 already in use。原因：8502 端口被别的程序占用。修复：把端口映射改为8503:8502，用新端口访问。

• 现象：网页打不开或提示连不上 API。原因：首次启动需 20–30 秒初始化，等不及了。修复：用docker compose ps看状态，异常时用docker compose logs查看具体报错。

• 现象：Test Connection 失败。原因：密钥粘贴有误或提供商账户余额不足。修复：回提供商官网核对密钥，删除该凭证后重新添加。

写在最后

部署完成后，建议把几篇自己真正在读的资料加进笔记本，跑一轮带引用的对话，你会立刻理解来源、笔记和对话三者的关系。更多细节可以看 官方文档 与 Docker Compose 部署指南，遇到更具体的报错可以在 故障排查目录 里按症状查。先把服务跑起来，其余的功能都是顺手的事。

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