Files.md静态托管指南把Web应用发布到GitHub Pages等任意静态服务器【免费下载链接】files.md Private, quiet space for thinking. Simple app for .md files.项目地址: https://gitcode.com/GitHub_Trending/fi/files.mdFiles.md 是一个本地优先local-first的 Markdown 笔记 Web 应用PWA它的整个前端没有构建系统、没有打包步骤入口就是 web/index.html 一个文件。这意味着把web/目录原样拷贝到 GitHub Pages、Nginx、Caddy 或任何一台静态服务器上就能得到一个完整的在线笔记应用。本文是一份面向新手的 Files.md 静态托管教程全程只需要复制文件不写一行后端代码。为什么 Files.md 可以被静态托管很多人以为带同步功能的笔记应用必须依赖后端Files.md 把两者拆开得很干净部分目录运行方式前端 Web 应用web/纯静态文件任意静态服务器可托管同步 / 机器人服务端cmd/server/server.go单个 Go 二进制可选端到端测试tests/开发用与托管无关静态托管时你的笔记通过浏览器的 File System Access API 保存在本地文件夹里数据不出设备隐私性拉满。只有在需要多设备同步时才需要额外启动那个单文件 Go 服务server/sync/webserver.go。第一步获取 Files.md 代码git clone https://gitcode.com/GitHub_Trending/fi/files.md下载完成后只需关注仓库根目录的web/文件夹——里面包含 app.js、files.js、hypermd.js 等全部前端资源。项目坚持无构建系统原则见 README.md 中的前端指南所以你不需要安装 Node.js也不需要npm install。第二步发布到 GitHub Pages3 步点选新建一个用于静态托管的仓库把web/目录内的全部文件上传到该仓库根目录进入仓库的Settings → Pages在 Source 中选择分支并指定刚上传的目录等待一两分钟访问https://你的用户名.github.io/仓库名/即可打开应用。 GitHub Pages 自带 HTTPS非常适合个人知识库托管。首次打开后按浏览器地址栏的安装按钮可以把 Files.md 作为 PWA 装到桌面/主屏幕。第三步部署到 Nginx、Caddy 等任意静态服务器如果你有 VPS 或家里的服务器Files.md 同样适用。以 Nginx 为例核心配置只有三行server { listen 80; root /var/www/files.md/web; # 指向 web 目录即可 index index.html; }Caddy 用户则只需一行site.address { root * /var/www/files.md/web; file_server }。也可以直接运行官方 Docker 镜像Dockerfile 已把web/打进镜像docker compose up # 等价于 make compose_up见 [Makefile](https://link.gitcode.com/i/fcef843a833b3dba5ab5bb20fe9950bb)可选给静态站点加上多设备同步静态托管 数据存在各自设备。想跨设备同步时在 compose.yaml 中把API_URL那一行取消注释再提供一个持久的CERT_DIR用于自动签发 HTTPS 证书重启容器即可。完整的自建服务器流程systemd、Telegram 机器人、数据迁移写在官方文档 docs/your-own-server.md 中make init_server hostuserexample.com salt随机字符串—— 初始化目录与配置make deploy_systemd host你的主机—— 一键构建、上传并部署。同步协议本身很轻量按文件 mtime 比对、追加式日志处理重命名/删除细节可参考 docs/sync-flow.md。托管成功后的快速上手打开应用后先打开本地文件夹选择任意存放.md文件的目录所有修改才会持久化按Cmd/Ctrl Enter打开聊天框像发消息一样丢笔记、任务、待办再点保存到文件归档结构约定见 web/AGENTS.md偶尔按Cmd/Ctrl Shift R强制刷新拉取你更新后的前端代码。静态托管常见问题 FAQ哪些浏览器支持最好Chromium 系Chrome、Edge、Brave 等对 File System Access API 支持最完善。没有服务器能用吗能。纯本地模式下web/甚至可以直接双击index.html打开数据完全留在设备里。需要安装 Go 吗托管静态应用不需要。只有启用同步服务器或 cmd/ 下的辅助脚本如 backlink、shifttime时才需要 Go。如何更新版本拉取仓库最新代码把web/覆盖到服务器上即可无需重新构建。一句话总结Files.md 的web/目录就是一个即拷即用的静态站点——今天就能发到 GitHub Pages明天也能无缝迁到任何静态服务器数据始终是你自己的.md文件。【免费下载链接】files.md Private, quiet space for thinking. Simple app for .md files.项目地址: https://gitcode.com/GitHub_Trending/fi/files.md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
