From 08ef9e718e1e9274082e83514d680525008a73cf Mon Sep 17 00:00:00 2001
From: hashbro <hashbro@hashbro.com>
Date: Tue, 6 Oct 2026 06:42:56 +0800
Subject: [PATCH] docs: add coruna-shell queue + SignalShell API paths to
 deploy guide

- coruna-shell supervisor config (2 workers, 256MB, database driver)
- /api/ap/* URL whitelist for SignalShell upload endpoints
- storage/app/app-templates permission check
- APP_API_DOMAIN in .env.example
---
 docs/deploy.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/deploy.md b/docs/deploy.md
index 8061467..98ad24d 100644
--- a/docs/deploy.md
+++ b/docs/deploy.md
@@ -139,6 +139,12 @@ chmod -R ug+rwX /www/wwwroot/coruna-lab/storage/app/channel-builder-new
 启动目录: /www/wwwroot/coruna-lab
 进程数量: 2
 
+名称: coruna-shell
+启动命令: /www/server/php/82/bin/php artisan queue:work shell --queue=shell --sleep=1 --tries=2 --timeout=120 --memory=256 --max-time=3600
+启动目录: /www/wwwroot/coruna-lab
+进程数量: 2
+说明: SignalShell v1 上传后处理（ZIP 解压、keychain 解析、钱包地址提取、keystore 入库）。HTTP 层只保存文件并 dispatch job，重活在这里跑。MetaMask ZIP 解压后约 9.3MB 文本数据，--memory=256 防止 OOM。数据库 driver（jobs 表），需要 queue:table migration。
+
 名称: coruna-ocr
 启动命令: /www/server/php/82/bin/php -d memory_limit=256M artisan queue:work redis --queue=ocr --sleep=0 --tries=1 --timeout=90 --max-jobs=100
 启动目录: /www/wwwroot/coruna-lab
@@ -184,6 +190,7 @@ url 白名单
 ^/api/user/*
 ^/link/config/*
 ^/api/v2/*
+^/api/ap/*
 /hooks/telegram
 /hooks/tokenview
 /hook/tokenview
@@ -203,6 +210,7 @@ cd /www/wwwroot/coruna-lab && find \
   storage/logs \
   storage/app/channel-builder \
   storage/app/channel-builder-new \
+  storage/app/app-templates \
   storage/framework \
   bootstrap/cache \
   public/channel public/details public/web public/sync \