a11ywatch/cdn-server

elastic-cdn

镜像概述

elastic-cdn 是一款专为 a11ywatch 项目设计的轻量级 CDN（内容分发网络）服务器镜像。它主要用于处理文件的本地存储以及通过 AWS S3 等对象存储桶进行云端备份。此外，该镜像还可无缝集成到处理流水线中，专门用于应对高负载的图像处理任务。

核心功能与特性

• 双模式存储：支持将文件存储在本地磁盘，或同步备份至 AWS S3 等兼容的对象存储桶中。
• 高负载图像处理：可作为图像处理流水线的核心组件，高效处理繁重的图像转换与优化任务。
• 专为 a11ywatch 优化：与 a11ywatch 生态系统深度集成，提供稳定可靠的静态资源分发服务。
• Node.js 驱动：基于 Node.js 构建，具备出色的异步 I/O 性能和扩展性。

使用场景和适用范围

• 无障碍检测平台：作为 a11ywatch 的后端 CDN 服务，存储和分发网页截图、分析报告及相关静态资源。
• 图像流水线处理：在 CI/CD 或后台任务中，作为图像压缩、格式转换和裁剪等重度处理任务的执行节点。
• 混合云存储架构：适用于需要本地缓存加速并结合 S3 进行持久化备份的文件存储场景。

详细使用方法与配置说明

环境变量配置

在 Docker 环境中，通常通过环境变量来配置存储和运行参数（具体变量名可根据项目实际源码进行调整）：

本地开发指南

如果您需要在本地进行二次开发或调试，请按照以下步骤操作：

1. 安装项目依赖：npm install
2. 启动开发服务器：npm run dev

Docker 部署示例

使用 Docker Run 部署

以下命令展示了如何启动一个使用本地存储的 elastic-cdn 容器，并将本地目录挂载用于持久化：

bash
docker run -d \
  --name elastic-cdn \
  -p 3000:3000 \
  -v /path/to/local/storage:/app/storage \
  -e STORAGE_TYPE=local \
  elastic-cdn:latest

若需启用 AWS S3 备份，请注入相应的环境变量：

bash
docker run -d \
  --name elastic-cdn \
  -p 3000:3000 \
  -e STORAGE_TYPE=s3 \
  -e AWS_S3_BUCKET=my-a11ywatch-bucket \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=ap-northeast-1 \
  elastic-cdn:latest

使用 Docker Compose 部署

对于生产环境或需要与其他服务协同工作的场景，推荐使用 docker-compose.yml 进行编排：

yaml
version: '3.8'

services:
  elastic-cdn:
    image: elastic-cdn:latest
    container_name: elastic-cdn
    ports:
      - "3000:3000"
    environment:
      - STORAGE_TYPE=s3
      - AWS_S3_BUCKET=my-a11ywatch-bucket
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - AWS_REGION=ap-northeast-1
    volumes:
      - cdn_local_cache:/app/storage
    restart: unless-stopped

volumes:
  cdn_local_cache:

许可证

本项目的具体授权条款请查阅项目根目录下的 LICENSE 文件。在使用和分发本镜像时，请确保遵守相关许可协议的规定。