1

README.md

@@ -145,6 +145,12 @@
 docker compose up -d --build
 ```
 
+> **Linux 服务器首次部署前**：`data/` 与 `workspace/` 由宿主机 bind mount 提供（相对 compose 文件目录，迁移时连目录内容一起拷贝）。若目录尚不存在或由 root 创建，容器内 `app` 用户（uid 1000）将无法写入 SQLite，须先执行：
+> ```bash
+> mkdir -p data workspace && chown -R 1000:1000 data workspace
+> ```
+> 迁移已有数据后还须检查 `data/system.db` 中 `model_config` 表的 `endpoint_url`：表里存的若是 `127.0.0.1`，在新机器上会指向自身，应改为实际模型服务可达地址。
+
 - 浏览器打开 http://localhost:8080
 - 启动日志中查看访问令牌（`docker compose logs rag-local` 搜索"访问令牌"）
 - 登录后按以下流程使用：