企业官网建设流程全解析

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

open-notebook 是 Notebook LM 的自托管开源实现，跑在你自己的机器上，支持对着资料 AI 聊天、向量搜索和播客生成。本文带你完成 open-notebook 部署：从装 Docker 到 AI 回答你的第一个问题。

项目速览

open-notebook 是一个自托管的开源 AI 笔记系统，Google Notebook LM 的私有替代方案。它解决一个问题：你想把 PDF、网页、音频喂给 AI，但数据不想离开自己的机器。适合学生、研究员和内容创作者。

• 笔记本管理：按主题组织来源和笔记
• AI 聊天：针对笔记本内来源对话，答案带引用
• 向量+全文搜索：覆盖你全部已处理内容
• 播客生成：把资料变成多人对谈音频
• 18+ 模型提供商：云 API 和 Ollama 本地模型都支持

5分钟跑起来

最短路径是 Docker Compose：一个数据库容器加一个应用容器。内存 4GB 以上的机器，从零到打开页面约 5 分钟。

1. 装 Docker Desktop—— 免费。装完确认命令可用。

docker --version

看到版本号说明环境就绪。

2. 获取项目—— 克隆仓库并进入目录，根目录就带官方 docker-compose.yml。

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

3. 设置加密密钥—— 打开 docker-compose.yml，把 change-me-to-a-secret-string 换成你自己记不住的字符串。它用来加密你稍后存入的 API 密钥。

4. 启动服务—— 首次启动会拉取两个镜像，等 1-2 分钟。

docker compose up -d

浏览器打开 http://localhost:8502，看到界面即部署成功。

5. 注册 AI 模型—— 进入 Settings → API Keys，添加提供商和密钥，点 Test Connection，通过后 Discover Models 注册模型。约 2 分钟。

想核对每个参数，看 Docker Compose 部署文档。

按场景选部署方式

个人试用：用上面的默认配置，配一把云 API 密钥（OpenAI 即可）。5 分钟能用上，费用按量计费，约每 1K token $0.01-$0.10。

本地隐私：不想让数据出网，就配 Ollama 本地模型。仓库 examples 目录有现成的 docker-compose-ollama.yml，多一个 ollama 容器。首次要等模型下载约 10 分钟，之后完全离线，零费用。

团队/生产使用：仍用 Docker Compose，先做三件事：改数据库账号密码、不把 8502 端口直接暴露公网、前面加反向代理。参考 反向代理与安全配置文档。只改密码当天就能用，连代理再预留 30 分钟。

关键配置说明

OPEN_NOTEBOOK_ENCRYPTION_KEY—— 默认值是仓库里的占位符 change-me-to-a-secret-string。在 docker-compose.yml 中换成你自己编的字符串。改完后，数据库里的密钥由它加密；忘了这个值，旧密钥就解不开了。

端口映射—— 默认界面 8502、API 5055。改 docker-compose.yml 的 ports 字段，比如改成 "8503:8502"。改完从 http://localhost:8503 访问。8502 被占用时必改。

数据库账号密码—— 默认 root:root，且数据库端口只监听 127.0.0.1。在同目录 .env 里写 SURREAL_USER 和 SURREAL_PASSWORD，两个容器自动读取。要开放到局域网时必改。

卡住了？先看这里

现象：端口被占用—— docker compose up 报 "Port 8502 is already allocated"。原因：别的程序已经占了 8502。解决：

lsof -i :8502

找到占用进程停掉，或把 compose 文件端口改成 8503 后重启。

现象：页面提示 Cannot connect to server原因：API 还没就绪。首次启动要拉镜像，需要 20-30 秒。解决：等 1 分钟后验证，返回 {"status":"healthy"} 即正常；仍不行就重启服务。

curl http://localhost:5055/health docker compose restart

现象：模型列表为空、连接测试失败原因：API 密钥填错或带了多余空格。解决：Settings → API Keys 里点 Test Connection；失败就去提供商后台重新生成密钥，再 Discover Models 注册。

部署完之后

• 数据管理：你的数据都在 surreal_data 和 notebook_data 两个目录里，定期复制到别处即可，换机器也能整体搬走。
• 安全：改掉数据库默认密码，8502 端口别暴露公网；需要外网访问就走反向代理。
• 性能：本地模型跑在单 GPU 上时，把 OPEN_NOTEBOOK_WORKER_MAX_TASKS 设为 1，任务逐个处理，避免模型被并发请求拖垮。

系统已经跑起来了。现在打开 Settings 添加第一把 API 密钥，建一个笔记本，丢进去一份 PDF，一分钟左右拿到你的第一个 AI 回答。

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