AnyDrop 一款自部署的内容共享工具

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

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

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

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

功能特点

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

技术栈

层	技术
框架	.NET 10 · Blazor Web App（Interactive Server）
数据库	SQLite（EF Core）
实时通信	ASP.NET Core SignalR
样式	Tailwind CSS v4
认证	JWT Bearer + Cookie
容器	Docker / Docker Compose

快速开始

服务端

方式一：Docker Compose（推荐）

1. 克隆仓库

bash 复制代码

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

2. 创建环境变量文件

bash 复制代码

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

.env 文件内容示例：

dotenv 复制代码

# 必填：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. 启动服务

bash 复制代码

docker compose up -d

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

bash 复制代码

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 编译）

步骤

bash 复制代码

# 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。

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

bash 复制代码

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

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

环境变量参考

变量名	说明	默认值
`Auth__JwtSecret`	JWT 签名密钥（必填）	---
`Auth__TokenExpiryHours`	登录令牌有效期（小时）	`24`
`Auth__LoginMaxFailures`	登录失败锁定阈值	`5`
`Auth__LoginCooldownSeconds`	登录冷却时间（秒）	`60`
`Storage__DatabasePath`	SQLite 数据库路径	`data/anydrop.db`
`Storage__BasePath`	上传文件存储目录	`data/files`
`Storage__MaxFileSizeBytes`	单文件大小上限（字节）	`104857600`（100 MB）
`ASPNETCORE_URLS`	Kestrel 监听地址	`http://+:5002`（容器内为 `http://+:8080`）

数据备份

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

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

备份示例：

bash 复制代码

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

开发指南

运行测试

bash 复制代码

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

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

数据库迁移

bash 复制代码

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

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

构建容器镜像

bash 复制代码

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

License

GPL-3.0