Kleo Static files

在子域名上托管静态文件,支持可选身份验证。用于在专用子域名上提供HTML、图片、CSS、JS等静态内容。支持文件上传、基本认证、配额管理及Caddy自动SSL。命令:sf sites(创建/列表/删除)、sf upload(文件/目录)、sf files(列表/删除)。

安装

概览

Kleo Static Files 是一个专为开发者设计的静态文件托管工具,通过在专用子域名上快速部署 HTML、图片、CSS、JavaScript 等静态资源,简化了前端项目的发布流程。该服务支持自动化的 HTTPS 配置,利用 Caddy 服务器实现 SSL 证书的自动签发与续期,确保所有站点均以安全连接对外提供服务。用户可以通过简洁的命令行界面或 RESTful API 管理多个静态站点,适用于文档网站、个人作品集、内部工具页面等多种场景。其核心优势在于无需手动配置 Web 服务器或 DNS 记录,即可实现一键创建、上传和访问静态内容。此外,Kleo Static Files 提供了灵活的认证机制,允许为特定站点启用基本身份验证,从而保护敏感文件或私有数据。整体架构轻量高效,适合个人开发者、小型团队及企业内部使用,尤其适合需要频繁更新静态资源但缺乏运维资源的场景。

核心功能特点

  1. 在 *.{domain} 子域名上自动托管静态文件并启用 HTTPS
  2. 支持命令行批量上传文件和目录,支持覆盖已有文件
  3. 可为每个站点设置基本身份验证,保护私有内容访问
  4. 提供配额管理和文件大小限制(默认 50MB/站点)
  5. 内置统计接口,可查看全局或单个站点的存储使用情况
  6. 通过 RESTful API 实现自动化集成,便于 CI/CD 流程对接

适用场景

Kleo Static Files 特别适合需要快速部署静态内容的开发者和运维人员。例如,当你在构建一个技术文档网站时,可以使用 `sf sites create docs` 创建一个专属子域名如 docs.yourdomain.com,随后将编译后的静态文件通过 `sf upload ./build docs` 推送上去,整个过程在几秒内完成,且自动获得 HTTPS 支持。对于内部使用的报表系统或临时分享链接,你可以为该站点启用密码保护,仅授权用户可通过用户名密码访问,既保证了安全性又避免了复杂的前端鉴权逻辑。另一个典型应用场景是持续集成环境中自动发布前端项目:每次代码合并后,CI 脚本调用 Kleo CLI 上传新版本到指定站点,实现零配置部署。此外,由于每个站点独立分配存储空间(默认 100MB),它也适合作为轻量级 CDN 替代品,用于分发大体积资源包或离线安装包。无论是个人博客、开源项目主页,还是企业内网工具页面,Kleo Static Files 都能以极简方式满足高频次、低延迟的静态内容交付需求。