Merge pull request #220 from cita-777/codex/webdav-backup-armv7l

Add WebDAV backup sync and armv7 Docker builds
2026-03-21 01:24:51 +08:00
parent 3be452d794 0574fa93b3
commit 4ba7749391
14 changed files with 1436 additions and 28 deletions
@@ -635,6 +635,33 @@ export const api = {
      method: 'POST',
      body: JSON.stringify({ data }),
    }),
+  getBackupWebdavConfig: () => request('/api/settings/backup/webdav'),
+  saveBackupWebdavConfig: (data: {
+    enabled: boolean;
+    fileUrl: string;
+    username: string;
+    password?: string;
+    clearPassword?: boolean;
+    exportType: 'all' | 'accounts' | 'preferences';
+    autoSyncEnabled: boolean;
+    autoSyncCron: string;
+  }) =>
+    request('/api/settings/backup/webdav', {
+      method: 'PUT',
+      body: JSON.stringify(data),
+    }),
+  exportBackupToWebdav: (type?: 'all' | 'accounts' | 'preferences') =>
+    request('/api/settings/backup/webdav/export', {
+      method: 'POST',
+      body: JSON.stringify(type ? { type } : {}),
+      timeoutMs: 60_000,
+    }),
+  importBackupFromWebdav: () =>
+    request('/api/settings/backup/webdav/import', {
+      method: 'POST',
+      body: JSON.stringify({}),
+      timeoutMs: 60_000,
+    }),
  clearRuntimeCache: () => request('/api/settings/maintenance/clear-cache', { method: 'POST' }),
  clearUsageData: () => request('/api/settings/maintenance/clear-usage', { method: 'POST' }),
  factoryReset: () => request('/api/settings/maintenance/factory-reset', { method: 'POST' }),
@@ -7,6 +7,10 @@ const { apiMock, toastMock } = vi.hoisted(() => ({
  apiMock: {
    exportBackup: vi.fn(),
    importBackup: vi.fn(),
+    getBackupWebdavConfig: vi.fn(),
+    saveBackupWebdavConfig: vi.fn(),
+    exportBackupToWebdav: vi.fn(),
+    importBackupFromWebdav: vi.fn(),
  },
  toastMock: {
    success: vi.fn(),
@@ -185,6 +189,53 @@ describe('ImportExport', () => {
    vi.stubGlobal('window', {
      confirm: vi.fn(() => true),
    });
+    apiMock.getBackupWebdavConfig.mockResolvedValue({
+      success: true,
+      config: {
+        enabled: true,
+        fileUrl: 'https://dav.example.com/backups/metapi.json',
+        username: 'alice',
+        exportType: 'all',
+        autoSyncEnabled: true,
+        autoSyncCron: '0 */6 * * *',
+        hasPassword: true,
+        passwordMasked: 'se****ss',
+      },
+      state: {
+        lastSyncAt: null,
+        lastError: null,
+      },
+    });
+    apiMock.saveBackupWebdavConfig.mockResolvedValue({
+      success: true,
+      config: {
+        enabled: true,
+        fileUrl: 'https://dav.example.com/backups/metapi.json',
+        username: 'alice',
+        exportType: 'all',
+        autoSyncEnabled: true,
+        autoSyncCron: '0 */6 * * *',
+        hasPassword: true,
+        passwordMasked: 'se****ss',
+      },
+      state: {
+        lastSyncAt: null,
+        lastError: null,
+      },
+    });
+    apiMock.exportBackupToWebdav.mockResolvedValue({
+      success: true,
+      fileUrl: 'https://dav.example.com/backups/metapi.json',
+      exportType: 'all',
+    });
+    apiMock.importBackupFromWebdav.mockResolvedValue({
+      success: true,
+      sections: {
+        accounts: true,
+        preferences: true,
+      },
+      appliedSettings: [],
+    });
    apiMock.importBackup.mockResolvedValue({
      allImported: true,
      sections: {
@@ -305,4 +356,147 @@ describe('ImportExport', () => {
      root?.unmount();
    }
  });
+
+  it('loads webdav config and saves updates from the import/export page', async () => {
+    let root: ReturnType<typeof create> | null = null;
+
+    try {
+      await act(async () => {
+        root = create(
+          <MemoryRouter>
+            <ImportExport />
+          </MemoryRouter>,
+        );
+      });
+      await flushMicrotasks();
+
+      const rendered = collectText(root!.root);
+      expect(apiMock.getBackupWebdavConfig).toHaveBeenCalledTimes(1);
+      expect(rendered).toContain('WebDAV');
+      expect(rendered).toContain('自动同步');
+
+      const saveButton = root!.root.findAll((node) => (
+        node.type === 'button'
+        && typeof node.props.onClick === 'function'
+        && collectText(node).includes('保存 WebDAV 配置')
+      )).at(-1);
+
+      expect(saveButton).toBeTruthy();
+
+      await act(async () => {
+        saveButton!.props.onClick();
+      });
+      await flushMicrotasks();
+
+      expect(apiMock.saveBackupWebdavConfig).toHaveBeenCalledTimes(1);
+    } finally {
+      root?.unmount();
+    }
+  });
+
+  it('disables webdav actions while config has unsaved changes', async () => {
+    let root: ReturnType<typeof create> | null = null;
+
+    try {
+      await act(async () => {
+        root = create(
+          <MemoryRouter>
+            <ImportExport />
+          </MemoryRouter>,
+        );
+      });
+      await flushMicrotasks();
+
+      const fileUrlInput = root!.root.findAll((node) => (
+        node.type === 'input'
+        && node.props.placeholder === 'https://dav.example.com/backups/metapi.json'
+      )).at(-1);
+
+      expect(fileUrlInput).toBeTruthy();
+
+      await act(async () => {
+        fileUrlInput!.props.onChange({ target: { value: 'https://dav.example.com/backups/changed.json' } });
+      });
+      await flushMicrotasks();
+
+      const exportButton = root!.root.findAll((node) => (
+        node.type === 'button'
+        && collectText(node).includes('立即导出到 WebDAV')
+      )).at(-1);
+      const importButton = root!.root.findAll((node) => (
+        node.type === 'button'
+        && collectText(node).includes('从 WebDAV 拉取')
+      )).at(-1);
+
+      expect(exportButton?.props.disabled).toBe(true);
+      expect(importButton?.props.disabled).toBe(true);
+    } finally {
+      root?.unmount();
+    }
+  });
+
+  it('can clear a saved webdav password', async () => {
+    apiMock.saveBackupWebdavConfig.mockResolvedValueOnce({
+      success: true,
+      config: {
+        enabled: true,
+        fileUrl: 'https://dav.example.com/backups/metapi.json',
+        username: 'alice',
+        exportType: 'all',
+        autoSyncEnabled: true,
+        autoSyncCron: '0 */6 * * *',
+        hasPassword: false,
+        passwordMasked: '',
+      },
+      state: {
+        lastSyncAt: null,
+        lastError: null,
+      },
+    });
+
+    let root: ReturnType<typeof create> | null = null;
+
+    try {
+      await act(async () => {
+        root = create(
+          <MemoryRouter>
+            <ImportExport />
+          </MemoryRouter>,
+        );
+      });
+      await flushMicrotasks();
+
+      const clearPasswordToggle = root!.root.findAll((node) => (
+        node.type === 'label'
+        && collectText(node).includes('清空已保存密码')
+      )).at(-1);
+
+      expect(clearPasswordToggle).toBeTruthy();
+
+      const checkbox = clearPasswordToggle!.findByType('input');
+      await act(async () => {
+        checkbox.props.onChange({ target: { checked: true } });
+      });
+      await flushMicrotasks();
+
+      const saveButton = root!.root.findAll((node) => (
+        node.type === 'button'
+        && typeof node.props.onClick === 'function'
+        && collectText(node).includes('保存 WebDAV 配置')
+      )).at(-1);
+
+      expect(saveButton).toBeTruthy();
+
+      await act(async () => {
+        saveButton!.props.onClick();
+      });
+      await flushMicrotasks();
+
+      expect(apiMock.saveBackupWebdavConfig).toHaveBeenCalledWith(expect.objectContaining({
+        clearPassword: true,
+      }));
+    } finally {
+      root?.unmount();
+    }
+  });
 });
@@ -1,4 +1,4 @@
-import React, { useMemo, useRef, useState } from 'react';
+import React, { useEffect, useMemo, useRef, useState } from 'react';
 import { api } from '../api.js';
 import { useToast } from '../components/Toast.js';
 import { tr } from '../i18n.js';
@@ -24,6 +24,55 @@ type ParsedSummary = {
  ignoredSections: string[];
 };

+type WebdavConfigForm = {
+  enabled: boolean;
+  fileUrl: string;
+  username: string;
+  password: string;
+  exportType: BackupType;
+  autoSyncEnabled: boolean;
+  autoSyncCron: string;
+  hasPassword: boolean;
+  passwordMasked: string;
+};
+
+type WebdavSyncState = {
+  lastSyncAt: string | null;
+  lastError: string | null;
+};
+
+type WebdavConfigSnapshot = {
+  enabled: boolean;
+  fileUrl: string;
+  username: string;
+  exportType: BackupType;
+  autoSyncEnabled: boolean;
+  autoSyncCron: string;
+  hasPassword: boolean;
+};
+
+const DEFAULT_WEBDAV_CONFIG: WebdavConfigForm = {
+  enabled: false,
+  fileUrl: '',
+  username: '',
+  password: '',
+  exportType: 'all',
+  autoSyncEnabled: false,
+  autoSyncCron: '0 */6 * * *',
+  hasPassword: false,
+  passwordMasked: '',
+};
+
+const DEFAULT_WEBDAV_SNAPSHOT: WebdavConfigSnapshot = {
+  enabled: false,
+  fileUrl: '',
+  username: '',
+  exportType: 'all',
+  autoSyncEnabled: false,
+  autoSyncCron: '0 */6 * * *',
+  hasPassword: false,
+};
+
 function downloadJsonFile(data: unknown, filename: string) {
  const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' });
  const url = URL.createObjectURL(blob);
@@ -188,10 +237,82 @@ export default function ImportExport() {
  const [importData, setImportData] = useState('');
  const [selectedFileName, setSelectedFileName] = useState('');
  const [dragOver, setDragOver] = useState(false);
+  const [webdavConfig, setWebdavConfig] = useState<WebdavConfigForm>(DEFAULT_WEBDAV_CONFIG);
+  const [savedWebdavConfig, setSavedWebdavConfig] = useState<WebdavConfigSnapshot>(DEFAULT_WEBDAV_SNAPSHOT);
+  const [webdavState, setWebdavState] = useState<WebdavSyncState>({ lastSyncAt: null, lastError: null });
+  const [webdavSaving, setWebdavSaving] = useState(false);
+  const [webdavAction, setWebdavAction] = useState<'export' | 'import' | ''>('');
+  const [clearWebdavPassword, setClearWebdavPassword] = useState(false);
  const fileInputRef = useRef<HTMLInputElement>(null);

  const summary = useMemo(() => parseImportSummary(importData), [importData]);

+  const buildWebdavForm = (config: any): WebdavConfigForm => ({
+    enabled: config.enabled === true,
+    fileUrl: String(config.fileUrl || ''),
+    username: String(config.username || ''),
+    password: '',
+    exportType: config.exportType === 'accounts' || config.exportType === 'preferences' ? config.exportType : 'all',
+    autoSyncEnabled: config.autoSyncEnabled === true,
+    autoSyncCron: String(config.autoSyncCron || DEFAULT_WEBDAV_CONFIG.autoSyncCron),
+    hasPassword: config.hasPassword === true,
+    passwordMasked: String(config.passwordMasked || ''),
+  });
+
+  const buildWebdavSnapshot = (config: any): WebdavConfigSnapshot => ({
+    enabled: config.enabled === true,
+    fileUrl: String(config.fileUrl || ''),
+    username: String(config.username || ''),
+    exportType: config.exportType === 'accounts' || config.exportType === 'preferences' ? config.exportType : 'all',
+    autoSyncEnabled: config.autoSyncEnabled === true,
+    autoSyncCron: String(config.autoSyncCron || DEFAULT_WEBDAV_CONFIG.autoSyncCron),
+    hasPassword: config.hasPassword === true,
+  });
+
+  const applyWebdavResponse = (result: any) => {
+    const config = result?.config;
+    if (config) {
+      setWebdavConfig(buildWebdavForm(config));
+      setSavedWebdavConfig(buildWebdavSnapshot(config));
+      setClearWebdavPassword(false);
+    }
+    const state = result?.state || result;
+    setWebdavState((prev) => ({
+      lastSyncAt: typeof state?.lastSyncAt === 'string' ? state.lastSyncAt : prev.lastSyncAt,
+      lastError: typeof state?.lastError === 'string'
+        ? state.lastError
+        : (state?.lastError === null ? null : prev.lastError),
+    }));
+  };
+
+  const webdavConfigDirty = (
+    webdavConfig.enabled !== savedWebdavConfig.enabled
+    || webdavConfig.fileUrl !== savedWebdavConfig.fileUrl
+    || webdavConfig.username !== savedWebdavConfig.username
+    || webdavConfig.exportType !== savedWebdavConfig.exportType
+    || webdavConfig.autoSyncEnabled !== savedWebdavConfig.autoSyncEnabled
+    || webdavConfig.autoSyncCron !== savedWebdavConfig.autoSyncCron
+    || webdavConfig.hasPassword !== savedWebdavConfig.hasPassword
+    || webdavConfig.password.trim().length > 0
+    || clearWebdavPassword
+  );
+
+  useEffect(() => {
+    let alive = true;
+    void api.getBackupWebdavConfig()
+      .then((result: any) => {
+        if (!alive) return;
+        applyWebdavResponse(result);
+      })
+      .catch((err: any) => {
+        if (!alive) return;
+        toast.error(err?.message || '加载 WebDAV 配置失败');
+      });
+    return () => {
+      alive = false;
+    };
+  }, [toast]);
+
  const handleExport = async (type: BackupType) => {
    setExportingType(type);
    try {
@@ -281,6 +402,63 @@ export default function ImportExport() {
    }
  };

+  const handleSaveWebdavConfig = async () => {
+    setWebdavSaving(true);
+    try {
+      const nextPassword = webdavConfig.password.trim();
+      const payload: Record<string, unknown> = {
+        enabled: webdavConfig.enabled,
+        fileUrl: webdavConfig.fileUrl,
+        username: webdavConfig.username,
+        exportType: webdavConfig.exportType,
+        autoSyncEnabled: webdavConfig.autoSyncEnabled,
+        autoSyncCron: webdavConfig.autoSyncCron,
+      };
+      if (nextPassword) {
+        payload.password = webdavConfig.password;
+      } else if (clearWebdavPassword) {
+        payload.clearPassword = true;
+      }
+      const result = await api.saveBackupWebdavConfig(payload as any);
+      applyWebdavResponse(result);
+      toast.success('WebDAV 配置已保存');
+    } catch (err: any) {
+      toast.error(err?.message || '保存 WebDAV 配置失败');
+    } finally {
+      setWebdavSaving(false);
+    }
+  };
+
+  const handleExportToWebdav = async () => {
+    setWebdavAction('export');
+    try {
+      const result = await api.exportBackupToWebdav(webdavConfig.exportType);
+      applyWebdavResponse(result);
+      toast.success(`已导出到 WebDAV：${result?.fileUrl || webdavConfig.fileUrl}`);
+    } catch (err: any) {
+      toast.error(err?.message || '导出到 WebDAV 失败');
+    } finally {
+      setWebdavAction('');
+    }
+  };
+
+  const handleImportFromWebdav = async () => {
+    const confirmed = typeof window === 'undefined' || typeof window.confirm !== 'function'
+      ? true
+      : window.confirm('从 WebDAV 导入会覆盖本地账号/路由或系统设置，确认继续？');
+    if (!confirmed) return;
+    setWebdavAction('import');
+    try {
+      const result = await api.importBackupFromWebdav();
+      applyWebdavResponse(result);
+      toast.success(buildImportSuccessMessage(result));
+    } catch (err: any) {
+      toast.error(err?.message || '从 WebDAV 导入失败');
+    } finally {
+      setWebdavAction('');
+    }
+  };
+
  return (
    <div className="animate-fade-in">
      <div className="page-header" style={{ alignItems: 'flex-end', marginBottom: 18 }}>
@@ -483,7 +661,150 @@ export default function ImportExport() {
        </div>
      </div>

-      <div className="card animate-slide-up stagger-3" style={{ marginTop: 14, padding: 16 }}>
+      <div className="card animate-slide-up stagger-3" style={{ marginTop: 14, padding: 18 }}>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 6 }}>
+          <svg width="18" height="18" fill="none" viewBox="0 0 24 24" stroke="var(--color-primary)">
+            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M3 15a4 4 0 004 4h9a5 5 0 10-.1-9.999A5.002 5.002 0 006 9a4 4 0 00-3 6z" />
+          </svg>
+          <span style={{ fontSize: 15, fontWeight: 700 }}>WebDAV 同步</span>
+        </div>
+        <div style={{ fontSize: 12, color: 'var(--color-text-muted)', marginBottom: 14 }}>
+          支持手动推送、手动拉取，以及定时自动导出到 WebDAV。
+        </div>
+
+        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit,minmax(220px,1fr))', gap: 10 }}>
+          <label style={{ display: 'grid', gap: 6 }}>
+            <span style={{ fontSize: 12, color: 'var(--color-text-secondary)' }}>文件 URL</span>
+            <input
+              value={webdavConfig.fileUrl}
+              onChange={(e) => setWebdavConfig((prev) => ({ ...prev, fileUrl: e.target.value }))}
+              placeholder="https://dav.example.com/backups/metapi.json"
+              style={{ width: '100%' }}
+            />
+          </label>
+          <label style={{ display: 'grid', gap: 6 }}>
+            <span style={{ fontSize: 12, color: 'var(--color-text-secondary)' }}>用户名</span>
+            <input
+              value={webdavConfig.username}
+              onChange={(e) => setWebdavConfig((prev) => ({ ...prev, username: e.target.value }))}
+              placeholder="可留空"
+              style={{ width: '100%' }}
+            />
+          </label>
+          <label style={{ display: 'grid', gap: 6 }}>
+            <span style={{ fontSize: 12, color: 'var(--color-text-secondary)' }}>密码</span>
+            <input
+              type="password"
+              value={webdavConfig.password}
+              onChange={(e) => {
+                const nextPassword = e.target.value;
+                setWebdavConfig((prev) => ({ ...prev, password: nextPassword }));
+                if (nextPassword.trim()) {
+                  setClearWebdavPassword(false);
+                }
+              }}
+              placeholder={clearWebdavPassword
+                ? '保存后将清空已存密码'
+                : (webdavConfig.hasPassword ? `已保存 ${webdavConfig.passwordMasked}，留空则保持不变` : '请输入密码')}
+              disabled={clearWebdavPassword}
+              style={{ width: '100%' }}
+            />
+            {webdavConfig.hasPassword ? (
+              <label style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 12, color: 'var(--color-text-secondary)' }}>
+                <input
+                  type="checkbox"
+                  checked={clearWebdavPassword}
+                  onChange={(e) => {
+                    const checked = e.target.checked === true;
+                    setClearWebdavPassword(checked);
+                    if (checked) {
+                      setWebdavConfig((prev) => ({ ...prev, password: '' }));
+                    }
+                  }}
+                />
+                清空已保存密码
+              </label>
+            ) : null}
+          </label>
+          <label style={{ display: 'grid', gap: 6 }}>
+            <span style={{ fontSize: 12, color: 'var(--color-text-secondary)' }}>导出分区</span>
+            <select
+              value={webdavConfig.exportType}
+              onChange={(e) => setWebdavConfig((prev) => ({ ...prev, exportType: e.target.value as BackupType }))}
+            >
+              <option value="all">全部</option>
+              <option value="accounts">账号与路由</option>
+              <option value="preferences">系统设置</option>
+            </select>
+          </label>
+          <label style={{ display: 'grid', gap: 6 }}>
+            <span style={{ fontSize: 12, color: 'var(--color-text-secondary)' }}>自动同步 Cron</span>
+            <input
+              value={webdavConfig.autoSyncCron}
+              onChange={(e) => setWebdavConfig((prev) => ({ ...prev, autoSyncCron: e.target.value }))}
+              placeholder="0 */6 * * *"
+              style={{ width: '100%' }}
+            />
+          </label>
+          <div style={{ display: 'grid', gap: 8, alignContent: 'center' }}>
+            <label style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
+              <input
+                type="checkbox"
+                checked={webdavConfig.enabled}
+                onChange={(e) => setWebdavConfig((prev) => ({ ...prev, enabled: e.target.checked }))}
+              />
+              启用 WebDAV
+            </label>
+            <label style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
+              <input
+                type="checkbox"
+                checked={webdavConfig.autoSyncEnabled}
+                onChange={(e) => setWebdavConfig((prev) => ({ ...prev, autoSyncEnabled: e.target.checked }))}
+              />
+              自动同步
+            </label>
+          </div>
+        </div>
+
+        <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 14 }}>
+          <button
+            onClick={handleSaveWebdavConfig}
+            disabled={webdavSaving}
+            className="btn btn-primary"
+          >
+            {webdavSaving ? '保存中...' : '保存 WebDAV 配置'}
+          </button>
+          <button
+            onClick={handleExportToWebdav}
+            disabled={webdavAction !== '' || webdavSaving || webdavConfigDirty}
+            className="btn btn-ghost"
+            style={{ border: '1px solid var(--color-border)' }}
+          >
+            {webdavAction === 'export' ? '导出中...' : '立即导出到 WebDAV'}
+          </button>
+          <button
+            onClick={handleImportFromWebdav}
+            disabled={webdavAction !== '' || webdavSaving || webdavConfigDirty}
+            className="btn btn-ghost"
+            style={{ border: '1px solid var(--color-border)' }}
+          >
+            {webdavAction === 'import' ? '拉取中...' : '从 WebDAV 拉取'}
+          </button>
+        </div>
+
+        {webdavConfigDirty ? (
+          <div style={{ marginTop: 10, fontSize: 12, color: 'var(--color-warning)' }}>
+            当前 WebDAV 配置有未保存改动，请先保存后再执行导入或导出。
+          </div>
+        ) : null}
+
+        <div style={{ marginTop: 12, fontSize: 12, color: 'var(--color-text-secondary)', lineHeight: 1.7 }}>
+          <div>上次同步：{webdavState.lastSyncAt ? new Date(webdavState.lastSyncAt).toLocaleString() : '尚未同步'}</div>
+          <div>最近错误：{webdavState.lastError || '无'}</div>
+        </div>
+      </div>
+
+      <div className="card animate-slide-up stagger-4" style={{ marginTop: 14, padding: 16 }}>
        <div style={{ fontSize: 14, fontWeight: 700, marginBottom: 8 }}>注意事项</div>
        <div style={{ fontSize: 12, color: 'var(--color-text-secondary)', lineHeight: 1.75 }}>
          <div>1. 导入账号分区会覆盖现有站点、账号、令牌和路由配置。</div>