Graphistry Caddy 镜像文档

镜像概述

概述

本镜像为Graphistry使用的Caddy公开版本，基于Caddy HTTP服务器构建，包含预加载插件，旨在简化Graphistry相关应用的部署流程。Caddy是一款功能强大的开源Web服务器，以自动HTTPS、HTTP/2支持和简洁配置著称，本镜像通过预加载常用插件，进一步减少用户配置步骤，提升部署效率。

主要用途

作为Graphistry应用生态的配套Web服务器，用于处理HTTP/HTTPS请求、反向代理、静态文件服务等场景，适用于需要快速部署且依赖特定插件的Graphistry相关服务。

核心功能和特性

• 基于Caddy构建：继承Caddy原生功能，包括自动HTTPS（Let's Encrypt证书自动申请与续期）、HTTP/2和HTTP/3支持、反向代理、负载均衡等。
• 预加载插件：集成Graphistry应用所需的常用插件，减少手动安装和配置插件的步骤，确保与Graphistry服务的兼容性。
• 简化部署：开箱即用，无需额外配置即可满足基础Graphistry服务的Web服务器需求，降低部署复杂度。
• 轻量高效：保持Caddy本身轻量级特性，资源占用低，性能优化良好。

使用场景和适用范围

• Graphistry应用部署：适用于开发者或企业部署Graphistry可视化平台、数据分析工具等相关应用时，作为配套Web服务器使用。
• 快速原型开发：需要快速搭建包含必要插件的Web服务环境，验证Graphistry应用功能的场景。
• 生产环境适配：支持生产环境部署，自动HTTPS功能保障服务安全性，满足企业级应用的可靠性要求。

使用方法和配置说明

基本使用

快速启动容器

通过以下命令可快速启动镜像，默认配置下暴露80（HTTP）和443（HTTPS）端口：

docker run -d -p 80:80 -p 443:443 --name graphistry-caddy graphistry/caddy:latest

挂载自定义配置文件

如需自定义Caddy配置，可通过挂载本地Caddyfile覆盖默认配置（Caddy配置文件路径：/etc/caddy/Caddyfile）：

docker run -d \
  -p 80:80 -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  --name graphistry-caddy \
  graphistry/caddy:latest

配置说明

配置文件（Caddyfile）

Caddy通过Caddyfile定义服务规则，示例配置（适用于Graphistry静态文件服务）：

# 绑定域名（替换为实际域名）
graphistry-example.com {
  # 静态文件根目录（容器内路径，可通过-v挂载本地目录）
  root * /usr/share/caddy
  # 启用文件服务器
  file_server
  # 启用目录浏览（可选）
  browse
}

环境变量

支持通过环境变量调整基础配置（具体变量需参考Caddy官方文档及镜像预加载插件要求），例如：

• CADDY_HTTP_PORT：自定义HTTP端口（默认80）
• CADDY_HTTPS_PORT：自定义HTTPS端口（默认443）
• CADDY_ACME_AGREE：自动同意Let's Encrypt服务条款（设置为true启用自动HTTPS）

数据持久化

如需持久化证书、日志等数据，可挂载容器内相关目录：

docker run -d \
  -p 80:80 -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \  # 持久化证书、配置等数据
  -v caddy_config:/config \  # 持久化运行时配置
  --name graphistry-caddy \
  graphistry/caddy:latest

（注：caddy_data和caddy_config为Docker卷，需提前创建或使用docker volume create命令创建）

Docker Compose示例

以下为docker-compose.yml示例，适用于Graphistry服务与本Caddy镜像的联动部署：

version: '3.8'

services:
  caddy:
    image: graphistry/caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    depends_on:
      - graphistry_app  # 假设graphistry_app为Graphistry应用服务
    restart: unless-stopped

  graphistry_app:
    image: graphistry/application:latest  # Graphistry应用镜像
    # 其他Graphistry应用配置...

volumes:
  caddy_data:
  caddy_config:

注意事项

• 确保宿主机端口（80/443）未被占用，或通过自定义端口映射调整。
• 如需使用自动HTTPS，需保证容器可访问互联网，且域名解析正确指向宿主机IP。
• 自定义配置文件时，建议参考Caddy官方文档及Graphistry应用的具体插件需求，确保配置兼容性。