Darkhttpd Docker镜像文档

镜像概述

Darkhttpd Docker镜像是基于Darkhttpd构建的轻量级静态HTTP服务器镜像，主要用于提供静态文件的HTTP访问服务。Darkhttpd本身是一款超小型、高性能的静态HTTP服务器，该镜像基于scratch基础镜像构建，具有极小的体积，适合资源受限环境或对轻量化有需求的场景。

核心特性

• 超小体积：基于scratch镜像构建，最大限度减小镜像体积，降低资源占用。
• 静态文件服务：专注于提供静态文件（如HTML、CSS、JS、图片等）的HTTP访问能力。
• 简单易用：无需复杂配置，通过挂载本地目录即可快速启动服务，减少部署成本。

使用场景

• 个人静态网站托管：适用于搭建个人博客、作品集等静态内容网站。
• 静态文档服务：可用于托管API文档、产品手册、项目说明等静态文档（如通过Markdown生成的HTML文档）。
• 轻量级资源服务：作为前端静态资源（如JS、CSS、图片）或下载文件的简易服务器。
• 开发测试环境：在开发过程中快速搭建静态文件服务，用于测试前端页面或静态资源访问。

使用方法

快速启动

通过docker run命令直接启动容器，挂载本地静态文件目录到容器默认文档根目录：

shell
docker run -d \
  --name darkhttpd \
  --restart unless-stopped \
  -p 80:80 \
  -v ~/website:/var/www/htdocs:ro \
  kimi360/darkhttpd:latest

参数说明：

• -d：后台运行容器。
• --name darkhttpd：指定容器名称为darkhttpd。
• --restart unless-stopped：除非手动停止，否则容器退出时自动重启。
• -p 80:80：将主机80端口映射到容器80端口（容器内默认HTTP端口）。
• -v ~/website:/var/www/htdocs:ro：挂载本地~/website目录到容器/var/www/htdocs（默认文档根目录），ro表示只读权限。
• kimi360/darkhttpd:latest：使用最新版本的Darkhttpd镜像。

Docker Compose配置

通过docker-compose.yml文件定义服务，便于管理和扩展：

yaml
version: '3'
services:
  darkhttpd:
    image: kimi360/darkhttpd:latest
    container_name: darkhttpd
    restart: unless-stopped
    ports:
      - 80:80  # 端口映射：主机端口:容器端口
    volumes:
      - ~/website:/var/www/htdocs:ro  # 挂载本地静态文件目录

启动服务：

shell
docker-compose up -d

配置说明

文档根目录

容器内默认文档根目录为/var/www/htdocs，必须通过-v参数挂载本地静态文件目录到该路径，否则服务无内容可提供。挂载时建议使用ro（只读）权限，增强安全性。

端口映射

容器内默认监听80端口，可通过-p <主机端口>:80映射到主机其他端口（如-p 8080:80将服务暴露在主机8080端口）。

重启策略

建议使用--restart unless-stopped（Docker run）或restart: unless-stopped（Docker Compose）确保服务在意外退出后自动恢复。

引用与协议

引用项目

• Darkhttpd ***项目
• Dockerfile 源码

许可协议

本镜像遵循MIT 许可协议。