diff --git a/.gitea/workflows/deploy-front.yml b/.gitea/workflows/deploy-front.yml
index 95ad284..3904e58 100644
--- a/.gitea/workflows/deploy-front.yml
+++ b/.gitea/workflows/deploy-front.yml
@@ -14,6 +14,12 @@ jobs:
     # /data/www/userbase 与 docker.sock 由 act_runner 全局 options 统一挂载（见 act-runner config）
     container:
       image: node:20
+      # /data/www/userbase 由 job container.volumes 声明挂载。
+      # 关键点：act_runner 的 container.options 中多个 --volume 只有第一个生效，
+      # 因此静态目录不能放在 runner options 里，必须在 workflow 的 container.volumes 明确声明，
+      # 且 runner config 的 valid_volumes 白名单必须含该「完整 bind 字符串」才会放行。
+      volumes:
+        - /data/www/userbase:/data/www/userbase
     steps:
       # 内网 Gitea 无法访问 github.com 拉取 actions/checkout，改为直接 clone 本仓库
       - name: Checkout (manual, internal Gitea)