Swift-share-test NPM

快传

简单、快捷、一目了然

🔥 功能

✨ 亮点

🔀 边传边下

开始上传即可立即下载，传了多少就能下载多少。

可根据实际网络情况，在配置中自定义文件分片大小，优化传输体验。

🛜 快捷传输

方法1：粘贴上传

使用粘贴快捷键一键上传剪贴板中的文本或图片。

受安全策略限制，非文本和图片类型的剪贴板内容无法上传。

方法2：系统分享

将快传安装为 PWA 应用，通过系统分享上传文本和文件。

目前该方法支持安卓和 Windows 系统。
安卓设备请使用 Chrome 浏览器，并确保 Google Play 商店在安装 PWA 应用时可用且网络环境支持访问谷歌服务。
华为（鸿蒙）设备安装原生 GMS 后亦可使用，HarmonyOS NEXT 无法使用。
Windows 设备建议使用 Edge 浏览器。

方法3：搜索提取

在搜索框中输入提取码，即可快速查找并下载文件。

在浏览器设置的“搜索引擎”中找到“文件提取”条目，启用后可直接在地址栏中快速提取文件。

▶️ 在线播放

支持使用提取码直接在线播放媒体文件，无需下载。

支持读取视频文件中的软字幕。注意，这会消耗您更多的流量。
该功能支持边下边播。文件未上传完成前，媒体文件需支持流媒体才能正常播放。
非边下边播状态下，非流媒体文件也能正常播放。

💼 持久共享

支持设置一个常驻的共享目录，只需将文件放入该目录，即可通过快传传输。

如果共享目录所指向的路径不存在，则不会生成提取码。

🌠 夜间模式

当系统处于夜间模式时，快传也会自动切换到夜间模式。

⚙️ 灵活配置

支持自定义端口、提取码长度、过期时间等多项配置。

👀 使用方法

安装

npm install -g swift-share

启动

swift-share

停止

^C (Ctrl + C)

卸载

npm uninstall -g swift-share

反向代理

可使用 Nginx 等反向代理 Web 服务器将快传部署到子目录。
请根据下面的配置示例进行配置，错误的配置可能导致快传部分功能失效。

Nginx

在 nginx.conf 的 http 块中追加以下配置，使得 HTTP 协议可被升级为 WebSocket 协议。

# /etc/nginx/nginx.conf

http {
    ...

    # WebSocket
    map $http_upgrade $connection_upgrade {
        default upgrade;
        # 非 WebSocket 关闭连接（可选）
        # '' close;
    }
}

在 sites-available 目录下的配置文件中添加以下配置，将快传部署到 /swift 子路径。

必须包含 host 标头。格式为 example.com:3000 。
当使用 https 时，必须包含 X-Forwarded-Proto 标头。格式为 http 或 https 。
当部署在子路径时，必须包含 X-Forwarded-Path 标头，格式为 /example 。
当部署在根目录时，X-Forwarded-Path 标头必须移除或置空。

# /etc/nginx/sites-available/default

server {
    listen 80; # IPv4 端口
    listen [::]:80; # IPv6 端口

    # 使用 HTTP/2 协议（可选）
    # http2 on; 
    
    client_max_body_size 100M; # 提升上传文件大小限制
    
    location /swift {
        proxy_pass http://localhost:3000/; # 本地端口
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Path /swift; # 子目录
    }

    location /swift/ {
        proxy_pass http://localhost:3000/; # 本地端口
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Path /swift; # 子目录

        # WebSocket
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "$connection_upgrade";
    }
}