Selaa lähdekoodia

修复 Docker 工作目录持久化配置

Samien 5 päivää sitten
vanhempi
sitoutus
3c5cb0c175
5 muutettua tiedostoa jossa 18 lisäystä ja 5 poistoa
  1. 1 1
      README.md
  2. 3 0
      compose.desktops.cursor.yaml
  3. 3 0
      compose.desktops.yaml
  4. 3 0
      compose.yaml
  5. 8 4
      docs/docker-install.md

+ 1 - 1
README.md

@@ -95,7 +95,7 @@ docker compose --env-file docker.env config --quiet
 docker compose --env-file docker.env up -d --build
 ```
 
-默认访问 `http://127.0.0.1:15300`。应用数据保存在 `yaoyao-data` 命名卷,容器内路径为 `/home/node/.yaoyao`。首次打开页面创建管理员账号,并在“我的设置 → 管理 → 模型服务”中配置模型。
+默认访问 `http://127.0.0.1:15300`。应用数据保存在 `yaoyao-data` 命名卷,容器内路径为 `/home/node/.yaoyao`;默认工作目录 `/home/node/Agents` 保存在 `yaoyao-home` 命名卷。首次打开页面创建管理员账号,并在“我的设置 → 管理 → 模型服务”中配置模型。
 
 宿主机连接、局域网访问、验证及升级步骤见 [Docker 部署说明](docs/docker-install.md)。
 

+ 3 - 0
compose.desktops.cursor.yaml

@@ -36,6 +36,8 @@ services:
       HERMES_YAOYAO_APNS_TEAM_ID: "${HERMES_YAOYAO_APNS_TEAM_ID:-}"
       HERMES_YAOYAO_APNS_TOPIC: "${HERMES_YAOYAO_APNS_TOPIC:-}"
     volumes:
+      # The default /home/node/Agents workspace must remain writable and persistent.
+      - yaoyao-home:/home/node
       - yaoyao-data:/home/node/.yaoyao
       - desktop-cursor-ipc:/run/yaoyao-desktops/desktop-cursor:ro
       - desktop-cursor-network-ipc:/run/yaoyao-networks/desktop-cursor:ro
@@ -92,6 +94,7 @@ services:
       - desktop-cursor-network-ipc:/run/yaoyao-network
 
 volumes:
+  yaoyao-home:
   yaoyao-data:
 
   desktop-cursor-workspace:

+ 3 - 0
compose.desktops.yaml

@@ -36,6 +36,8 @@ services:
       HERMES_YAOYAO_APNS_TEAM_ID: "${HERMES_YAOYAO_APNS_TEAM_ID:-}"
       HERMES_YAOYAO_APNS_TOPIC: "${HERMES_YAOYAO_APNS_TOPIC:-}"
     volumes:
+      # The default /home/node/Agents workspace must remain writable and persistent.
+      - yaoyao-home:/home/node
       - yaoyao-data:/home/node/.yaoyao
       - desktop-1-ipc:/run/yaoyao-desktops/desktop-1:ro
       - desktop-1-network-ipc:/run/yaoyao-networks/desktop-1:ro
@@ -140,6 +142,7 @@ services:
       - desktop-2-network-ipc:/run/yaoyao-network
 
 volumes:
+  yaoyao-home:
   yaoyao-data:
 
   desktop-1-workspace:

+ 3 - 0
compose.yaml

@@ -34,9 +34,12 @@ services:
       HERMES_YAOYAO_APNS_TEAM_ID: "${HERMES_YAOYAO_APNS_TEAM_ID:-}"
       HERMES_YAOYAO_APNS_TOPIC: "${HERMES_YAOYAO_APNS_TOPIC:-}"
     volumes:
+      # The default /home/node/Agents workspace must remain writable and persistent.
+      - yaoyao-home:/home/node
       - yaoyao-data:/home/node/.yaoyao
     tmpfs:
       - /tmp:mode=1777
 
 volumes:
+  yaoyao-home:
   yaoyao-data:

+ 8 - 4
docs/docker-install.md

@@ -42,6 +42,8 @@ cp docker.env.example docker.env
 
 内置 Hermes 的会话、Profile、模型配置和凭据都保存在 `yaoyao-data` 数据卷的 `hermes/` 目录;首次登录后在“我的设置 → 管理 → 模型服务”中配置模型。
 
+Compose 同时将 `yaoyao-home` 数据卷挂载到 `/home/node`,使默认工作目录 `/home/node/Agents` 在只读容器中可写,并在重建容器后保留文件。三个仓库提供的 Compose 部署文件均包含此配置;自定义部署也需要为该目录提供持久化可写挂载,且容器内 `node` 用户(UID 1000)须有读写权限。
+
 使用远程镜像时,在 `docker.env` 设置上述镜像标签后执行:
 
 ```sh
@@ -83,6 +85,7 @@ docker compose --env-file docker.env -f compose.yaml -f compose.hermes-import.ya
 ```sh
 curl --fail http://127.0.0.1:15300/healthz
 curl --fail http://127.0.0.1:15300/readyz
+docker compose --env-file docker.env exec web node -e "const fs=require('fs'); fs.mkdirSync('/home/node/Agents',{recursive:true}); fs.accessSync('/home/node/Agents',fs.constants.W_OK)"
 docker compose --env-file docker.env logs --tail=100 web
 ```
 
@@ -231,18 +234,19 @@ node yaoyao-runner/runner.mjs --config /完整路径/runner.json
 
 ## 数据与备份
 
-Compose 使用 `yaoyao-data` 命名卷,挂载到 `/home/node/.yaoyao`。账号、SQLite 数据库、聊天缓存、文件及密钥随数据卷持久保存。固定桌面部署还必须备份每台桌面的 `desktop-*-workspace` 卷;`desktop-*-ipc` 卷只是连接通道。
+Compose 使用 `yaoyao-data` 命名卷,挂载到 `/home/node/.yaoyao`。账号、SQLite 数据库、聊天缓存、文件及密钥随数据卷持久保存。`yaoyao-home` 卷保存 `/home/node` 下的工作文件,其中 `/home/node/Agents` 是默认工作目录;备份时两个卷都要保存。固定桌面部署还必须备份每台桌面的 `desktop-*-workspace` 卷;`desktop-*-ipc` 卷只是连接通道。
 
 备份时先停止 Web,然后复制完整数据目录,再启动服务:
 
 ```sh
-mkdir -p backups
+mkdir -p backups/data backups/home
 docker compose --env-file docker.env stop web
-docker compose --env-file docker.env cp web:/home/node/.yaoyao/. ./backups/
+docker compose --env-file docker.env cp web:/home/node/.yaoyao/. ./backups/data/
+docker compose --env-file docker.env cp web:/home/node/. ./backups/home/
 docker compose --env-file docker.env start web
 ```
 
-为每次备份使用独立目录,并保留文件权限。恢复时将完整备份放回数据卷,确认容器内 `node` 用户可以读写后再启动服务。
+`home` 备份中包含挂载的 `.yaoyao` 数据,与 `data` 备份重复;恢复时分别将 `data` 放回 `yaoyao-data`,将 `home` 中除 `.yaoyao` 外的内容放回 `yaoyao-home`。为每次备份使用独立目录,并保留文件权限;确认容器内 `node` 用户可以读写后再启动服务。
 
 ## 升级与停止