skyfay/skysend

SkySend

镜像概述

SkySend是一款极简的自托管文件和笔记共享服务，采用端到端加密技术。文件和笔记在浏览器内通过AES-256-GCM完成加密后才上传至服务器，服务器仅存储加密数据，无法获取解密密钥，实现零知识保护。无需账户，无跟踪，无分析，完全开源。

核心功能

🔒 端到端加密

• AES-256-GCM流式加密（64KB记录大小）
• HKDF-SHA256密钥派生（文件密钥、元数据密钥、认证密钥分离）
• 零知识设计：解密密钥仅存在于URL片段（#），永不离开浏览器
• Argon2id密码保护（WASM实现，抗GPU***）

📁 上传与共享

• 拖拽上传（文件/文件夹）
• 多文件上传（单次最多32个文件，客户端侧压缩）
• 文件夹上传（支持文件夹选择器）
• 可配置过期时间与下载次数限制
• 可选密码保护
• 一键复制分享链接

📝 加密笔记

• 文本笔记（支持Markdown实时预览）
• 密码共享（多密码存储、掩码显示、复制按钮、内置密码生成器）
• 代码片段（语法高亮、行号显示，支持22种语言）
• Markdown笔记（完整GitHub Flavored Markdown支持）
• SSH密钥（浏览器内生成Ed25519/RSA密钥对或粘贴现有密钥）
• 阅后即焚（单次查看后自毁）
• 查看次数限制（可配置无限次）

👥 OIDC/SSO认证

• 可选SSO：通过OIDC兼容提供商限制上传权限
• 支持预设：PocketID、Authentik、Keycloak及通用OIDC提供商
• 细粒度保护：独立配置文件上传/笔记创建是否需要登录
• 下载始终公开：认证仅限制上传操作
• 无状态会话：JWT签名Cookie，无需数据库变更
• CLI支持：自动打开浏览器登录，令牌缓存至本地

📊 上传仪表盘

• 无需账户：上传历史存储于本地IndexedDB
• 实时状态：下载/查看次数、剩余次数、过期倒计时
• 筛选与管理：按文件/笔记筛选、重新复制链接、删除条目
• 自动清理：过期条目自动移除

☁️ S3存储支持

• 兼容S3：支持Cloudflare R2、AWS S3、MinIO等
• 直接下载：通过预签名URL提供文件（短期有效，强制执行过期与下载限制）
• 性能可调：可配置分片大小与上传并发数

🐳 Docker就绪

• 单容器部署：docker compose up -d即可启动
• 多架构支持：AMD64与ARM64镜像
• 健康检查：内置/api/health端点
• 可配置UID/GID：确保卷权限正确
• 优雅关闭：支持SIGTERM信号处理

💻 客户端CLI

• 跨平台：Linux、macOS、Windows预编译二进制
• 端到端加密：与Web客户端相同的AES-256-GCM加密
• 命令支持：上传文件、下载文件、创建笔记、查看笔记、认证登录/登出等
• 脚本友好：--json flag输出机器可读格式

使用场景

1. 个人隐私文件共享：分享敏感文件（如证件、合同），确保数据仅接收方可见
2. 团队内部协作：传递内部文档、代码片段，避免第三方服务泄露风险
3. 临时文件分享：设置过期时间，自动清理不再需要的文件
4. 加密笔记传递：分享密码、SSH密钥等敏感信息，阅后即焚保障安全

配置说明

Docker部署示例

yaml
# docker-compose.yml
services:
  skysend:
    image: docker.xuanyuan.run/skyfay/skysend:latest
    container_name: skysend
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
      - ./uploads:/uploads
    environment:
      - BASE_URL=http://localhost:3000
      # 所有环境变量参考：https://docs.skysend.app/user-guide/configuration/environment-variables

启动命令：

bash
docker compose up -d

访问地址：http://localhost:3000

客户端CLI安装与使用

Linux/macOS安装：

bash
curl -fsSL https://skysend.app/install.sh | sh

Windows PowerShell安装：

powershell
irm https://skysend.app/install.ps1 | iex

常用命令：

bash
# 设置服务器
skysend config set-server https://your-instance.com

# 上传文件
skysend upload ./document.pdf

# 带密码和过期时间的上传
skysend upload ./secret.zip --password --expires 1h --downloads 5

# 下载文件
skysend download https://your-instance.com/file/abc123#secret

# 创建加密笔记
skysend note "这是一条秘密消息" --type text --expires 24h

安全设计

完整加密设计文档：https://docs.skysend.app/developer-guide/***/

技术栈

文档与支持

• 完整文档：https://docs.skysend.app
• 社区***：[***]
• 问题反馈：https://github.com/Skyfay/SkySend/issues
• 安全漏洞报告：***（请勿公开提交）

许可证

GNU Affero General Public License v3.0 - 任何托管实例必须开源其源代码。