Docker 部署指南如果你希望在服务器或 NAS 上部署 OmniNote方便局域网内多人协同使用推荐使用 Docker 方式。模型推理服务在宿主机直接运行不走 Docker以获得最佳性能和 GPU 兼容性。一、适用场景部署方式适用场景快速开始个人电脑即装即用Docker 部署本文档服务器、NAS、局域网多人协同二、准备工作服务器已安装 Docker 和 Docker Compose从百度网盘下载部署文件百度网盘链接: https://pan.baidu.com/s/1n8vLUY53MfqJDfWDJLK89A?pwdw7ms文件说明omni-note-data数据文件配置、模型、工具、启动脚本omni-note-app_latest.tar.gzDocker 镜像三、部署步骤3.1 加载 Docker 镜像dockerload-iomni-note-app_latest.tar.gz3.2 准备数据目录统一的数据准备步骤见 数据准备Docker 部署额外注意将网盘中的docker-compose.yml放在omni-note/根目录下3.3 下载推理引擎若本机运行模型服务按 数据准备 · 下载推理引擎 下载并放置推理引擎若使用外部 API 可跳过本节。3.4 启动 OmniNote 容器cd~/omni-notedockercompose up-d3.5 启动模型服务./modelManager启动后浏览器打开http://127.0.0.1:8025在界面中操作即可。详细操作说明见 管理界面使用说明。3.6 访问浏览器打开http://服务器IP:7000四、最终目录结构部署完成后的最终目录结构见 数据准备 · 目录结构。五、使用外部 API可选如果不想在宿主机运行模型服务可以配置云端 API。编辑instance/config.pyMODEL_CONFIGS{LLM:{model:你的模型名称,model_server:https://api-inference.modelscope.cn/v1,api_key:你的API_KEY},}服务商API 地址ModelScopehttps://api-inference.modelscope.cn/v1DashScope阿里https://dashscope.aliyuncs.com/compatible-mode/v1火山引擎https://ark.cn-beijing.volces.com/api/v3OpenAIhttps://api.openai.com/v1六、日常运维# 查看运行状态dockerps|grepomni-note# 查看日志dockerlogs-fomni-note# 重启dockercompose restart# 停止dockercompose down七、数据备份所有数据在instance/目录下备份此目录即可tar-czfomni-note-backup-$(date%Y%m%d).tar.gz instance/也可以在 OmniNote 网页上使用数据备份与恢复功能。八、升级版本拿到新版本镜像后# 1. 停止容器dockercompose down# 2. 加载新镜像dockerload-iomni-note-app_latest.tar.gz# 3. 重新启动dockercompose up-dinstance/目录不要覆盖里面是你的数据。九、常见问题容器启动后无法访问dockerps|grepomni-note# 检查是否在运行dockerlogs omni-note# 查看启动日志知识库检索无结果确认嵌入/重排序模型服务在宿主机已启动检查instance/config.py中的服务地址在知识库管理页面点击重建索引上传文件报错检查instance/目录写入权限单文件不超过 50MB