Local File Hub v0.1.3 正式发布：让文件共享回归简单与可控
文件存在哪里、谁能访问、如何分享，以及发生了哪些操作，应该由使用者自己掌握。
在日常工作中，我们经常需要在不同设备之间传输文件，或者将项目资料、设计素材、技术文档共享给其他成员。然而，看似简单的文件共享，实际使用时往往会遇到不少问题：
文件分散在不同设备，查找和整理不方便。
团队成员需要共享资料，却难以分别控制访问权限。
临时发送文件时，希望限制访问时间和下载范围。
部分内部文档只允许查看，不希望被直接下载。
希望集中保存文件，却不想依赖额外的云存储服务。
为了解决这些问题，我们开发了 Local File Hub（柯影文件共享站）。如今，Local File Hub 正式发布 v0.1.3 版本。本次发布不仅完善了基础文件管理能力，还加入了精细化权限控制、公开分享、动态水印、安全审计与数据备份等功能，让它从一个简单的文件共享工具，逐步发展为适用于个人和团队的私有化文件管理平台。
01｜一个属于自己的文件共享空间
Local File Hub 的核心理念很简单：
把文件保存在自己的设备上，通过浏览器完成访问与管理。
与依赖第三方云存储的平台不同，Local File Hub 将文件内容保存在部署设备的本地目录中。用户可以将它部署在 Linux 服务器、NAS、Windows 电脑或其他适合长期运行的设备上。在局域网环境中，连接同一网络的授权用户可以通过浏览器访问文件共享站。如有远程访问需求，也可以配合 HTTPS 反向代理进行公网部署。整个过程不要求接入第三方对象存储、消息队列或外部 API。对于希望自主管理文件存储位置和访问权限的用户而言，这意味着更直接的控制方式。
02｜不只是上传和下载，更是完整的文件管理
一个实用的文件共享平台，不应该只有上传和下载两个按钮。Local File Hub 提供了完整的日常文件管理能力。
文件集中管理
支持创建文件夹、上传文件、重命名、复制、移动和删除文件。用户可以按照项目、部门、业务或个人习惯组织文件目录，让资料管理更加清晰。
文件快速查找
支持通过文件名称搜索，并根据文件类型进行筛选。同时提供名称、大小、创建时间和修改时间等排序方式，方便用户快速定位需要的内容。当前搜索范围为所在目录，不是跨所有目录的全局搜索。
浏览器在线预览
支持常见图片、音频、视频、PDF 和纯文本文件预览。对于图片素材、项目文档和媒体文件，无需每次下载到本地才能查看。
大文件流式访问
针对音视频等文件，平台提供 HTTP Range 流式传输能力。浏览器可以按需请求文件内容，更适合媒体播放等使用场景。当前版本默认单文件上传限制为 1 GiB，管理员可以根据实际环境调整。
03｜六维权限管理，让文件访问更清晰
团队文件共享最重要的问题之一，就是权限管理。并不是所有成员都应该拥有相同的文件操作权限。例如：
项目负责人需要管理资料，普通成员只负责上传，部分协作人员只能浏览，而外部合作人员可能只需要访问指定文件。
针对这些需求，Local File Hub 提供了六维权限模型。六项核心权限：
读取：浏览目录和预览文件。
下载：下载文件和访问媒体流。
上传：上传文件和创建文件夹。
编辑：重命名、移动、复制和删除。
Markdown 编辑：在线修改 Markdown 文档。
分享：创建文件或文件夹的公开分享链接。
管理员可以针对不同员工、文件及文件夹分别配置权限。平台还支持目录权限继承。如果某个文件没有单独配置权限，就会按照规则继承上级目录的权限设置。这意味着，管理者不需要为每一个文件重复进行授权，也能实现更细致的访问控制。管理员还可以指定部分员工管理文件权限，让团队协作更加灵活。
04｜公开分享，让文件传递更加灵活
除了内部成员共享，Local File Hub 还支持通过链接向外部人员分享文件。创建分享链接时，可以根据实际需求设置访问规则。支持的分享能力包括：
匿名访问，无需注册平台账号。
设置链接有效期限。
限制访问次数。
添加访问密码。
随时撤销分享链接。
分享指定文件或文件夹。
例如，需要将一份项目交付文档发送给客户，可以创建一个具有有效期的分享链接，并设置访问密码。当文件不再需要对外开放时，创建者可以撤销分享。对于文件夹分享，系统会限制访问范围，避免通过分享入口访问授权目录之外的文件。
05｜动态身份水印，为文件分享增加溯源信息
文件共享不仅需要方便，也需要考虑信息流转过程中的管理问题。Local File Hub v0.1.3 加入了动态水印功能。对于图片文件，平台可以在预览和下载时，由服务端动态叠加身份水印。当文件通过公开链接分享时，水印还可以包含分享者身份及分享短码，帮助管理人员识别文件的分享来源。管理员可以配置水印文本、透明度、颜色、字体大小、位置和旋转角度等参数。同时，还可以分别控制图片预览与下载时是否启用水印。动态水印主要用于信息标识和辅助溯源，并不意味着能够完全阻止截图、复制或二次传播。平台希望通过这一机制，为内部文档、项目素材和交付资料提供更清晰的管理标识。
06｜Markdown 在线编辑，文档协作更加方便
对于经常编写技术文档、项目说明或使用指南的团队，Markdown 是一种常见的文档格式。Local File Hub 支持直接在浏览器中编辑 .md 和 .markdown 文件。用户可以在拥有对应权限的情况下打开文档、修改内容并保存，无需先下载到本地再重新上传。此外，平台还提供 Markdown 导出 PDF 功能。导出的 PDF 可以逐页添加身份水印，方便用于文档留存和资料分发。
07｜用户管理与活动审计，让管理过程有迹可循
对于团队文件共享平台，除了文件本身，管理者还需要了解账号与操作情况。Local File Hub 提供完整的基础用户管理功能。管理员可以创建用户、启用或停用账号、重置密码、修改角色，以及配置个人存储配额。平台还支持一次性邀请码注册。管理员可以提前配置邀请码对应的权限，由受邀成员完成注册后自动获得相应授权。如果不希望任何人自行创建账号，也可以关闭开放注册，仅允许通过邀请码加入。
在活动审计方面，平台可以记录：
用户登录、文件上传和下载、文件修改、权限调整、公开分享创建与访问，以及其他重要管理操作。管理员可以根据操作类型、用户、时间和关键词筛选审计记录，并将结果导出为 CSV 文件。通过这些能力，管理者能够更方便地了解文件使用和权限变更情况。审计日志采用尽力写入机制，不属于不可篡改的合规审计存储。
08｜本地存储与数据备份，降低部署复杂度
Local File Hub 没有引入复杂的分布式存储架构。平台采用 SQLite 保存用户、文件元数据、权限、分享链接和活动日志等信息。真正的文件内容则保存在服务器本地对象目录中。这种设计将文件数据与管理信息分离，既保持了单节点部署的简洁性，也方便进行数据迁移与备份。当前版本提供内置备份脚本。执行备份时，系统会生成 SQLite 一致性快照，并归档对应的文件对象目录。默认保留最近七份备份。需要特别注意，完整恢复必须同时保留数据库和文件对象，两者缺一不可。对于重要数据，仍然建议定期将备份复制到独立存储设备，并开展恢复验证。
09｜浏览器访问，也可以安装成应用
Local File Hub 采用响应式 Web 界面，支持不同尺寸的屏幕。用户既可以通过浏览器访问，也可以在支持的环境中将网站安装为 PWA 应用。安装后，可以通过独立应用窗口打开文件共享站，不必每次手动输入访问地址。PWA 主要用于提供接近桌面应用的访问体验。当前版本默认只缓存应用运行所需的静态资源，不会自动将受保护文件、下载内容或大体积媒体保存到浏览器。因此，离线打开应用界面，并不意味着能够离线浏览服务器文件。
10｜多种部署方式，满足不同使用环境
Local File Hub 采用 Node.js + Fastify + React 架构。生产环境中，由同一个 Node.js 服务提供 API 和前端页面，不需要额外运行独立的前端服务。目前支持以下部署方式：
Docker 部署
适合 Linux 服务器、NAS 和其他支持 Docker 的设备。
Windows 服务部署
可通过项目提供的安装脚本，将应用注册为 Windows 服务，便于长期运行和日常管理。
Node.js 手动部署
适合希望自行管理进程、目录和运行环境的开发者。
HTTPS 反向代理部署
可配合 Nginx 或 Caddy，在正确配置证书、访问限制和代理参数后，对外提供 HTTPS 访问。
对于个人和小型团队而言，可以根据现有设备和网络环境选择合适的部署方式。