feat(server): 添加系统重启功能支持

添加后台任务支持用于处理系统重启请求，实现延迟进程终止机制，
允许系统安全地重启并在重启后自动恢复服务。

feat(frontend): 实现前端系统重启控制面板

在状态页面添加重启对话框组件，提供用户友好的重启确认界面，
包含重启状态监控和错误处理功能，确保用户可以安全重启系统。

docs(deployment): 更新部署指南添加URL协议要求说明

详细说明NANO_AUTHZ_URL和NANO_DEPLOY_URL环境变量必须包含
http://协议前缀的要求，添加常见错误示例和容器重建步骤，
帮助用户避免注册页面502错误问题。

app-instance/backend/nanobot/web/server.py

@@ -18,6 +18,7 @@ from urllib.parse import urlsplit, urlunsplit
 
 import httpx
 from fastapi import (
+    BackgroundTasks,
     FastAPI,
     File,
     Form,
@@ -112,6 +113,13 @@ async def _reconcile_managed_outlook_mcp(config: Config) -> bool:
     return before != after
 
 
+def _terminate_process_after_delay(delay_seconds: float = 1.0, exit_code: int = 1) -> None:
+    if delay_seconds > 0:
+        time.sleep(delay_seconds)
+    logger.warning("Self-restart requested; exiting backend process with code {}", exit_code)
+    os._exit(exit_code)
+
+
 # ============================================================================
 # Request/Response models
 # ============================================================================
@@ -1534,6 +1542,20 @@ def _register_routes(app: FastAPI) -> None:
                 app.state.auth_tokens.pop(token, None)
         return {"ok": True}
 
+    @app.post("/api/system/restart", status_code=202)
+    async def restart_system(
+        background_tasks: BackgroundTasks,
+        authorization: str | None = Header(default=None),
+    ):
+        username = _require_web_user(app, authorization)
+        logger.warning("Restart requested by user {}", username)
+        background_tasks.add_task(_terminate_process_after_delay, 1.0, 1)
+        return {
+            "ok": True,
+            "restarting": True,
+            "detail": "Restart scheduled",
+        }
+
     # ------ Chat ------
 
     @app.post("/api/chat")

app-instance/frontend/app/(app)/status/page.tsx

@@ -12,17 +12,29 @@ import {
   Key,
   Loader2,
 } from 'lucide-react';
-import { getStatus } from '@/lib/api';
+import { getStatus, restartSystem } from '@/lib/api';
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from '@/components/ui/alert-dialog';
 import { Button } from '@/components/ui/button';
 import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
 import { Badge } from '@/components/ui/badge';
-import { Separator } from '@/components/ui/separator';
 import type { SystemStatus } from '@/types';
 
 export default function StatusPage() {
   const [status, setStatus] = useState<SystemStatus | null>(null);
   const [error, setError] = useState<string | null>(null);
   const [loading, setLoading] = useState(true);
+  const [restartDialogOpen, setRestartDialogOpen] = useState(false);
+  const [restarting, setRestarting] = useState(false);
+  const [restartError, setRestartError] = useState<string | null>(null);
 
   const loadStatus = async () => {
     setLoading(true);
@@ -41,6 +53,36 @@ export default function StatusPage() {
     loadStatus();
   }, []);
 
+  useEffect(() => {
+    if (!restarting) {
+      return;
+    }
+
+    const intervalId = window.setInterval(async () => {
+      try {
+        await getStatus();
+        window.location.reload();
+      } catch {
+        // Ignore failures until the container is back.
+      }
+    }, 3000);
+
+    return () => {
+      window.clearInterval(intervalId);
+    };
+  }, [restarting]);
+
+  const handleRestart = async () => {
+    setRestartError(null);
+    try {
+      await restartSystem();
+      setRestartDialogOpen(false);
+      setRestarting(true);
+    } catch (err: any) {
+      setRestartError(err.message || '重启失败');
+    }
+  };
+
   if (loading) {
     return (
       <div className="flex items-center justify-center py-20">
@@ -80,7 +122,7 @@ export default function StatusPage() {
     <div className="max-w-4xl mx-auto p-6 space-y-6">
       <div className="flex items-center justify-between">
         <h1 className="text-2xl font-bold">系统状态</h1>
-        <Button onClick={loadStatus} variant="outline" size="sm">
+        <Button onClick={loadStatus} variant="outline" size="sm" disabled={restarting}>
           <RefreshCw className="w-4 h-4 mr-2" />
           刷新
         </Button>
@@ -94,17 +136,48 @@ export default function StatusPage() {
             系统信息
           </CardTitle>
         </CardHeader>
-        <CardContent className="space-y-3">
+        <CardContent>
-          <InfoRow
+          <div className="flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
-            label="配置"
+            <div className="space-y-1">
-            value={status.config_path}
+              <p className="text-sm font-medium">重启当前实例</p>
-            ok={status.config_exists}
+              <p className="text-sm text-muted-foreground">
-          />
+                {restarting
-          <InfoRow
+                  ? '正在重启当前 docker，服务恢复后页面会自动刷新。'
-            label="工作区"
+                  : '会重启当前 docker 容器。重启完成后需要重新登录。'}
-            value={status.workspace}
+              </p>
-            ok={status.workspace_exists}
+              {restartError ? (
-          />
+                <p className="text-sm text-destructive">{restartError}</p>
+              ) : null}
+            </div>
+            <AlertDialog open={restartDialogOpen} onOpenChange={setRestartDialogOpen}>
+              <Button
+                variant="destructive"
+                onClick={() => setRestartDialogOpen(true)}
+                disabled={restarting}
+              >
+                {restarting ? (
+                  <Loader2 className="w-4 h-4 mr-2 animate-spin" />
+                ) : (
+                  <RefreshCw className="w-4 h-4 mr-2" />
+                )}
+                Restart
+              </Button>
+              <AlertDialogContent>
+                <AlertDialogHeader>
+                  <AlertDialogTitle>确认重启当前实例？</AlertDialogTitle>
+                  <AlertDialogDescription>
+                    这会重启当前 docker 容器，页面会短暂不可用。由于当前登录态保存在内存里，重启完成后需要重新登录。
+                  </AlertDialogDescription>
+                </AlertDialogHeader>
+                <AlertDialogFooter>
+                  <AlertDialogCancel disabled={restarting}>取消</AlertDialogCancel>
+                  <AlertDialogAction onClick={handleRestart} disabled={restarting}>
+                    {restarting ? '重启中...' : '确认 Restart'}
+                  </AlertDialogAction>
+                </AlertDialogFooter>
+              </AlertDialogContent>
+            </AlertDialog>
+          </div>
         </CardContent>
       </Card>
 

app-instance/frontend/lib/api.ts

@@ -529,6 +529,16 @@ export async function getStatus(): Promise<SystemStatus> {
   return fetchJSON('/api/status');
 }
 
+export async function restartSystem(): Promise<{
+  ok: boolean;
+  restarting: boolean;
+  detail: string;
+}> {
+  return fetchJSON('/api/system/restart', {
+    method: 'POST',
+  });
+}
+
 // ---------------------------------------------------------------------------
 // Cron (proxied)
 // ---------------------------------------------------------------------------

部署指南.md

@@ -149,6 +149,47 @@ export NANO_DEPLOY_URL='http://nano-deploy-control:8090'
 
 如果这里不填，新用户注册时虽然页面可能能走到一半，但自动创建 `app-instance` 时大概率失败，因为实例配置里需要 `APP_INSTANCE_API_KEY`。
 
+`NANO_AUTHZ_URL` 和 `NANO_DEPLOY_URL` 也不能留空，而且必须带协议头。
+
+正确写法：
+
+```text
+http://nano-authz-service:19090
+http://nano-deploy-control:8090
+```
+
+错误写法：
+
+```text
+nano-authz-service:19090
+nano-deploy-control:8090
+172.19.207.13:19090
+172.19.207.13:8090
+```
+
+如果这里漏了 `http://`，注册页很容易直接报：
+
+```text
+502: Request URL is missing an 'http://' or 'https://' protocol.
+```
+
+还有一个很容易忽略的点：
+
+- 你在 shell 里重新 `export NANO_DEPLOY_URL=...`
+- 不会自动修改已经在运行中的 `nano-authz-service` 和 `nano-auth-portal`
+
+也就是说：
+
+- 变量改对了
+- 但容器没重建
+
+注册页还是会继续报同一个 502。
+
+改完变量以后，至少要重建这些容器：
+
+- `nano-authz-service`
+- `nano-auth-portal`
+
 ---
 
 ## 3. 创建运行目录
@@ -271,6 +312,26 @@ http://127.0.0.1:19090
 http://nano-authz-service:19090
 ```
 
+`DEPLOY_API_BASE_URL` 也一样，不能空，不能只写 `host:port`。
+
+这里如果传成空字符串，或者写成：
+
+```text
+nano-deploy-control:8090
+```
+
+注册页会在 `authz-service -> deploy-control` 这一步直接报：
+
+```text
+502: Request URL is missing an 'http://' or 'https://' protocol.
+```
+
+启动完可以立刻确认：
+
+```bash
+docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_ISSUER|DEPLOY_API_BASE_URL)='
+```
+
 ---
 
 ## 8. 启动 `deploy-control`
@@ -344,6 +405,14 @@ docker run -d \
 
 这个页面就是用户看到的登录/注册入口。
 
+虽然注册入口主要依赖 `AUTHZ_API_BASE_URL`，这里还是建议把 `DEPLOY_API_BASE_URL` 一起带上并确认非空，避免后面运行态调用 deploy-control 时再踩同一个坑。
+
+启动完可以确认：
+
+```bash
+docker inspect nano-auth-portal --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_API_BASE_URL|DEPLOY_API_BASE_URL)='
+```
+
 ---
 
 ## 10. 做健康检查
@@ -487,6 +556,75 @@ cd "$PROJECT_ROOT/app-instance"
 docker ps --format 'table {{.Names}}\t{{.Status}}' | grep app-instance
 ```
 
+如果注册页弹出：
+
+```text
+502: Request URL is missing an 'http://' or 'https://' protocol.
+```
+
+优先查这两条：
+
+```bash
+docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_ISSUER|DEPLOY_API_BASE_URL)='
+docker inspect nano-auth-portal --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_API_BASE_URL|DEPLOY_API_BASE_URL)='
+```
+
+重点看：
+
+- `nano-authz-service` 里的 `DEPLOY_API_BASE_URL`
+- `nano-auth-portal` 里的 `AUTHZ_API_BASE_URL`
+
+它们都必须是完整 URL，不能是空字符串，也不能是裸 `host:port`。
+
+如果你已经改过 `export NANO_DEPLOY_URL=...`，但这里查出来还是空，说明你只是改了当前 shell 变量，没有把容器重建掉。
+
+这时直接按下面重建：
+
+```bash
+export NANO_AUTHZ_URL='http://nano-authz-service:19090'
+export NANO_DEPLOY_URL='http://nano-deploy-control:8090'
+
+export NANO_DEPLOY_TOKEN="$(docker inspect nano-deploy-control --format '{{range .Config.Env}}{{println .}}{{end}}' | sed -n 's/^DEPLOY_CONTROL_API_TOKEN=//p')"
+export NANO_AUTHZ_INTERNAL_TOKEN="$(docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | sed -n 's/^AUTHZ_INTERNAL_TOKEN=//p')"
+
+docker rm -f nano-authz-service >/dev/null 2>&1 || true
+docker run -d \
+  --name nano-authz-service \
+  --restart unless-stopped \
+  --network "$NANO_NET" \
+  -p 19090:19090 \
+  -v "$PROJECT_ROOT/authz-service/runtime/data:/var/lib/authz-service/data" \
+  -e AUTHZ_ISSUER="$NANO_AUTHZ_URL" \
+  -e AUTHZ_INTERNAL_TOKEN="$NANO_AUTHZ_INTERNAL_TOKEN" \
+  -e DEPLOY_API_BASE_URL="$NANO_DEPLOY_URL" \
+  -e DEPLOY_API_TOKEN="$NANO_DEPLOY_TOKEN" \
+  nano/authz-service:latest
+
+docker rm -f nano-auth-portal >/dev/null 2>&1 || true
+docker run -d \
+  --name nano-auth-portal \
+  --restart unless-stopped \
+  --network "$NANO_NET" \
+  -p 3081:3081 \
+  -e AUTHZ_API_BASE_URL="$NANO_AUTHZ_URL" \
+  -e DEPLOY_API_BASE_URL="$NANO_DEPLOY_URL" \
+  -e DEPLOY_API_TOKEN="$NANO_DEPLOY_TOKEN" \
+  nano/auth-portal:latest
+```
+
+重建后再确认：
+
+```bash
+docker inspect nano-authz-service --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_ISSUER|DEPLOY_API_BASE_URL)='
+docker inspect nano-auth-portal --format '{{range .Config.Env}}{{println .}}{{end}}' | egrep '^(AUTHZ_API_BASE_URL|DEPLOY_API_BASE_URL)='
+```
+
+你必须看到：
+
+```text
+DEPLOY_API_BASE_URL=http://nano-deploy-control:8090
+```
+
 ---
 
 ## 15. 最常见的坑
@@ -539,7 +677,28 @@ http://nano-authz-service:19090
   - `APP_INSTANCE_DIR="$PROJECT_ROOT/app-instance"`
   - `ROUTER_PROXY_DIR="$PROJECT_ROOT/router-proxy"`
 
-### 5. `nip.io` 解析失败
+### 5. `NANO_DEPLOY_URL` 或 `NANO_AUTHZ_URL` 没带 `http://`
+
+典型现象：
+
+- 注册页直接弹：
+  - `502: Request URL is missing an 'http://' or 'https://' protocol.`
+
+原因：
+
+- `authz-service` 用 `DEPLOY_API_BASE_URL` 去调 `deploy-control`
+- `auth-portal` 用 `AUTHZ_API_BASE_URL` 去调 `authz-service`
+- 这些值如果是空，或者写成 `nano-deploy-control:8090` 这种不带协议的字符串，请求会直接失败
+- 就算你后来在 shell 里改对了，如果没重建相关容器，老的错误值仍然会继续生效
+
+正确写法：
+
+```text
+http://nano-authz-service:19090
+http://nano-deploy-control:8090
+```
+
+### 6. `nip.io` 解析失败
 
 如果实例跳转地址打不开，先试：
 
@@ -549,7 +708,7 @@ ping 127.0.0.1.nip.io
 
 如果你本地网络把 `nip.io` 拦了，这套子域名测试方式就会失效。
 
-### 6. 端口被占用
+### 7. 端口被占用
 
 默认会用到这些端口：