做这个项目的初衷，是受 macOS AirDrop / 简易分享体验以及雾计算（Fog Computing）边缘轻量化理念的启发：很多时候我们只想临时分享一个几百兆的压缩包、给客户快速预览一个静态 Demo 网页，或者托管一个单页应用（SPA），并不需要把整套重量级云盘或复杂的网盘服务搬出来。
### 它能做什么？
1. **单文件与静态站点即时分发**
原生支持 `.pdf`、`.md`、`.zip`、`.tar.gz` 等文件的高亮预览与直接下载；上传 HTML 文件可直接渲染为网页，甚至内置了集中式前端共享库复用（如 p5.js、Three.js 等）。
2. **SPA 前端路由无缝容错**
分发 React / Vue 等单页应用打包产物时，深层路由刷新自动回退至 `200.html` 或 `index.html`，告别 404。
3. **安全防爆破与阅后即焚**
支持访问口令、高频防爆破封禁锁定，以及设置访问次数限制（阅后即焚）。内置智能反爬机制，能过滤社交平台爬虫（Twitter、Slack、Telegram 等）预抓取，防止配额被提前消耗。
4. **ZIP 炸弹防御与免 Cron 自维护**
解压过程内置膨胀率与条目上限检测；后台通过排他锁守护进程自动汇总统计并定时清理过期文件，无需配置系统定时任务。
5. **双访问模式与多语言**
同时支持 Path 模式（`domain.com/$slug`）与 Subdomain 子域名模式（`$slug.domain.com`），且内置 8 种语言的国际化支持。
### 如何快速体验？
**方式一：Docker Compose（推荐）**
```bash
git clone https://github.com/fogshare/fogshare.git
cd fogshare
docker compose up -d
docker compose logs | grep -A 4 "Security Alert"
```
**方式二：裸机一键安装（Linux VPS）**
```bash
curl -fsSL https://github.com/fogshare/fogshare/raw/main/install.sh | sudo bash
```
**配套终端发布工具：**
支持直接通过命令行一键分发文件或目录：
```bash
./bin/fogshare ./dist/ -s my-demo -p 8888 -t 7d
```
项目遵循 MIT 协议完全开源，代码轻量，欢迎在 GitHub 上 Star、试用并提出宝贵建议！
* **项目地址**：[https://github.com/fogshare/fogshare](https://github.com/fogshare/fogshare)
Leave a Thought