更新日志

v0.0.1 （2025-12-28）

特性

支持平台

• macOS desktop
• iOS app
• android app
• linux server

文件共享

• 文件浏览：查看共享目录中的文件列表（支持子目录）
• 文件上传：支持本地上传，远程上传（远程上传开关）
• 文件下载：从服务端下载文件到本地
• 文件删除：删除服务端文件（需开启权限）
• 断点下载：HTTP Range 支持，大文件可断点续传
• 同名冲突处理：支持自动重命名 / 覆盖 / 报错三种策略

设备发现

• 局域网设备自动发现
• 手动连接：浏览器直接访问，移动端App手动连接

服务配置

• 共享目录选择：可视化或配置文件选择要共享的文件夹
• 远程上传控制：可配置是否允许远程设备上传文件
• 删除权限控制：可配置是否允许删除文件
• 自动停止服务：可配置无操作后自动关闭服务
• 配置持久化：配置自动保存到本地文件

用户界面

• Web UI：响应式设计，适配手机和电脑浏览器
• Desktop UI：桌面应用原生窗口界面
• 深色模式：支持明暗主题切换
• 国际化：支持中文和英文
• 访问地址展示：展示服务端可访问的 URL 列表
• 二维码分享：生成二维码供移动端扫码访问

安全机制

• 路径遍历攻击：URL 解码后校验，禁止 .. 等特殊路径
• 符号链接逃逸：不跟随共享目录中的 symlink
• 文件覆盖风险：先写临时文件，完成后原子 rename
• 局域网限制：可配置仅允许局域网 IP 访问
• 大文件攻击：单文件大小限制（默认 10GB）
• 密码保护：访问密码

服务器部署安全要求

• lan_only=false： 开启远程访问
• password： 必填 无密码时启动失败
• listen_addr： 0.0.0.0 | 监听所有网卡，不要填公网 IP
• 局域网设备发现: 自动禁用, lan_only=false 时自动关闭