Docksal虚拟主机代理Docker镜像

Docksal的自动化HTTP/HTTPS虚拟主机代理和容器管理工具。

此镜像属于Docksal镜像库的一部分。

特性

• HTTP/HTTPS虚拟主机路由
• 按需启动项目栈（通过HTTP/HTTPS请求触发）
• 闲置指定时间后停止项目栈
• 闲置指定时间后清理项目栈

使用方法

启动代理容器：

docker run -d --name docksal-vhost-proxy --label "io.docksal.group=system" --restart=always --privileged --userns=host \
    -p "${DOCKSAL_VHOST_PROXY_PORT_HTTP:-80}":80 -p "${DOCKSAL_VHOST_PROXY_PORT_HTTPS:-443}":443 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    docksal/vhost-proxy

配置

PROJECT_INACTIVITY_TIMEOUT

定义项目栈在闲置多长时间后停止（例如0.5h）。 默认禁用（设为0）。

PROJECT_DANGLING_TIMEOUT

警告：这是破坏性选项。请自行承担风险！

定义项目栈在闲置多长时间后，其项目栈和代码库将从主机中完全删除（例如168h）。 默认禁用（设为0）。

若要启用清理功能，代理需要访问主机上的项目目录。 创建指向项目存储目录的Docker绑定卷：

docker volume create --name docksal_projects --opt type=none --opt device=$PROJECTS_ROOT --opt o=bind

然后在docker run命令中通过-v docksal_projects:/projects挂载该卷。

示例（中间为额外配置）：

docker run -d --name docksal-vhost-proxy --label "io.docksal.group=system" --restart=always --privileged --userns=host \
    -p "${DOCKSAL_VHOST_PROXY_PORT_HTTP:-80}":80 -p "${DOCKSAL_VHOST_PROXY_PORT_HTTPS:-443}":443 \
    -e PROJECT_INACTIVITY_TIMEOUT="${PROJECT_INACTIVITY_TIMEOUT:-0}" \
    -e PROJECT_DANGLING_TIMEOUT="${PROJECT_DANGLING_TIMEOUT:-0}" \
    -v docksal_projects:/projects \
    -v /var/run/docker.sock:/var/run/docker.sock \
    docksal/vhost-proxy

日志与调试

可通过以下容器环境变量启用各种日志选项（默认禁用）：

ACCESS_LOG - 设为1以启用访问日志。 DEBUG_LOG - 设为1以启用调试日志。 STATS_LOG - 设为1以启用项目统计日志。

使用docker logs docksal-vhost-proxy查看日志。