部署环境：Ubuntu 22.04.5 / 4 vCPU i3-N305 / 7.8G RAM / Docker v29.4.3 部署日期：2026-05-18 最后更新：2026-05-19

一、初始部署

按照教程用标准参数启动容器：

• LLM: DeepSeek API (deepseek-v4-flash)
• Embeddings: 智谱 embedding-3 (openai provider)
• Reranker: 默认 local (没改)

结果：容器反复崩溃重启

二、第一个坑 — HuggingFace 网络不通

现象：日志报 RuntimeError: Cannot send a request, as the client has been closed.，容器启动后 300 秒超时退出。

原因：默认的 local reranker 需要从 HuggingFace 下载 cross-encoder/ms-marco-MiniLM-L-6-v2 模型，国内访问不了 HuggingFace。

解决：加环境变量 HF_ENDPOINT=https://hf-mirror.com，走国内镜像。

三、第二个坑 — PostgreSQL 数据目录损坏

现象：每次重启都报 WARNING: pg0 data directory exists but no PG_VERSION found。