feat(pages): import deployment packages from URL

Add upload-from-url so admins can paste an HTTP(S) link and let the control
plane download the archive with browser-like headers. Private/LAN hosts and
insecure TLS certificates are allowed for internal artifact stores; package
size and format checks reuse the existing local-upload pipeline.

frontend/app/(main)/admin/settings/components/openflare-ops.tsx

@@ -468,7 +468,8 @@ export function OpenFlareOpsSettings() {
             />
           </div>
           <p className='text-xs text-muted-foreground'>
-            每个项目最多保留 N 条部署：激活部署始终保留，其余按从新到旧填充；超出的非激活部署会在上传成功后自动清理。支持
+            每个项目最多保留 N
+            条部署：激活部署始终保留，其余按从新到旧填充；超出的非激活部署会在上传成功后自动清理。支持
             zip、tar.gz、tar.xz、tar.bz2、tar、7z 格式。
           </p>
         </CardContent>

frontend/app/(main)/pages/components/deployment-upload-dialog.tsx

@@ -2,7 +2,7 @@
 
 import { useRef, useState } from 'react';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
-import { Loader2, UploadCloud } from 'lucide-react';
+import { Link2, Loader2, UploadCloud } from 'lucide-react';
 import { toast } from 'sonner';
 
 import { Button } from '@/components/ui/button';
@@ -17,6 +17,7 @@ import {
 import { Input } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
 import { Progress } from '@/components/ui/progress';
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs';
 import { PagesService } from '@/lib/services/openflare';
 import { cn } from '@/lib/utils';
 
@@ -61,12 +62,15 @@ export function DeploymentUploadDialog({
 }: DeploymentUploadDialogProps) {
   const queryClient = useQueryClient();
   const fileInputRef = useRef<HTMLInputElement>(null);
+  const [mode, setMode] = useState<'file' | 'url'>('file');
   const [file, setFile] = useState<File | null>(null);
+  const [packageURL, setPackageURL] = useState('');
   const [isDragActive, setIsDragActive] = useState(false);
   const [uploadProgress, setUploadProgress] = useState<number | null>(null);
 
   const resetForm = () => {
     setFile(null);
+    setPackageURL('');
     setIsDragActive(false);
     setUploadProgress(null);
     if (fileInputRef.current) fileInputRef.current.value = '';
@@ -77,7 +81,17 @@ export function DeploymentUploadDialog({
     onOpenChange(nextOpen);
   };
 
-  const uploadMutation = useMutation({
+  const invalidate = async () => {
+    await Promise.all([
+      queryClient.invalidateQueries({
+        queryKey: deploymentsQueryKey(projectId),
+      }),
+      queryClient.invalidateQueries({ queryKey: projectQueryKey(projectId) }),
+      queryClient.invalidateQueries({ queryKey: projectsQueryKey }),
+    ]);
+  };
+
+  const uploadFileMutation = useMutation({
     mutationFn: () => {
       if (!file) throw new Error('请选择部署包');
       return PagesService.uploadDeployment(projectId, {
@@ -87,13 +101,7 @@ export function DeploymentUploadDialog({
     },
     onSuccess: async () => {
       toast.success('部署包上传成功');
-      await Promise.all([
-        queryClient.invalidateQueries({
-          queryKey: deploymentsQueryKey(projectId),
-        }),
-        queryClient.invalidateQueries({ queryKey: projectQueryKey(projectId) }),
-        queryClient.invalidateQueries({ queryKey: projectsQueryKey }),
-      ]);
+      await invalidate();
       handleClose(false);
     },
     onError: (error) => {
@@ -102,6 +110,27 @@ export function DeploymentUploadDialog({
     },
   });
 
+  const uploadURLMutation = useMutation({
+    mutationFn: () => {
+      const url = packageURL.trim();
+      if (!url) throw new Error('请填写部署包下载链接');
+      if (!/^https?:\/\//i.test(url)) {
+        throw new Error('链接必须以 http:// 或 https:// 开头');
+      }
+      return PagesService.uploadDeploymentFromURL(projectId, { url });
+    },
+    onSuccess: async () => {
+      toast.success('已从链接下载并创建部署');
+      await invalidate();
+      handleClose(false);
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '从链接导入失败');
+    },
+  });
+
+  const isPending = uploadFileMutation.isPending || uploadURLMutation.isPending;
+
   const handleFileSelect = (selected: File | null) => {
     if (!selected) return;
     if (!isSupportedPagesPackage(selected.name)) {
@@ -111,80 +140,129 @@ export function DeploymentUploadDialog({
     setFile(selected);
   };
 
+  const handleSubmit = () => {
+    if (mode === 'file') {
+      uploadFileMutation.mutate();
+      return;
+    }
+    uploadURLMutation.mutate();
+  };
+
+  const canSubmit =
+    mode === 'file' ? Boolean(file) : packageURL.trim().length > 0;
+
   return (
     <Dialog open={open} onOpenChange={handleClose}>
-      <DialogContent>
+      <DialogContent className='sm:max-w-lg'>
         <DialogHeader>
           <DialogTitle>上传部署包</DialogTitle>
           <DialogDescription>
-            上传已构建的静态资源压缩包（zip / tar.gz / tar.xz / tar.bz2 / tar /
-            7z），部署后可在列表中激活。
+            支持本地上传或从 URL 下载静态资源压缩包（zip / tar.gz / tar.xz /
+            tar.bz2 / tar / 7z），创建部署后可在列表中激活。
           </DialogDescription>
         </DialogHeader>
 
-        <div
-          className={cn(
-            'rounded-lg border border-dashed p-8 text-center transition',
-            isDragActive ? 'border-primary bg-primary/5' : 'bg-muted/20',
-          )}
-          onDragEnter={(e) => {
-            e.preventDefault();
-            setIsDragActive(true);
-          }}
-          onDragOver={(e) => e.preventDefault()}
-          onDragLeave={(e) => {
-            e.preventDefault();
-            setIsDragActive(false);
-          }}
-          onDrop={(e) => {
-            e.preventDefault();
-            setIsDragActive(false);
-            handleFileSelect(e.dataTransfer.files[0] ?? null);
-          }}
+        <Tabs
+          value={mode}
+          onValueChange={(value) => setMode(value as 'file' | 'url')}
+          className='w-full'
         >
-          <UploadCloud className='size-8 mx-auto text-muted-foreground' />
-          <p className='mt-3 text-sm'>拖拽部署包到此处，或点击选择文件</p>
-          <p className='mt-1 text-xs text-muted-foreground'>
-            支持 zip、tar.gz、tar.xz、tar.bz2、tar、7z
-          </p>
-          <Button
-            type='button'
-            variant='outline'
-            size='sm'
-            className='mt-3'
-            onClick={() => fileInputRef.current?.click()}
-          >
-            选择文件
-          </Button>
-          <input
-            ref={fileInputRef}
-            type='file'
-            accept={PAGES_PACKAGE_ACCEPT}
-            className='hidden'
-            onChange={(e) => handleFileSelect(e.target.files?.[0] ?? null)}
-          />
-        </div>
+          <TabsList className='grid w-full grid-cols-2'>
+            <TabsTrigger value='file'>本地上传</TabsTrigger>
+            <TabsTrigger value='url'>从 URL 下载</TabsTrigger>
+          </TabsList>
 
-        {file ? (
-          <div className='rounded-lg border border-dashed px-4 py-3 text-sm'>
-            <p className='font-medium'>{file.name}</p>
-            <p className='text-xs text-muted-foreground mt-1'>
-              {formatBytes(file.size)}
-            </p>
-          </div>
-        ) : null}
-
-        {uploadProgress !== null ? (
-          <div className='space-y-1.5'>
-            <div className='flex justify-between text-xs text-muted-foreground'>
-              <span>{uploadProgress >= 100 ? '服务端处理中' : '上传进度'}</span>
-              <span>
-                {uploadProgress >= 100 ? '请稍候' : `${uploadProgress}%`}
-              </span>
+          <TabsContent value='file' className='space-y-4 mt-4'>
+            <div
+              className={cn(
+                'rounded-lg border border-dashed p-8 text-center transition',
+                isDragActive ? 'border-primary bg-primary/5' : 'bg-muted/20',
+              )}
+              onDragEnter={(e) => {
+                e.preventDefault();
+                setIsDragActive(true);
+              }}
+              onDragOver={(e) => e.preventDefault()}
+              onDragLeave={(e) => {
+                e.preventDefault();
+                setIsDragActive(false);
+              }}
+              onDrop={(e) => {
+                e.preventDefault();
+                setIsDragActive(false);
+                handleFileSelect(e.dataTransfer.files[0] ?? null);
+              }}
+            >
+              <UploadCloud className='size-8 mx-auto text-muted-foreground' />
+              <p className='mt-3 text-sm'>拖拽部署包到此处，或点击选择文件</p>
+              <p className='mt-1 text-xs text-muted-foreground'>
+                支持 zip、tar.gz、tar.xz、tar.bz2、tar、7z
+              </p>
+              <Button
+                type='button'
+                variant='outline'
+                size='sm'
+                className='mt-3'
+                onClick={() => fileInputRef.current?.click()}
+              >
+                选择文件
+              </Button>
+              <input
+                ref={fileInputRef}
+                type='file'
+                accept={PAGES_PACKAGE_ACCEPT}
+                className='hidden'
+                onChange={(e) => handleFileSelect(e.target.files?.[0] ?? null)}
+              />
             </div>
-            <Progress value={uploadProgress >= 100 ? 100 : uploadProgress} />
-          </div>
-        ) : null}
+
+            {file ? (
+              <div className='rounded-lg border border-dashed px-4 py-3 text-sm'>
+                <p className='font-medium'>{file.name}</p>
+                <p className='text-xs text-muted-foreground mt-1'>
+                  {formatBytes(file.size)}
+                </p>
+              </div>
+            ) : null}
+
+            {uploadProgress !== null ? (
+              <div className='space-y-1.5'>
+                <div className='flex justify-between text-xs text-muted-foreground'>
+                  <span>
+                    {uploadProgress >= 100 ? '服务端处理中' : '上传进度'}
+                  </span>
+                  <span>
+                    {uploadProgress >= 100 ? '请稍候' : `${uploadProgress}%`}
+                  </span>
+                </div>
+                <Progress
+                  value={uploadProgress >= 100 ? 100 : uploadProgress}
+                />
+              </div>
+            ) : null}
+          </TabsContent>
+
+          <TabsContent value='url' className='space-y-4 mt-4'>
+            <div className='space-y-2'>
+              <Label htmlFor='package-url'>部署包下载链接</Label>
+              <div className='relative'>
+                <Link2 className='absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground' />
+                <Input
+                  id='package-url'
+                  className='pl-9'
+                  placeholder='https://example.com/dist/site.zip'
+                  value={packageURL}
+                  onChange={(e) => setPackageURL(e.target.value)}
+                  disabled={isPending}
+                />
+              </div>
+              <p className='text-xs text-muted-foreground'>
+                服务端将使用浏览器环境请求头从该链接下载压缩包，支持内网地址与自签证书
+                HTTPS。
+              </p>
+            </div>
+          </TabsContent>
+        </Tabs>
 
         <div className='space-y-1.5'>
           <Label htmlFor='entryFile'>入口文件</Label>
@@ -195,15 +273,14 @@ export function DeploymentUploadDialog({
           <Button variant='outline' onClick={() => handleClose(false)}>
             取消
           </Button>
-          <Button
-            onClick={() => uploadMutation.mutate()}
-            disabled={!file || uploadMutation.isPending}
-          >
-            {uploadMutation.isPending ? (
+          <Button onClick={handleSubmit} disabled={!canSubmit || isPending}>
+            {isPending ? (
               <>
                 <Loader2 className='size-4 animate-spin mr-1' />
-                上传中...
+                {mode === 'url' ? '下载中...' : '上传中...'}
               </>
+            ) : mode === 'url' ? (
+              '下载并创建部署'
             ) : (
               '上传并创建部署'
             )}

frontend/lib/services/openflare/pages.service.ts

@@ -8,6 +8,7 @@ import { OpenFlareBaseService } from './base.service';
 import type {
   PagesDeployment,
   PagesDeploymentFile,
+  PagesDeploymentUploadFromURLPayload,
   PagesDeploymentUploadPayload,
   PagesProject,
   PagesProjectPayload,
@@ -67,6 +68,16 @@ export class PagesService extends OpenFlareBaseService {
     );
   }
 
+  static uploadDeploymentFromURL(
+    projectId: number,
+    payload: PagesDeploymentUploadFromURLPayload,
+  ): Promise<PagesDeployment> {
+    return this.post<PagesDeployment>(
+      `/${projectId}/deployments/upload-from-url`,
+      payload,
+    );
+  }
+
   static activateDeployment(
     projectId: number,
     deploymentId: number,

frontend/lib/services/openflare/types.ts

@@ -469,6 +469,10 @@ export interface PagesDeploymentUploadPayload {
   onProgress?: (percent: number) => void;
 }
 
+export interface PagesDeploymentUploadFromURLPayload {
+  url: string;
+}
+
 // ==================== Origins ====================
 
 export interface OriginItem {