HFS文件服务器配置实战指南不花一分钱把闲置电脑变成你的私人网盘【免费下载链接】hfsHFS is a web file server for your computer. Share folders or even a single file thanks to the virtual file system.项目地址: https://gitcode.com/gh_mirrors/hf/hfs如果你手头有一台闲置电脑又恰好需要频繁地把文件分享给家人、同事或客户那么 HFS 文件服务器很可能是你今年能找到的最省事的方案。它是一款开源的 HTTP 文件服务器软件把文件共享这件事做成了一件打开网页就能完成的小事你的硬盘有多大共享空间就有多大全程不经过任何第三方云端。这篇文章不打算给你背一遍参数手册而是按一个真实用户的搭建顺序走一遍从为什么要自建到三分钟跑起来再到虚拟文件系统、权限、账户、安全、调优最后附上一份排坑清单。读完你就能动手配出一台属于自己的 HFS 文件服务器。先说个真实痛点我被网盘和微信传文件折磨了好几年先讲我自己的故事。几年前我帮家里整理老照片三百多张、加起来快 2GB。第一个念头是传网盘——结果上传限速到 200KB/s传了半小时家人那边还得注册登录、再下载一遍。换成微信发画质被压缩得没法看而且文件 7 天后就过期。U 盘拷贝两地相隔几百公里根本不存在顺便带过去这回事。后来我帮一个十几人的小团队搭内部文件共享又遇到了第二轮痛点NAS 太贵、云盘涉密不敢用、FTP 配起来一堆端口和权限要折腾。直到朋友推荐了 HFS我才发现原来这个需求早就有解了——而且免费、开源、跨平台。HFSHTTP File Server能解决的实际麻烦不限空间、不限速文件直接从你磁盘读出没有云端中转上传下载快慢全看你的带宽零学习成本访问者不需要装任何软件浏览器打开链接就能下共享内容可拼装通过虚拟文件系统可以把散落在硬盘各处的文件夹、单个文件甚至外部链接组织成一个整齐的目录树权限可控谁能看、谁能下载、谁能上传一条配置说清楚。下面这张图是 Windows 下 HFS 的典型使用方式——在资源管理器里右键文件就能直接把它加入共享列表三分钟跑起来从下载到进入管理面板HFS 的安装简单到没有安装这一步。去官方发布页下载对应系统的压缩包Windows、Linux、macOS、FreeBSD 都有现成二进制解压后直接运行那个hfs可执行文件即可。启动后正常情况下浏览器会自动打开管理面板。它长这样http://localhost:端口号/~/admin默认端口是 80所以大多数情况下地址就是http://localhost/~/admin。如果你是远程部署、浏览器没弹出来记住下面两个救急技巧技巧一在控制台手动创建管理员在 HFS 的运行窗口里输入create-admin 你的密码这会立刻创建一个管理员账户并直接打印出账户名。技巧二用一行命令生成带管理员的配置文件不习惯敲控制台的话可以先停掉 HFS在配置目录里执行echo create-admin: 你的密码 config.yaml下次启动时 HFS 会自动创建管理员并把这条配置移除。小知识默认情况下从本机localhost访问管理面板是免登录的对应配置项是localhost_admin。如果你希望远程也能进管理面板需要配置admin_net放行你的 IP 网段或者干脆在管理面板里关闭本机免登录。配置文件到底藏在哪看控制台第 6 行就够了新手最容易卡住的问题就是我明明改了配置怎么不生效——多半是没找到文件在哪。HFS 的所有配置都集中在一个config.yaml文件里位置取决于你的系统系统默认配置目录Windowsexe 分发版与hfs.exe同一个文件夹Linux / macOS~/.hfs/任意系统自定义启动时加--cwd 某目录指定如果你不确定当前用的是哪个目录直接看 HFS 启动时的控制台输出第 6 行写着working directory (cwd) ...那就是它的工作目录。这个目录值得记住因为它不只是放配置你后面安装的插件、日志文件都会落在这里。改配置的五种姿势记住两种就够用HFS 配置不只有改文件这一条路官方一共给了五种方式。按使用频率排序方式适用场景示例管理面板新手日常操作所见即所得在界面里点几下即可直接编辑config.yaml批量配置、自动化部署改完保存自动重载生效启动参数临时覆盖配置hfs --port 1080环境变量Docker、脚本化启动HFS_PORT1080 hfs控制台命令运行中临时修改config port 1080其中我建议新手主用管理面板把改文件当作理解配置结构的入口——因为config.yaml里的键名和管理面板里的选项是一一对应的看懂了文件就相当于看懂了整个 HFS 的参数体系。一个很有用的细节config.yaml保存后立即生效不需要重启服务。改错了怎么办HFS 会保留备份文件比如config.yaml.bak把备份改回去就行。让局域网外的设备也能访问端口、监听与 DDNS配置好基本服务后第一件正经事是让别人能连上你的 HFS 文件服务器。这里的别人分两种情况。场景一只在局域网内分享手机、平板连同一个 WiFi 就能访问最省心。只要确认两件事防火墙放行了 HFS 监听的端口用listen_interface指定监听网卡比如内网 IP192.168.1.100避免服务暴露在奇怪的地方。访问地址就是http://你电脑的内网IP:端口。场景二让公网用户访问这需要你的路由器把端口映射到这台电脑或者直接使用 HFS 内置的 DDNS 更新功能让域名始终指向你变化的外网 IPdynamic_dns_url: | https://api.dynu.com/nic/update?hostnameyourdomain.commyip https://backup.ddns.net/update?ip.*success每条 URL 后面的加正则是用来判断 DDNS 服务商是否返回了成功响应的不写的话默认按 HTTP 状态码判断。如果你的服务器前面还有一层代理比如 Nginx、Cloudflare记得设置proxies参数告诉 HFS 信任几层代理否则它拿到的客户端 IP 全是代理的地址日志和安全规则都会失真。虚拟文件系统 VFS把硬盘重新拼装成你想要的样子接下来是 HFS 的灵魂功能虚拟文件系统Virtual File System简称 VFS。传统的文件共享是我共享哪个文件夹你就只能看哪个文件夹。VFS 则完全打破了这个限制——你可以在不移动任何磁盘文件的前提下自由组装一个虚拟目录树就像用乐高积木拼一个模型而积木散落在硬盘的不同角落。看一个最基础的结构vfs: children: - name: 公共资料 source: /data/public - name: 设计素材 source: /data/design - name: 团队相册 source: /data/photos访问者打开你的 HFS 页面看到的是公共资料、设计素材、团队相册三个整齐的文件夹而不会看到磁盘上那些乱七八糟的真实路径。VFS 的节点属性不多但组合起来威力很大。常用属性速查属性作用例子source指向磁盘上的真实路径/data/photosname对外显示的名字不写则自动推断团队相册children子节点列表用于嵌套目录见上文url让这个节点变成一个外链https://example.comtarget外链是否新窗口打开_blankdefault文件夹默认展示某个文件而非文件列表index.htmlorder强制节点排在列表最前或最后1置顶、-1置底mime指定 MIME 类型video/*masks按文件名批量套用属性见下节用 masks 一条规则管住一类文件masks是我个人最常用的 VFS 功能。它允许你给匹配某个文件名模式的所有文件批量设置属性规则写在节点内部即可vfs: source: /media masks: *.jpg|*.png|*.gif: mime: image/* **/backup/**: can_read: admin *.mp4|*.avi: can_read: [vip]有几个细节值得注意规则从上到下优先级递减靠前的规则说了算子节点的规则会覆盖父节点继承下来的规则掩码以|files|结尾则只匹配文件不匹配文件夹以|folders|结尾则相反。权限描述符 Who五分钟看懂谁能干什么聊完结构就该聊门禁了。HFS 里的权限都用一种叫Who 描述符的格式表达总共就五种取值取值含义true任何人可以包括未登录的访客false任何人都不可以*任何已登录账户可以admin仅管理员可以[user1, user2]指定账户或组可以配合 VFS 节点上的权限属性使用can_read能否下载该文件/文件夹默认truecan_see能否在列表里看到它。注意即使能下载也可以让它不出现在列表里适合有直链但不想被浏览的场景can_upload能否向该文件夹上传默认admincan_list能否查看文件夹内容默认跟随can_readcan_delete能否删除文件默认admincan_archive能否把文件夹打包成 ZIP 下载默认跟随can_read。看一个组合示例vfs: source: /shared masks: **/内部资料/**: can_read: [管理层] can_see: false **/上传区: can_upload: [运营组] can_delete: false这样一份配置的效果是普通访客根本看不到内部资料这个目录只有管理层能下载上传区里运营可以传文件但谁也删不掉。进阶技巧权限还支持can_something: 其他权限名的写法用来让一个权限跟随另一个权限比如can_see: can_read这样以后只需改一处。账户与用户组给每个人发不同的钥匙单靠 IP 做权限区分并不可靠正式使用还是得配账户。HFS 的账户系统写在accounts下结构是用户名 属性的字典accounts: admin: password: 一个强密码 admin: true ignore_limits: true zhangsan: password: zhang2024 belongs: [普通用户, 项目A] guest: password: guest disable_password_change: true 普通用户: 项目A:注意最后两个组就是没有密码的账户。你不能用组名登录但它可以挂一堆账户让这些账户集体继承组的权限——想给整个项目组加权限时只需改组不用一个个改人。还有一个值得知道的安全细节配置里写明文passwordHFS 会在读取后自动把它加密成不可逆的srp字段并替换掉。所以你的明文密码不会长期躺在配置文件里。账户的进阶玩法限速、过期、限定登录 IP给发钥匙加上条件很多管理场景就活了accounts: trial: password: trial123 days_to_live: 30 # 第一次登录后 30 天过期适合给客户试用 allow_net: 192.168.1.0/24 # 只允许公司内网登录 redirect: /项目A # 登录后自动跳到指定目录 ignore_limits: false # 不享受限速豁免 disabled_user: password: x disabled: true # 一键停用不删除配置days_to_live自动给账户设置过期时间到期后无法登录适合临时账号allow_net限制该账户只能从指定网段登录账号泄露也能兜底disabled停用账户但保留配置比删除更安全。安全加固清单防爆破、防爬虫、防盗链文件服务器一旦暴露到公网就一定会被扫描器盯上。HFS 本身内置了不少防护手段按建议配置顺序列一张清单① 防暴力破解默认就开enable_plugins的默认值是[ antibrute ]也就是说防暴力破解插件开箱即用它会自动阻止频繁失败的登录尝试。除非你明确知道自己在做什么否则别把它从列表里去掉。② IP/国家黑名单block: - ip: 192.168.0.90 - ip: 10.0.0.0/8 - country: XX # 屏蔽指定国家③ 地理防火墙需要按国家做更细的控制时用geo_*系列geo_enable: true geo_allow: false # false 黑名单模式true 白名单模式 geo_list: [XX, XX] # 国家代码列表 geo_allow_unknown: false # 无法识别国家的连接直接断开启用后 HFS 每月会自动下载一次约 2MB 的国家数据库属于低成本高收益的安全投资。④ 防盗链allowed_referer可以限制哪些网站能引用你的文件链接。比如你只想让自家网站能嵌图就配置成allowed_referer: *.yourdomain.com其他网站引用过来的请求会被拒绝防止别人把你的服务器当图床、白嫖带宽。⑤ 上传保护min_available_mb: 500 # 磁盘剩余低于 500MB 时拒绝上传 delete_unfinished_uploads_after: 3600 # 未完成的上传 1 小时后自动清理 split_uploads: 100 # 大文件分块上传每块 100MB这三条配合能避免磁盘被传爆和一堆半截文件占空间两个经典事故。带宽与并发限制别让一个下载拖垮整台机器如果你的服务器是给多人用的限速和并发控制必须提前想好否则一个开着迅雷下载大文件的用户就能把带宽吃满其他人全部卡死。相关配置一共五个一次说清配置项含义我的建议值max_kbps全局限速按上行带宽的 80% 留余量max_kbps_per_ip单 IP 限速家用共享设 10241MB/smax_downloads全站最大并发下载10~20max_downloads_per_ip单 IP 并发下载数2~3max_downloads_per_account单账户并发下载数3另外两个和大文件夹下载体验有关的参数也值得调zip_calculate_size_for_seconds下载文件夹前HFS 会先花几秒计算 ZIP 的总大小好让浏览器显示进度条。对超大目录这很费时设成0可以跳过计算、立即开始流式打包file_timeout访问文件时的超时时间默认 3 秒。如果共享目录在很慢的 SMB 网盘上建议调大到 10 秒。提醒ignore_limits为true的账户比如管理员不受上述限制这是设计如此别误以为是 bug。进阶三件套免费 HTTPS 证书、多站点、插件基础能用之后下面三个进阶能力能明显提升体验。① 一键申请免费 HTTPS 证书https_port监听 443再配上acme_domain指定你的域名HFS 会通过 ACME 协议自动申请并续期 Lets Encrypt 证书https_port: 443 acme_domain: files.yourdomain.com acme_renew: true证书搞定后把force_https设为true所有 HTTP 请求自动跳转到 HTTPS地址栏的小锁就再也不掉了。② 基于域名的多站点roots可以把不同域名映射到不同目录实现一台服务器跑多个站点roots: music.yourdomain.com: /data/music images.yourdomain.com: /data/images docs.yourdomain.com: source: /data/docs default: index.html③ 插件系统HFS 的功能可以通过插件继续扩展。项目内置了三个实用插件antibrute防暴力破解默认启用download-counter给文件加下载次数统计并显示在页面上list-uploader支持批量文件上传。启用方式enable_plugins: [antibrute, download-counter, list-uploader]另外 HFS 还内置了 WebDAV 支持可以用系统自带的文件管理器直接挂载成网络磁盘force_webdav_login和webdav_initial_auth可以控制它的认证方式——这个功能对想让同事像用本地盘一样用共享目录的场景特别实用。运维避坑新手最容易踩的 6 个坑配置跑起来不难但有几个坑几乎人人都会踩提前打个预防针别人访问不了先查防火墙和端口HFS 启动正常不等于端口对外开放了Windows/Linux 防火墙都要放行对应端口路由器还要做端口映射。远程进不了管理面板检查localhost_admin和admin_net前者默认只信任本机后者默认不限制来源。日志把磁盘写爆默认log_rotation是每周轮转一次频繁使用的服务器建议改成daily并定期清理旧日志。上传总是失败先看min_available_mb是不是把磁盘空间卡死了再看split_uploads是否开启分块上传对弱网环境提升明显。密码忘了管理面板进不去时在控制台敲create-admin 新密码或者echo create-admin: 新密码 config.yaml后重启。CDN/反代后面 IP 全一样记得设置proxies层数否则日志、黑名单全部失效。结尾一张从能用变好用的自检清单最后送你一份自检清单照着过一遍你的 HFS 文件服务器就真正毕业了✅ 启动正常浏览器能打开管理面板✅ 找到了config.yaml的位置控制台第 6 行✅ 局域网内其他设备能正常访问和下载✅ 用 VFS 把共享内容组织成了清晰的目录树✅ 用masks和 Who 描述符给敏感目录设好了权限✅ 创建了管理员以外的日常账户并设置了密码✅ 公网部署已开启 HTTPS 和防爆破插件✅ 已配置带宽限制避免单用户拖垮全站✅ 日志轮转已开启不会撑爆磁盘配置 HFS 文件服务器本质上就是在回答三个问题共享什么、谁能用、用多快。把这三个问题在纸上想清楚剩下的都只是参数而已。现在就去把那台吃灰的电脑打开吧——从你按下启动键到第一个访客下载成功可能用不了五分钟。【免费下载链接】hfsHFS is a web file server for your computer. Share folders or even a single file thanks to the virtual file system.项目地址: https://gitcode.com/gh_mirrors/hf/hfs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考