经常会遇到一些场景，需要记录一些文字、连接或者多媒体信息抑或是一些隐私性的信息，虽然可以通过聊天工具，或者一些其他的工具，但个人用下来的感受就是要么不够隐私，要么太麻烦，有的只能发文字，有的只能发文件，所以AnyDrop应运而生。

Github连接：https://github.com/KOPElan/anydrop

私有、自托管的跨设备内容共享应用，基于 .NET 10 + Blazor 构建。

通过浏览器即可在任意设备间安全地保存与获取文字、图片、文件和链接，实时同步，无需依赖任何第三方云服务。

功能特点

• 跨设备实时同步 — 基于 SignalR（WebSocket），消息推送即时到达所有已登录设备
• 多类型内容 — 支持文字、图片、视频、任意文件、链接（含 OG 元数据预览）
• 主题分组 — 将内容按主题（频道）组织，支持置顶、归档、删除
• 主题搜索 — 全文搜索、按日期查找、按类型（图片/视频/文件/链接）分类浏览
• 阅后即焚 — 消息可设为"阅后即焚"，阅读后自动销毁
• 单用户私有部署 — 首次访问完成初始化设置，密码保存在本地数据库，不外发
• 容器化就绪 — 提供 Dockerfile 与 docker-compose.yml，一命令启动

技术栈

快速开始

服务端

方式一：Docker Compose（推荐）

1. 克隆仓库

git clone https://github.com/KOPElan/anydrop.git
cd anydrop

2. 创建环境变量文件

cp .env.example .env   # 若不存在则手动创建

.env 文件内容示例：

# 必填：JWT 签名密钥（建议 32 位以上随机字符串）
ANYDROP_JWT_SECRET=your-very-long-random-secret-key

# 可选：上传文件大小上限（字节），默认 100 MB
ANYDROP_MAX_FILE_SIZE=104857600

# 可选：登录令牌有效期（小时），默认 24 小时
ANYDROP_TOKEN_EXPIRY_HOURS=24

3. 启动服务

docker compose up -d

如果要更新服务请使用build命令

git pull
docker compose down
docker compose up -d --build

4. 初始化账号

首次启动后，在浏览器访问 http://localhost:8080/setup，设置登录密码。

数据（SQLite 数据库 + 上传文件）持久化到 Docker volume anydrop-data，容器重启不会丢失。

方式二：本地源码运行

前置要求

• .NET 10 SDK
• Node.js ≥ 20（用于 Tailwind CSS 编译）

步骤

# 1. 克隆仓库
git clone https://github.com/KOPElan/anydrop.git
cd anydrop

# 2. 安装前端依赖（Tailwind CSS）
npm install

# 3. 配置 JWT 密钥（推荐使用 .NET User Secrets，避免提交密钥到版本库）
cd AnyDrop
dotnet user-secrets set "Auth:JwtSecret" "your-very-long-random-secret-key"
cd ..

# 4. 启动应用
dotnet run --project AnyDrop

应用默认监听 http://localhost:5002。

首次运行请访问 http://localhost:5002/setup 完成初始化。

目录结构（详解）

• AnyDrop/: 服务端主项目，包含 Minimal API、SignalR Hub、EF Core 上下文与前端静态资源。

  • Api/: Minimal API 扩展方法与请求 DTO（按资源分文件组织，路由前缀 /api/v1/）。
  • Components/: Blazor 组件与页面（Interactive Server 模式）。Razor 组件应尽量使用 code-behind .razor.cs 分离复杂逻辑。
  • Data/: 包含 AnyDropDbContext.cs 与数据库迁移文件（SQLite）。
  • Hubs/: SignalR Hub（ShareHub）用于实时推送消息到已连接的客户端。
  • Services/: 核心业务实现（接口 + 实现），禁止直接依赖 Razor 组件。
  • wwwroot/: Tailwind 编译后样式、JS 及其它静态资源。

• AnyDrop.App/: 跨平台移动/桌面客户端（MAUI），用于在手机/桌面上接入 AnyDrop 服务并同步内容。

  • MAUI 项目使用 net10 目标框架，平台代码放在 Platforms/，UI 放在 UI/ 与 Components/。

• AnyDrop.Shared/: 跨项目共享 DTO 与类型定义。

• Tests.Unit/ 与 Tests.E2E/: 单元与端到端测试代码。

服务端简介

• 框架与角色: 服务端为 AnyDrop 项目，基于 .NET 10、Minimal API 与 Kestrel。API 路由以 /api/v1/ 命名空间暴露，认证采用 JWT + Cookie 混合方案。
• 持久化: 使用 SQLite（文件存储），默认数据目录为 data/，包含数据库文件与上传的文件目录。
• 实时同步: 通过 SignalR Hub（Hubs/ShareHub.cs）实现消息广播与客户端订阅。Hub 只负责转发与鉴权，业务逻辑放在 Services/ 中处理。
• 配置: 推荐通过环境变量或 dotnet user-secrets 设置敏感配置（如 Auth__JwtSecret）。容器部署时通过 .env 或容器环境变量注入。

移动端（MAUI）简介

• 项目: AnyDrop.App 为 MAUI 应用，支持 Android、iOS、Windows 等（按平台包含在 Platforms/）。
• 目的: 提供原生体验的接入端，可在移动端快速浏览、上传与接收任意类型内容，并通过 SignalR 保持实时连接。
• 开发: 在本机开发时，可在 IDE（Visual Studio）中启动 AnyDrop.App，或使用 dotnet build / dotnet run 针对特定平台进行调试。移动端通过配置的 API 地址与服务端通信，开发时请确保服务端可访问（ASPNETCORE_URLS 设置为可被设备/模拟器访问的地址）。

Tailwind 开发监听

项目包含两个 Tailwind 输入源：

• 服务端（Blazor）: AnyDrop/wwwroot/app.css → 输出 AnyDrop/wwwroot/tailwind.css。
• 移动端/静态（MAUI/SPA）: AnyDrop.App/wwwroot/css/input.css → 输出 AnyDrop.App/wwwroot/css/tailwind.css。

分别构建或监听方式如下：

# 服务端：构建 / 监听
npm run css:build:server
npm run css:watch:server

# 移动端：构建 / 监听
npm run css:build:app
npm run css:watch:app

环境变量参考

数据备份

持久化数据存放在 Docker volume anydrop-data（挂载到容器的 /data），包含：

• /data/anydrop.db — SQLite 数据库（用户、主题、消息元数据）
• /data/files/ — 上传的文件

备份示例：

docker run --rm \
  -v anydrop-data:/data:ro \
  -v $(pwd)/backup:/backup \
  alpine tar czf /backup/anydrop-backup-$(date +%Y%m%d).tar.gz /data

开发指南

运行测试

# 单元测试
dotnet test AnyDrop.Tests.Unit

# E2E 测试（需先启动应用）
dotnet test AnyDrop.Tests.E2E

数据库迁移

# 添加新迁移
dotnet ef migrations add <MigrationName> --project AnyDrop

# 应用迁移
dotnet ef database update --project AnyDrop

构建容器镜像

docker build -t anydrop .
docker run -p 8080:8080 -e Auth__JwtSecret=your-secret anydrop

License

GPL-3.0