fileserver：单文件自建文件服务器（GO）

一、为什么要再造一个文件服务器#

网盘限速、第三方工具要装 Docker 拉一堆镜像、老 NAS 上连 Node 都跑不动——fileserver 就是为了解决这些场景：一个可执行文件，拷过去就能跑。

它的定位很简单：

• 单个二进制文件：Go 编写、零第三方库，前端页面经 go:embed 直接编译进二进制，无任何运行时依赖；图片缩略图、文本预览、统计图全部在浏览器端渲染，弱机服务器只负责透传字节流
• 8 个平台开箱即用：从 x86 云服务器到 mipsle 架构的老路由器，总有一个包能跑
• 核心功能齐全：目录管理、分片断点续传上传、限时限次分享链接、WebDAV 直连、回收站、一键自更新

1
介绍页 (fileserver.zlion.top)
2
├─ 首屏       一句话定位 + 一键部署命令 + Release 下载入口
3
├─ 功能总览   分片上传 / 分享链接 / WebDAV / 相册视图 …逐项配截图
4
├─ 部署方式   直接运行 / 一键脚本 / Docker 三条路径并列对比
5
├─ 安全设计   PBKDF2、AES-GCM、路径越权防护等实现说明
6
└─ 常见问题   反代 127.0.0.1、413、别名冲突 …就地给排查方向

二、功能总览#

三、大文件分片上传#

家用宽带上传几个 GB 的文件，最怕的就是传到 90% 断网重来。大文件（≥8MB）自动走分片通道：前端把文件切成 4MB 的分片逐个上传，服务端顺序追加落盘，完成后同盘原子改名——中途断网只补缺失的分片，已经传上去的字节不会浪费。

会话对客户端完全透明：普通小文件仍走一次性请求，分片文件在完成前对文件列表、搜索、WebDAV、ZIP 打包全部不可见，不会外泄半成品。

四、分享与浏览的几处细节#

1
默认：  https://files.example.com/s/a7f3c9e21b8d4f06
2
别名：  https://files.example.com/s/发布会-materials

五、快速开始#

1
chmod +x fileserver
2

3
./fileserver --port 16666 --dir /data/files --user admin --pass 你的密码

六、三种部署方式怎么选#

介绍页里把三条路径并列放在一起，选哪条看你的环境：

1
curl -fsSL https://raw.githubusercontent.com/Zlion-Y/fileserver/main/install-remote.sh -o install-remote.sh
2

3
sudo bash install-remote.sh --dry-run
4

5
sudo FS_USER=admin FS_PASS=你的密码 bash install-remote.sh

1
cp .env.example .env
2

3
docker compose up -d

七、一键自更新是怎么工作的#

个人服务器最烦的就是升级：登服务器、找架构、下载、替换、重启。fileserver 把这整套做成了一个按钮：

服务器连不上 GitHub 也没关系：本地下载好二进制，从网页直接上传更新包（上限 256MB），校验通过后同样替换重启。

八、WebDAV：播放器直连#

服务地址即 http://<主机>:<端口>/dav/，认证同管理端账号密码。Salt Player、foobar2000、常规移动端文件管理器都能直连，音乐 / 视频流式播放支持拖动进度条；通过 WebDAV 删除的文件同样进回收站，防误删。

九、安全设计#

• 口令哈希：管理端与分享密码均用 PBKDF2-HMAC-SHA256（管理端 10 万轮 / 分享端 5 万轮），旧版单次 SHA-256 记录校验通过后自动就地升级，无需用户操作
• 密码加密存储：分享密码以 AES-GCM 加密落盘，主密钥独立文件存放；config.json（管理密码哈希）、shares.json（加密密码与访问日志）、主密钥文件均以 0600 权限落盘，泄露不再连带交出密码
• 改密踢会话：修改管理员密码后立即踢出其他所有登录会话，被盗会话不会永久有效
• 续传授权：下载断点续传必须持有真实下载后签发的 ticket Cookie，伪造 Range: bytes=1- 无法绕过一次性链接的次数限制
• 路径越权：所有路径参数做根目录校验 + 符号链接兜底，../ 逃逸与 root 内软链指向外部均无效
• 防盗链：按分享开启 Referer 校验，外站页面引用返回 403，直访与下载工具不受影响
• 上传限制：MAX_UPLOAD_MB 对普通与分片上传同样生效；分片临时文件对列表 / 搜索 / WebDAV / ZIP 不可见，半成品不会外泄

十、注意事项与故障排查#

常见问题排查：

在线体验： fileserver.zlion.top<446> ｜ 介绍页： fileserver.zlion.top ｜ 开源仓库： Zlion-Y/fileserver 文档版本： 2026-09-22 软件版本： fileserver v1.3.5 适用平台： 云服务器 / 本地虚拟机 / NAS / 软路由 / Docker