跳到主要内容

以离线模式运行 OPL 数据空间

离线模式让 OPL 数据空间在没有外网连接时尽量继续工作，但你仍需要自己准备本地模型、embedding 和语音模型。

核心变量​

OFFLINE_MODE=true
HF_HUB_OFFLINE=1
RAG_EMBEDDING_MODEL_AUTO_UPDATE=false
RAG_RERANKING_MODEL_AUTO_UPDATE=false
WHISPER_MODEL_AUTO_UPDATE=false

你会失去什么​

  • 自动版本检查
  • 从 Hugging Face 自动下载模型
  • embedding / rerank / whisper 自动更新

你仍然需要自己准备​

  • 本地 Whisper 模型
  • embedding 模型
  • 其他依赖外网下载的模型资源

两种思路​

Approach I​

从一开始就完全按离线目标准备，把所需模型手工下载后放进对应 cache 目录。

Approach II​

先在线完成安装和模型下载，再切成离线模式。这通常是更容易落地的做法。

进一步提醒​

OFFLINE_MODE=true 不是网络隔离本身。如果你要真正 air-gapped，还要在 Docker / 主机 / 网络层面切断实例的外网访问。