taosnet/hiawatha

镜像概述

本镜像提供快速创建Hiawatha服务器的基础框架，支持自动集成Let's Encrypt证书、反向代理功能，以及通过docker exec修改站点配置的实用工具。镜像未预装PHP，若需使用PHP可通过apk安装php5-fpm。

核心功能

• 自动集成Let's Encrypt证书，支持SSL加密
• 作为反向代理，为web应用提供应用级防火墙保护
• 通过环境变量配置站点属性
• 提供addSite、setupSSL等实用工具简化配置
• 支持数据卷挂载，便于管理web应用文件和配置

使用场景

1. 作为应用级防火墙：保护后端应用（如Node.js服务）
2. 数据卷部署：通过挂载卷管理web应用文件
3. 扩展镜像：基于本镜像构建自定义站点镜像

作为应用级防火墙示例

先运行后端应用（如Node.js服务），再启动Hiawatha作为反向代理：

bash
docker run --name mynodeapp -v /path/to/app:/usr/src/app:Z node server.js
docker run --name mysite.com --link mynodeapp:site \
    -p 80:80 -p 443:443 -e HTTP_DOMAIN=mysite.com -e HTTP_PROXY_HOST=site:8080 \
    taosnet/hiawatha

数据卷部署示例

通过挂载卷管理web应用：

bash
docker run --name mysite.com -d -p 80:80 -e HTTP_DOMAIN=mysite.com \
    -v /path/to/webapp:/var/www/mysite.com/public:Z taosnet/hiawatha

默认挂载卷路径：

• /var/www：web应用文件
• /etc/hiawatha/sites.d：站点配置
• /etc/hiawatha/tls：证书文件

扩展镜像示例

创建Dockerfile：

dockerfile
FROM taosnet/hiawatha
RUN /usr/bin/addSite mysite.com
COPY webapp /var/www/mysite.com/public

构建并运行：

bash
docker build -t taosnet/mysite .
docker run --name mysite.com -d -p 80:80 taosnet/mysite

配置说明

Let's Encrypt SSL配置

若/etc/hiawatha/tls目录存在privkey.pem、cert.pem、chain.pem文件，镜像会自动构建Hiawatha兼容证书并启用SSL。新增站点会自动要求TLS，已存在站点需手动配置。

Certbot获取证书示例

bash
# 运行基础容器
docker run --name mysite.com -d -p 80:80 -p 443:443 -e HTTP_DOMAIN=mysite.com \
    -v webroot:/var/www -v sites:/etc/hiawatha/sites.d -v certs:/etc/hiawatha/tls \
    taosnet/hiawatha

# 获取证书
docker run --rm -v letsencrypt:/etc/letsencrypt --volumes-from mysite.com \
    certbot/certbot certonly --cert-name mysite.com --webroot \
    -w /var/www/mysite.com/public -d mysite.com

# 复制证书到镜像目录
docker run --rm -v letsencrypt:/etc/letsencrypt --volumes-from mysite.com \
    busybox cp -L \
        /etc/letsencrypt/live/mysite.com/privkey.pem \
        /etc/letsencrypt/live/mysite.com/cert.pem \
        /etc/letsencrypt/live/mysite.com/chain.pem \
        /etc/hiawatha/tls/

# 重启容器生效
docker restart mysite.com

环境变量

• HTTP_DOMAIN：站点域名，若存在证书则自动启用RequireTLS
• HTTP_PROXY_HOST：反向代理目标地址（如site:8080）
• HTTP_ACCESS_LIST：允许访问的IP列表（默认允许所有），语法参考Hiawatha手册，例如allow 192.168.1.0/24,deny all

实用工具

addSite工具

添加新站点，需重启容器生效：

bash
docker exec -ti mysite.com /usr/bin/addSite [-a 访问列表] [-p 反向代理地址] 域名
# 示例
docker exec -ti mysite.com /usr/bin/addSite -a 'allow 192.168.1.0/24,deny all' images.mysite.com && docker restart mysite.com

setupSSL工具

启用SSL支持，需重启容器生效：

bash
docker exec mysite.com /usr/bin/setupSSL && docker restart mysite.com

近期变更

2018-03-05

• 新增HTTP_ACCESS_LIST环境变量支持
• 新增/var/www、/etc/hiawatha/sites.d、/etc/hiawatha/tls卷，便于通过--volumes-from集成其他工具