经常会遇到一些场景，需要记录一些文字、连接或者多媒体信息抑或是一些隐私性的信息，虽然可以通过聊天工具，或者一些其他的工具，但个人用下来的感受就是要么不够隐私，要么太麻烦，有的只能发文字，有的只能发文件，所以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. 克隆仓库
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 及其它静态资源。
- Api/: Minimal API 扩展方法与请求 DTO（按资源分文件组织，路由前缀
-
AnyDrop.App/: 跨平台移动/桌面客户端（MAUI），用于在手机/桌面上接入 AnyDrop 服务并同步内容。
- MAUI 项目使用
net10目标框架，平台代码放在Platforms/，UI 放在UI/与Components/。
- MAUI 项目使用
-
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
环境变量参考
| 变量名 | 说明 | 默认值 |
|---|---|---|
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/— 上传的文件
备份示例：
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 --project AnyDrop
# 应用迁移
dotnet ef database update --project AnyDrop
构建容器镜像
docker build -t anydrop .
docker run -p 8080:8080 -e Auth__JwtSecret=your-secret anydrop