akamaiesi/ets-docker

Akamai ETS Docker镜像

镜像概述

该容器运行Akamai Edge Side Includes (ESI)测试服务器，基于Ubuntu 14.04系统。ESI是一种动态内容组装技术，可将不同源的网页片段拼接成完整页面。本镜像支持沙箱测试、远程源转发、实时ESI编辑预览等功能，便于开发者在本地验证ESI逻辑的正确性。

核心功能

• 沙箱源: 容器内置Apache服务器，默认提供ESI示例，也可挂载本地ESI文件目录快速测试。
• 远程源: 转发请求到上游服务器，处理来自远程源的ESI代码。
• 实时Playground: 在线编辑ESI代码并即时查看处理结果的工具。
• Edgescape模拟: 提供静态地理信息（如地区、城市、时区等），用于测试基于地理位置的ESI逻辑。
• 调试支持: 启用ESI调试模式，查看内容处理的详细过程。

使用场景

• 本地开发时验证ESI标签的语法和逻辑正确性。
• 模拟不同地理区域用户的ESI内容展示效果。
• 调试远程服务器上的ESI页面问题。
• 快速原型验证复杂ESI拼接逻辑。

配置说明

基础使用

运行ESI服务器、沙箱源和Playground：

bash
docker run -ti -p 8080:80 akamaiesi/ets-docker:latest

• -p 8080:80: 将本地8080端口映射到容器80端口（ETS端口）。
• 访问地址：
  • ETS主页：http://localhost:8080/
  • Playground：http://localhost:8080/playground
  • 沙箱源：http://localhost:8080/sandbox

启用ESI调试（沙箱源）

bash
docker run -ti -p 8080:80 akamaiesi/ets-docker:latest --debug localhost

禁用沙箱源的Edgescape

bash
docker run -ti -p 8080:80 akamaiesi/ets-docker:latest --geo localhost:off

远程源配置（带调试）

bash
docker run -ti -p 8080:80 akamaiesi/ets-docker:latest --remote_origin yoursite.example.com:443 --debug yoursite.example.com

• 访问远程源页面：添加Host: yoursite.example.com请求头，例如：

  bash
  curl -H 'Host: yoursite.example.com' http://localhost:8080/my_page.html
  

后台运行

bash
docker run -d -p 8080:80 akamaiesi/ets-docker:latest

• 停止容器：docker stop <容器ID>（通过docker ps获取ID）。

挂载本地ESI文件

将本地my_esi_pages目录挂载到沙箱源：

bash
docker run -ti -p 8080:80 -v $(pwd)/my_esi_pages:/opt/akamai-ets/virtual/localhost/docs akamaiesi/ets-docker:latest

• 访问：http://localhost:8080/（若挂载到子目录docs/my_esi_pages，则访问http://localhost:8080/my_esi_pages/）。

禁用沙箱或Playground

bash
docker run -ti -p 8080:80 akamaiesi/ets-docker:latest --no_sandbox --no_playground

其他说明

• 状态页面: http://localhost:<ETS端口>/server-status（基于Apache mod_status）。
• 日志查看: 进入容器docker exec -ti <容器ID> bash，日志位于/opt/akamai-ets/logs。
• HTTPS支持: ETS不支持HTTPS入站连接，但可转发到HTTPS远程源（需指定端口443）。

许可协议

Dockerfile及相关代码示例采用Apache License 2.0。容器内产品许可：

• Apache HTTP Server: Apache License 2.0
• Akamai ESI Test Server: Akamai License Agreement
• libcurl: MIT License
• ESI Playground: MIT License