Eidos项目Docker容器化部署指南

Eidos是一个基于浏览器运行的PWA(渐进式Web应用)项目，类似于Squoosh应用。该项目最初设计为完全在浏览器端运行，不需要服务器支持。但随着用户需求的变化，特别是需要在自定义域名下部署并通过反向代理提供HTTPS访问的场景，项目维护者开发了Docker支持方案。

技术背景

PWA应用虽然主要在客户端运行，但在生产环境中部署时仍需要Web服务器来托管静态资源。Eidos生成的静态文件位于dist目录中，这些文件可以通过任何Web服务器(如Nginx、Caddy等)提供服务。

Docker化方案

项目维护者已经创建了专门的docker-image分支来实现容器化部署。该方案基于Nginx作为Web服务器，主要包含以下关键点：

1. 构建阶段使用Node.js环境编译前端资源
2. 生产阶段使用轻量级Nginx镜像托管静态文件
3. 需要正确配置响应头以确保PWA功能正常工作

部署步骤

1. 克隆项目代码并切换到docker-image分支
2. 构建Docker镜像
3. 运行容器并映射端口
4. 配置反向代理(如Nginx或Caddy)以实现HTTPS和自定义域名

注意事项

部署时需要特别注意响应头的配置，这与PWA的核心功能密切相关。项目中的vercel.json文件包含了必要的头信息配置示例，在自建服务器时需要确保这些配置被正确应用。

未来发展

虽然目前Docker支持已经实现，但项目维护者表示对Docker相关技术不够熟悉，欢迎社区贡献改进。这是一个适合初学者参与的好机会，可以作为进入开源社区的切入点。

对于需要在企业内部网络或特定环境下部署Eidos的用户，Docker方案提供了更灵活的部署选项，同时也便于实现持续集成和自动化部署。