p3terx/darkhttpd

darkhttpd

镜像概述和主要用途

darkhttpd 是一个极简的 HTTP 服务器，旨在提供轻量级、高效的 Web 服务能力。该 Docker 镜像封装了 darkhttpd 服务器，便于用户快速部署，适用于需要简单、低资源消耗的 HTTP 服务场景。

核心功能和特性

• 轻量级设计：极小的二进制体积，启动快速，适合资源受限环境
• 低资源占用：运行时内存和 CPU 消耗低，高效利用系统资源
• 灵活端口配置：支持通过命令行参数自定义服务端口
• IPv6 支持：可启用 IPv6 网络，满足双栈网络环境需求
• 多网络模式兼容：支持 Docker bridge 网络（端口映射）和 host 网络（直接使用主机网络栈）
• 易于使用：通过命令行参数直接配置，无需复杂配置文件

使用场景和适用范围

• 本地开发与测试：快速搭建静态文件服务，验证前端页面或资源
• 静态网站托管：部署个人博客、项目文档等纯静态内容
• 轻量级 Web 应用：运行无复杂依赖的简单 Web 服务
• 资源受限环境：嵌入式设备、低配置服务器或边缘计算场景

详细使用方法和配置说明

基础使用示例（临时运行）

在当前目录启动 HTTP 服务，端口映射到主机 6880，服务结束后自动清理容器：

bash
docker run --rm \
    -v $PWD:/www \  # 将当前目录挂载为容器内服务根目录（/www）
    -p 6880:80 \    # 主机 6880 端口映射到容器 80 端口
    p3terx/darkhttpd /www  # 指定容器内服务根目录为 /www

后台持续运行（bridge 网络）

以后台模式运行，自动重启，并持久化容器名称：

bash
docker run -d \
    --name darkhttpd \  # 容器名称，便于管理
    --restart unless-stopped \  # 容器退出时自动重启（除非手动停止）
    -v $PWD:/www \      # 挂载当前目录到容器 /www
    -p 6880:80 \        # 端口映射：主机 6880 → 容器 80
    p3terx/darkhttpd /www  # 服务根目录为 /www

host 网络模式与 IPv6 配置

使用主机网络模式（直接使用主机网络栈），启用 IPv6 并指定服务端口：

bash
docker run -d \
    --name darkhttpd \
    --network host \    # 使用主机网络，无需端口映射
    --restart unless-stopped \
    -v $PWD:/www \
    p3terx/darkhttpd /www \  # 服务根目录为 /www
        --port 6880 \   # 直接指定服务端口（因使用主机网络，无需映射）
        --ipv6          # 启用 IPv6 支持

查看所有命令行选项

运行容器不带参数，输出完整配置选项列表：

bash
docker run --rm p3terx/darkhttpd

致谢

• 原项目：https://github.com/emikulic/darkhttpd