[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-10864":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":36,"discoverSource":37},10864,"hfs","rejetto\u002Fhfs","rejetto","HFS is a web file server for your computer. Share folders or even a single file thanks to the virtual file system.","",null,"TypeScript",3747,353,50,17,0,2,7,53,6,29.65,"GNU General Public License v3.0",false,"main",true,[27,28,29,30,31,32],"file-server","file-sharing","http-server","nodejs","typescript","web","2026-06-12 02:02:27","# HFS: HTTP File Server\n\n![logo and motto](hfs-logo-color-motto.svg)\n\n## Index\n\n- [Introduction](#introduction)\n- [How does it work](#how-does-it-work)\n- [Features](#features)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Internationalization](#internationalization)\n- [Hidden features](#hidden-features)\n- [Contribute](#contribute)\n- [More](#more)\n\n## Introduction\n\nTurn your computer into a file-sharing server in seconds.\n\n* **Unlimited space and bandwidth** — no cloud upload, files come directly from your disk\n* **Instant ZIP downloads**, even for huge folders\n* **Virtual file system** to organize what you share\n* **Real-time activity monitoring**\n* **Bandwidth throttling** to control transfer speed\n* **Plugin system** to extend functionality\n\nRuns on: Windows, Linux, macOS, FreeBSD, Android\n\n## How does it work\n\n- run HFS on your computer; an administration webpage automatically shows up\n- select which files and folders you want to be accessible\n- access those files from a phone or another computer just using a browser\n- possibly create accounts and limit access to files\n\n## Features\n\n- https\n- easy certificate generation\n- virtual file system\n- mobile friendly\n- search\n- accounts\n- resumable downloads & uploads\n- download folders as zip archive\n- delete, move and rename files\n- plug-ins (anti-brute-force, thumbnails, ldap, themes, and more)\n- simple website serving\n- real-time monitoring of connections\n- [show some files](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fdiscussions\u002F270)\n- speed throttler\n- geographic firewall\n- admin web interface\n- multi-language front-end\n- virtual hosting\n- [reverse-proxy support](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FReverse-proxy)\n- comments in file descript.ion\n- integrated media player\n- [customizable with html, css, and javascript](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FCustomization)\n- dynamic-dns updater\n\n## Installation\n\nFor Docker, see https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FDocker . \n\nFor service installation, see https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FService-installation.\n\nFor Homebrew, just `brew install rejetto\u002Fhfs\u002Fhfs`\n\nThe minimum Windows version required is 10 or Server 2019.\n\n1. Download the zip file for your operating system from https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Freleases\n   - ⚠️ Antivirus problems on Windows? [READ THIS](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FAntivirus)\n   - ⚠️ If you have Linux ARM or other unlisted\u002Funsupported platforms, please see the [Other systems](#other-systems) section.\n2. Unzip and launch the `hfs` file.\n   - ⚠️ Mac: if you get *\"cannot be opened because it is from an unidentified developer\"*,\n     you can hold `control` key while clicking, then click `open`.\n3. The browser should automatically open at `localhost`, so you can configure the rest in the Admin-panel.\n\nTroubleshooting\n   - If a browser cannot be opened on the computer where you are installing HFS, \n     you should enter this command in the HFS console: `create-admin \u003CPASSWORD>`\n   - If you cannot access the console (like when you are running as a service), \n       you can [edit the config file to add your admin account](config.md#accounts)\n   - If you don't want to use an editor, you can create the file with this command: \n     \n     `echo \"create-admin: PASSWORD\" > config.yaml` \n\nBy default, HFS does not require a login when you access the *Admin-panel* from localhost.\nIf you don't like this behavior, disable it in the Admin-panel or enter this console command `config localhost_admin false`.\n\nTo uninstall, remove the files you unzipped and the configuration\u002Fdata directory (see `config.md` for the location).\n\n### Other systems\n\nIf you can't or don't want to run our binary versions, you can try this:\n\n1. [Install Node.js](https:\u002F\u002Fnodejs.org) version 18 to 24\n2. Run at the command line `npx hfs@latest`\n\nThe `@latest` part is optional, and ensures that you are always up to date.\n\nIf this procedure fails, it may be that you are missing one of [these requirements](https:\u002F\u002Fgithub.com\u002Fnodejs\u002Fnode-gyp#installation).\n\nConfiguration and other files will be stored in `%HOME%\u002F.vfs`\n\n## Configuration\n\nFor configuration please see [config.md](config.md); it explains also where all configurations are stored.\n\n## Internationalization\n\nIt is possible to show the Front-end in other languages.\nTranslation for some languages is already provided. If you find an error, consider reporting it\nor [editing the source file](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Ftree\u002Fmain\u002Fsrc\u002Flangs). \n\nIn the Languages section of the Admin-panel you can install additional language files.\n\nIf your language is missing, please consider [translating yourself](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FTranslation). \n\n## Hidden features\n\n- Append `#LOGIN` to the URL to open the login dialog\n- Append `?lang=CODE` to the URL to force a specific language\n- `Right-click` on toggle-all checkbox to *invert* the state of all checkboxes\n- Append `?login=USER:PASSWORD` to automatically log in to the browser\n- Append `?search=PATTERN` to trigger a search on startup\n- Append `?onlyFiles` or `?onlyFolders` to limit the type of results\n- Append `?get=basic` to display a basic web interface, intended for older\u002Fsimpler browsers \n  - This is automatic if a basic browser is detected.\n- Append `?autoplay=shuffle` to trigger show & play; `?autoplay` will not shuffle, but also will not start until the list is complete \n- `Right-click` on \"check for updates\" to enter a URL of a version to install\n- `Shift+click` on a file to *show* and play\n- `Ctrl+backspace` to navigate to the parent folder\n- Start typing a filename to focus it in the list\n- `--consoleFile PATH` to also output all stdout\u002Fstderr to a file\n- Set env.var. `DISABLE_UPDATE=1` (for containers)\n- Launch with `--debug` or env.var. `HFS_DEBUG=1` to generate additional console logs \n- Launch with `--no-central` to skip fetching updated info from GitHub (uses built-in data only)\n\n## Contribute\n\nThere are several ways to contribute\n\n- [Report bugs](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fissues\u002Fnew?labels=bug&template=bug_report.md)\n\n  It's very important to report bugs, and if you are not so sure about it, don't worry, we'll discuss it.\n  If you find important security problems, please [contact us privately](mailto:a@rejetto.com) so that we can publish a fix before\n  the problem is disclosed, for the safety of other users.  \n\n- Use beta versions, and give feedback. \n\n  While betas have more problems, you'll get more features and give a huge help to the project. \n\n- [Translate to your language](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FTranslation).\n\n- [Suggest ideas](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fdiscussions)\n\n  While the project should not become too complex, yours may be an idea for a plugin.\n\n- Write guides or make videos for other users. [We got a wiki](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki)! \n\n- Submit your code\n\n  If you'd like to make a change yourself in the code, please first open an \"issue\" or \"discussion\" about it,\n  so we'll try to cooperate and understand what's the best path for it.\n\n- [Make a plugin](dev-plugins.md)\n\n  A plugin can change the look (a theme), and\u002For introduce a new functionality.\n\n## Code Signing Policy\n\nFree code signing 🙏 provided by SignPath.io, certificate by [SignPath Foundation](https:\u002F\u002Fsignpath.org).\n\nAuthor\u002FReviewer\u002FApprover: Massimo Melina.\n\nPrivacy: Update checks are opt-out; other outbound connections are user-triggered.\n\n## More\n\n- [Additional information (Wiki)](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki)\n\n- [APIs](https:\u002F\u002Fgithub.com\u002Frejetto\u002Fhfs\u002Fwiki\u002FAPIs)\n\n- [Build yourself](dev.md)\n\n- [License](LICENSE.txt)\n\n- Flag images under MIT license from https:\u002F\u002Fwww.freakflagsprite.com\n","HFS是一个用于计算机的Web文件服务器，允许用户通过虚拟文件系统分享文件夹或单个文件。它采用TypeScript编写，支持HTTPS、即时ZIP下载、带宽限制等功能，并具有插件扩展能力，能够满足多种自定义需求。HFS还提供了实时活动监控、账户管理等高级特性，确保数据安全的同时也便于管理。此项目适用于需要快速搭建个人或小型团队文件共享服务的场景，无论是家庭网络还是办公环境都能轻松部署使用。支持跨平台运行（Windows, Linux, macOS, FreeBSD, Android），安装简便快捷。","2026-06-11 03:30:32","top_topic"]