vroomvrp/vroom-docker

VROOM Docker镜像

镜像概述和主要用途

该镜像包含运行https://github.com/VROOM-Project/vroom-express%EF%BC%88%E5%9F%BA%E4%BA%8Ehttps://github.com/VROOM-Project/vroom%EF%BC%89%E6%89%80%E9%9C%80%E7%9A%84%E6%89%80%E6%9C%89%E4%BE%9D%E8%B5%96%E5%92%8C%E9%A1%B9%E7%9B%AE%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8F%AF%E5%9C%A82%E5%88%86%E9%92%9F%E5%86%85%E5%9C%A8%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2%E4%B8%80%E4%B8%AA%E5%8A%9F%E8%83%BD%E5%AE%8C%E5%96%84%E7%9A%84%E8%B7%AF%E7%94%B1%E4%BC%98%E5%8C%96%E5%BC%95%E6%93%8E%E3%80%82

核心功能和特性

• 集成vroom和vroom-express的完整依赖环境
• 支持三种路由引擎：OSRM、Valhalla和OpenRouteService（ORS）
• 提供灵活的配置方式，支持环境变量和配置文件自定义
• 可通过卷挂载实现配置文件和日志的持久化存储
• 提供docker-compose配置，便于快速搭建完整服务栈

使用场景和适用范围

适用于需要路径优化的各类场景，包括但不限于：

• 物流配送路线规划
• 车辆路径优化
• 多站点配送调度
• 基于地理位置的资源分配

使用方法和配置说明

快速启动

使用以下命令快速启动VROOM容器：

bash
docker run -dt --name vroom \
    --net host \  # 或在config.yml中将主机设为容器名称，使用--port 3000:3000替代（见下文）
    -v $PWD/conf:/conf \ # 映射配置和日志的卷
    -e VROOM_ROUTER=osrm \ # 路由层：osrm、valhalla或ors
    vroomvrp/vroom-docker:v1.10.0

构建镜像

如需自行构建镜像，执行以下命令：

bash
docker build -t vroomvrp/vroom-docker:v1.10.0 --build-arg VROOM_RELEASE=v1.10.0 --build-arg VROOM_EXPRESS_RELEASE=v0.9.0 .

注意：需要访问自托管的OSRM、Valhalla或OpenRouteService路由服务器实例，可参考docker-compose.yml示例。

标签说明

镜像标签遵循vroom核心项目的发布约定。

自定义配置

环境变量

• VROOM_ROUTER：指定使用的路由引擎，可选值为osrm、valhalla或ors，默认值为osrm。

路由服务器的预配置主机为localhost，端口分别为：ORS使用8080，OSRM使用5000，Valhalla使用8002。

注意：环境变量VROOM_ROUTER的优先级高于config.yml中的router设置。

卷挂载

容器内所有相关文件位于/conf目录，可通过卷挂载与主机共享，包括：

• access.log：vroom-express的服务器日志
• config.yml：服务器配置文件，可完全控制vroom-express的配置。修改配置后需执行docker restart vroom重启服务使设置生效。

在docker run命令中添加-v $PWD/vroom-conf:/conf实现卷挂载。

构建参数

如需从源码构建镜像，有两个构建参数可用：

• VROOM_RELEASE：指定容器中安装的VROOM的git分支、提交哈希或发布版本（如v1.10.0）
• VROOM_EXPRESS_RELEASE：指定容器中安装的vroom-express的git分支、提交哈希或发布版本（如v0.9.0）

注意：并非所有版本之间都兼容。

docker-compose使用

项目中包含docker-compose.yml配置文件，便于快速启动服务：

bash
docker-compose up -d

该命令将拉取最新的vroom-docker镜像和最新的openrouteservice镜像。

路由服务器设置

可选择使用https://github.com/Project-OSRM/osrm-backend%E3%80%81https://github.com/valhalla/valhalla%E6%88%96https://github.com/GIScience/openrouteservice%E4%BD%9C%E4%B8%BA%E8%B7%AF%E7%94%B1%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82Docker%E6%88%96docker-compose%E4%B8%AD%E7%9A%84%E5%85%B7%E4%BD%93%E8%AE%BE%E7%BD%AE%E5%8F%96%E5%86%B3%E4%BA%8E%E8%B7%AF%E7%94%B1%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E8%BF%90%E8%A1%8C%E6%96%B9%E5%BC%8F%E3%80%82

本地Docker容器中的路由服务器

如果通过docker run在单独的Docker容器中启动路由层，需将vroom容器加入host网络，添加--net host参数。缺点是需要在主机上分配vroom-express配置的端口。若主机3000端口已被占用，可在config.yml中配置其他端口。

或者，可将两个容器加入私有Docker网络，并在config.yml中将路由服务器主机修改为路由服务器容器名称，然后重启vroom容器。相关概念超出本项目范围。

使用docker-compose启动整个服务栈

确保在vroom服务部分包含network_mode: host，效果等同于在docker run中添加--net host参数。

另一种方案是创建私有Docker网络，服务仅发布运行所需的端口。需在config.yml中将主机修改为docker-compose.yml中定义的服务名称。

远程服务器上的路由服务器

这种情况下，需编辑映射的config.yml，添加路由服务器发布的主机和端口。