hsldevcom/hsl-timetable-container

HSL时刻表PDF数据容器

1. 镜像概述

HSL时刻表PDF数据容器是一个预打包了赫尔辛基地区交通局（HSL）时刻表PDF文件的Docker镜像，旨在为开发、测试及生产环境提供标准化、易于访问的交通时刻表数据存储方案。该镜像可作为独立数据卷容器或静态资源提供方，简化依赖HSL时刻表数据的应用集成流程。

2. 核心功能与特性

2.1 数据完整性

• 包含最新的HSL官方时刻表PDF文件，定期更新以确保数据时效性
• 数据经过校验，确保文件完整性和可用性

2.2 标准化存储结构

• 采用统一的目录结构组织不同线路、站点的时刻表PDF文件，便于按规则检索
• 文件命名遵循HSL官方规范，降低集成复杂度

2.3 灵活的访问方式

• 支持作为数据卷挂载至其他容器，提供直接文件访问
• 可配合Web服务器容器（如Nginx）实现HTTP/HTTPS访问（需额外配置）

3. 使用场景

3.1 开发与测试环境

• 为依赖HSL时刻表数据的应用提供一致的测试数据源，避免本地文件版本不一致问题

3.2 应用集成

• 作为交通信息类应用的后端数据存储，简化数据获取逻辑
• 与行程规划、公共交通查询服务集成，提供离线时刻表支持

3.3 服务部署

• 在生产环境中作为静态资源容器，为前端应用提供稳定的时刻表PDF文件访问

4. 使用方法与配置说明

4.1 基本使用（数据卷模式）

将镜像作为数据卷容器，供其他应用容器挂载访问：

bash
# 运行数据容器
docker run -d --name hsl-timetable-data docker.xuanyuan.run/hsl-timetable-pdf-data

# 在其他容器中挂载使用
docker run --rm --volumes-from hsl-timetable-data docker.xuanyuan.run/my-app:latest ls /data/timetables

4.2 本地数据持久化

将容器内数据同步至本地目录，实现数据持久化：

bash
docker run -d --name hsl-timetable-data -v /local/path/to/timetables:/data docker.xuanyuan.run/hsl-timetable-pdf-data

4.3 数据更新

如需获取最新时刻表数据，可通过以下方式更新容器：

bash
# 拉取最新镜像
docker pull docker.xuanyuan.run/hsl-timetable-pdf-data

# 停止并删除旧容器
docker stop hsl-timetable-data && docker rm hsl-timetable-data

# 启动新容器
docker run -d --name hsl-timetable-data docker.xuanyuan.run/hsl-timetable-pdf-data

4.4 配置参数

该镜像暂无额外配置参数，所有时刻表数据预置于容器内/data目录下，文件结构如下：

/data
├── bus/          # 公交时刻表PDF
├── metro/        # 地铁时刻表PDF
├── tram/         # 电车时刻表PDF
└── train/        # 火车时刻表PDF

5. 注意事项

• 镜像内数据定期更新，建议通过官方渠道获取最新镜像版本以确保数据时效性
• 作为数据容器使用时，建议配合--read-only参数增强安全性（需确保挂载路径可写）
• 如需大规模访问，建议结合CDN或负载均衡服务优化性能