🚀 Browser Upload Guide

浏览器上传指南

Overview

This guide explains the upload functionality available in different browsers and how to get the best upload experience.

⚡ Quick Start: Enable Resumable Uploads

To enable resumable uploads (recommended for large files):

  1. Use a supported browser: Chrome 86+, Edge 86+, or Opera 72+ on desktop
  2. Enable HTTPS (if accessing remotely):
    • Go to Settings → Web Server tab
    • Check "Enable HTTPS"
    • Choose: existing certificate files, paste PEM content, or generate self-signed cert
    • Click "Apply"
    • Access the site via https:// (or use http://localhost for local development)
  3. Grant file access permission: When uploading, click "Allow" when the browser asks for permission
  4. Start uploading: Your uploads will now resume automatically if interrupted

That's it! You can now close the browser and your uploads will continue when you return.

Browser Compatibility

✅ Full Feature Support (Recommended)

The following browsers support resumable uploads with the File System Access API:

  • Google Chrome 86+ (Desktop)
  • Microsoft Edge 86+ (Desktop)
  • Opera 72+ (Desktop)

Features Available:

  • ✅ Resumable uploads (uploads continue after page reload)
  • ✅ Folder upload with directory structure preservation
  • ✅ Drag-and-drop files and folders
  • ✅ Large file support without memory limitations
  • ✅ Upload progress persists across sessions

⚠️ Limited Support

Safari (Desktop & iOS)

  • ❌ No resumable uploads
  • ✅ Traditional file/folder upload
  • ✅ Drag-and-drop support
  • ⚠️ Uploads must complete in one session (lost on page reload)

Firefox (Desktop & Mobile)

  • ❌ No resumable uploads
  • ✅ Traditional file/folder upload
  • ✅ Drag-and-drop support
  • ⚠️ Uploads must complete in one session (lost on page reload)

❌ Mobile Browsers

All Mobile Browsers (Chrome, Safari, Firefox on iOS/Android)

  • ❌ No resumable uploads
  • ⚠️ Limited file/folder selection capabilities
  • ⚠️ Large uploads may fail due to memory constraints
  • ⚠️ Page reload or app switch will cancel uploads

Recommendation: Use desktop Chrome, Edge, or Opera for uploading large files or folders.

Upload Features Explained

1. Resumable Uploads (Chrome/Edge/Opera Only)

What is it?

Resumable uploads allow you to:

  • Close the browser and resume uploading later
  • Reload the page without losing progress
  • Continue uploads after a network interruption
  • Upload very large files over multiple sessions

⚠️ Important: HTTPS or Localhost Required

Resumable uploads only work when accessing the site via:

  • ✅ HTTPS (https://...) - Secure connection
  • ✅ Localhost (http://localhost or http://127.0.0.1) - Local development

❌ HTTP connections from remote addresses do NOT support resumable uploads due to browser security restrictions.

How to Enable HTTPS:

If you're accessing this site remotely (not localhost), you need to enable HTTPS:

  1. Go to Settings → Web Server tab
  2. Check "Enable HTTPS"
  3. Choose one of three options:
    • Option 1: Provide paths to existing certificate and key files
    • Option 2: Paste certificate and key content in PEM format
    • Option 3: Generate a self-signed certificate (for testing/internal use)
  4. Click "Apply" to save and restart the server
  5. Access the site using https:// instead of http://

About Self-Signed Certificates:

  • Browsers will show security warnings
  • Click "Advanced" → "Proceed to [site]" to continue
  • Only suitable for testing or private networks
  • For production, use a valid SSL certificate from a trusted Certificate Authority

2. File Access Permissions

Why are permissions needed?

To enable resumable uploads, the browser needs permission to access your files even after you close the page.

When do I need to grant permission?

  • First upload on this site: Browser will show a permission dialog
  • After browser updates: You may need to re-grant permission
  • After clearing browser data: Permissions are reset

What if I don't grant permission?

  • Uploads will work but won't be resumable
  • Files must upload completely in one session
  • Page reload will cancel the upload

Best Practices

For Large Files (>1GB)

Recommended:

  1. Use Chrome, Edge, or Opera on desktop
  2. Grant file access permission when prompted
  3. Keep the browser tab open, but you can close it if needed
  4. Check back later - uploads will resume automatically

Avoid:

  • Safari or Firefox (uploads may fail or timeout)
  • Mobile browsers (memory limitations)
  • Closing the browser before granting permission

Frequently Asked Questions

Q: Can I upload while offline?

A: No, uploads require an active internet connection. However, with resumable uploads (Chrome/Edge/Opera), you can pause and resume when your connection is restored.

Q: What happens if I close the browser during upload?

A:

  • Chrome/Edge/Opera: Upload pauses and resumes automatically when you return
  • Safari/Firefox/Mobile: Upload is cancelled and must be restarted

Q: Can I upload multiple files at once?

A: Yes, all browsers support selecting and uploading multiple files simultaneously.

Q: Is there a file size limit?

A: No practical limit, but may be restricted by your cloud storage operator.

Support

For issues or questions not covered in this guide:

  1. Check the browser console for error messages
  2. Try using a supported browser (Chrome/Edge/Opera)
  3. Clear browser cache and cookies
  4. Report issues with detailed browser and version information

概述

本指南说明了不同浏览器中可用的上传功能以及如何获得最佳上传体验。

⚡ 快速入门：启用可恢复上传

要启用可恢复上传（推荐用于大文件）：

  1. 使用支持的浏览器：桌面版 Chrome 86+、Edge 86+ 或 Opera 72+
  2. 启用 HTTPS（如果远程访问）：
    • 进入 设置 → Web 服务器 标签页
    • 勾选 "启用 HTTPS"
    • 选择：现有证书文件、粘贴 PEM 内容或生成自签名证书
    • 点击 "应用"
    • 使用 https:// 访问站点（或使用 http://localhost 进行本地开发）
  3. 授予文件访问权限：上传时，浏览器请求权限时点击"允许"
  4. 开始上传：您的上传现在会在中断后自动恢复

完成！现在您可以关闭浏览器，返回时上传将继续。

浏览器兼容性

✅ 完整功能支持（推荐）

以下浏览器支持使用文件系统访问 API 的可恢复上传：

  • Google Chrome 86+（桌面版）
  • Microsoft Edge 86+（桌面版）
  • Opera 72+（桌面版）

可用功能：

  • ✅ 可恢复上传（页面刷新后上传继续）
  • ✅ 文件夹上传并保留目录结构
  • ✅ 拖放文件和文件夹
  • ✅ 支持大文件且无内存限制
  • ✅ 上传进度跨会话持久化

⚠️ 有限支持

Safari（桌面版和 iOS）

  • ❌ 不支持可恢复上传
  • ✅ 传统文件/文件夹上传
  • ✅ 拖放支持
  • ⚠️ 上传必须在一次会话中完成（页面刷新后丢失）

Firefox（桌面版和移动版）

  • ❌ 不支持可恢复上传
  • ✅ 传统文件/文件夹上传
  • ✅ 拖放支持
  • ⚠️ 上传必须在一次会话中完成（页面刷新后丢失）

❌ 移动浏览器

所有移动浏览器（iOS/Android 上的 Chrome、Safari、Firefox）

  • ❌ 不支持可恢复上传
  • ⚠️ 文件/文件夹选择功能有限
  • ⚠️ 由于内存限制，大文件上传可能失败
  • ⚠️ 页面刷新或切换应用会取消上传

建议：使用桌面版 Chrome、Edge 或 Opera 上传大文件或文件夹。

上传功能说明

1. 可恢复上传（仅限 Chrome/Edge/Opera）

这是什么？

可恢复上传允许您：

  • 关闭浏览器后稍后恢复上传
  • 刷新页面而不丢失进度
  • 网络中断后继续上传
  • 在多个会话中上传非常大的文件

⚠️ 重要：需要 HTTPS 或 Localhost

可恢复上传仅在以下情况下工作：

  • ✅ HTTPS（https://...）- 安全连接
  • ✅ Localhost（http://localhost 或 http://127.0.0.1）- 本地开发

❌ 来自远程地址的 HTTP 连接由于浏览器安全限制，不支持可恢复上传。

如何启用 HTTPS：

如果您从远程访问此站点（非 localhost），需要启用 HTTPS：

  1. 进入 设置 → Web 服务器 标签页
  2. 勾选 "启用 HTTPS"
  3. 选择以下三个选项之一：
    • 选项 1：提供现有证书和密钥文件的路径
    • 选项 2：粘贴 PEM 格式的证书和密钥内容
    • 选项 3：生成自签名证书（用于测试/内部使用）
  4. 点击 "应用" 保存并重启服务器
  5. 使用 https:// 而不是 http:// 访问站点

关于自签名证书：

  • 浏览器会显示安全警告
  • 点击"高级" → "继续访问 [站点]" 以继续
  • 仅适用于测试或私有网络
  • 对于生产环境，请使用来自受信任证书颁发机构的有效 SSL 证书

2. 文件访问权限

为什么需要权限？

为了启用可恢复上传，浏览器需要权限才能在您关闭页面后访问您的文件。

何时需要授予权限？

  • 在此站点的首次上传：浏览器将显示权限对话框
  • 浏览器更新后：您可能需要重新授予权限
  • 清除浏览器数据后：权限被重置

如果我不授予权限会怎样？

  • 上传仍可工作但不可恢复
  • 文件必须在一次会话中完全上传
  • 页面刷新将取消上传

最佳实践

对于大文件（>1GB）

推荐：

  1. 在桌面上使用 Chrome、Edge 或 Opera
  2. 提示时授予文件访问权限
  3. 保持浏览器标签页打开，但如有需要也可以关闭
  4. 稍后查看 - 上传将自动恢复

避免：

  • Safari 或 Firefox（上传可能失败或超时）
  • 移动浏览器（内存限制）
  • 在授予权限前关闭浏览器

常见问题

问：我可以离线上传吗？

答：不可以，上传需要活动的互联网连接。但是，使用可恢复上传（Chrome/Edge/Opera），您可以在连接恢复时暂停和恢复。

问：如果我在上传期间关闭浏览器会怎样？

答：

  • Chrome/Edge/Opera：上传暂停并在您返回时自动恢复
  • Safari/Firefox/移动版：上传被取消并必须重新开始

问：我可以一次上传多个文件吗？

答：可以，所有浏览器都支持同时选择和上传多个文件。

问：文件大小有限制吗？

答：没有实际限制，但可能受您的云存储运营商限制。

支持

对于本指南未涵盖的问题或疑问：

  1. 检查浏览器控制台中的错误消息
  2. 尝试使用支持的浏览器（Chrome/Edge/Opera）
  3. 清除浏览器缓存和 Cookie
  4. 报告问题时提供详细的浏览器和版本信息