abhin4v/hastatic

hastatic

hastatic 是适用于Docker容器的小型Web服务器，专注于静态文件服务场景。

核心功能

• 轻量级：镜像大小仅5MB
• 原生适配Docker环境
• 支持HTTPS加密传输
• 自定义404错误页面
• 自定义目录索引文件
• 屏蔽隐藏文件访问
• 自动添加缓存头优化性能
• 自动注入安全头增强防护
• 缓存文件描述符提升响应速度

使用场景

适用于快速部署静态网站（如个人博客、文档站点、静态资源库），尤其适合Docker化的轻量服务需求。

使用说明

Dockerfile构建示例

基于abhin4v/hastatic创建自定义静态站点镜像：

dockerfile
FROM abhin4v/hastatic:latest
COPY mywebsite /opt/mywebsite
WORKDIR /opt/mywebsite
CMD ["/usr/bin/hastatic"]

运行命令示例

bash
# 构建自定义镜像
$ docker build -t my-static-site .
# 默认配置运行（端口3000映射到8080）
$ docker run -p 8080:3000 my-static-site
# 自定义端口与页面配置
$ docker run -e PORT=2000 -e NF_FILE=404.html -e IDX_FILE=home.html -p 8080:2000 my-static-site
# 启用HTTPS（需提前放置证书文件）
$ docker run -e TLS_CERT_FILE=cert.pem -e TLS_KEY_FILE=key.pem -p 443:3000 my-static-site

配置参数

通过环境变量调整服务行为：

• PORT：服务监听端口，默认3000
• NF_FILE：404错误页面文件名，默认404.html
• IDX_FILE：目录索引文件名，默认index.html
• TLS_CERT_FILE：HTTPS证书文件路径（启用HTTPS必填）
• TLS_KEY_FILE：HTTPS密钥文件路径（启用HTTPS必填）

技术实现

hastatic 基于Haskell编写（仅70行核心代码），底层依赖Warp高性能服务器框架，通过warp-tls实现HTTPS支持。