idealpostcodes/postcodes.io.db

postcodes.io.db Docker镜像文档

镜像概述

postcodes.io.db是postcodes.io项目的数据库镜像，基于PostgreSQL构建并集成PostGIS空间扩展。该镜像专门用于存储和管理英国邮政编码及相关地理数据，包括ONS Postcode Directory（英国国家统计局邮政编码目录）和Ordnance Survey Open Names（英国 Ordnance Survey 开放名称）数据集，为postcodes.io应用提供数据支持。

核心功能与特性

• 数据存储：存储完整的英国邮政编码数据，包含行政区域信息（如区县、地区）、地理位置坐标（经纬度）及终止邮政编码记录。
• 空间扩展：集成PostGIS，支持地理空间查询，满足反向地理编码、邻近邮政编码搜索等空间相关功能需求。
• 数据集集成：定期同步并预加载ONS Postcode Directory和Ordnance Survey Open Names官方数据集。
• 兼容性：专为postcodes.io应用设计，与postcodes.io应用镜像（idealpostcodes/postcodes.io）无缝配合。

使用场景

• 自托管部署：在本地或私有环境中搭建postcodes.io服务时，作为数据库组件提供数据存储与查询支持。
• 开发与测试：开发者构建基于英国邮政编码数据的应用时，用于本地测试和功能验证。
• 数据研究：需要离线访问英国邮政编码及地理数据的学术或商业研究场景。

使用方法与配置

前提条件

• 安装Docker和Docker Compose。
• 确保本地端口（默认5432）未被占用，或通过配置修改端口。

镜像获取

从Docker Hub拉取镜像：

bash
docker pull idealpostcodes/postcodes.io.db

独立运行容器

bash
docker run -d \
  --name postcodes-db \
  -p 5432:5432 \
  -v postcodes-data:/var/lib/postgresql/data \
  idealpostcodes/postcodes.io.db

与应用镜像配合使用（Docker Compose）

创建docker-compose.yml文件，配置应用与数据库服务：

yaml
version: '3'
services:
  db:
    image: idealpostcodes/postcodes.io.db
    volumes:
      - postcodes-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=your_password
      - POSTGRES_USER=postcodes
      - POSTGRES_DB=postcodes
    ports:
      - "5432:5432"
  api:
    image: idealpostcodes/postcodes.io
    depends_on:
      - db
    environment:
      - DB_HOST=db
      - DB_USER=postcodes
      - DB_PASSWORD=your_password
      - DB_NAME=postcodes
    ports:
      - "3000:3000"
volumes:
  postcodes-data:

启动服务：

bash
docker-compose up -d

环境变量配置

许可证

本镜像基于MIT许可证开源，详见https://github.com/ideal-postcodes/postcodes.io/blob/master/LICENSE%E3%80%82