sverhoeven/cartodb

docker-cartodb镜像说明

镜像概述

该Docker镜像提供了一个完全可用的CartoDB开发解决方案，无需复杂的安装步骤即可快速启动CartoDB服务，适用于开发者进行CartoDB应用的开发、测试和学习。

核心功能

• 快速部署：通过简单命令启动服务，默认提供dev/pass1234和admin4example/pass1234测试账号。
• 自定义主机名：支持通过-h参数或CARTO_HOSTNAME环境变量设置主机名。
• 数据持久化：可挂载PostgreSQL数据目录到本地，确保容器重启后数据不丢失。
• 地理编码器支持：内部地理编码器已配置，可通过脚本填充数据（外部地理编码器需自行配置API密钥）。

使用场景

• 开发和测试基于CartoDB的地理信息应用。
• 学习CartoDB的功能和使用方法。
• 快速搭建临时的CartoDB演示环境。

配置说明

基本运行命令

bash
docker run -d -p 80:80 -h cartodb.localhost sverhoeven/cartodb

启动后访问http://cartodb.localhost，使用默认账号登录（dev/pass1234或admin4example/pass1234）。

主机名配置

1. 修改本地hosts文件添加解析：

   bash
   sudo sh -c 'echo 127.0.1.1 cartodb.localhost >> /etc/hosts'  # Linux/macOS
   # Windows: 修改C:\Windows\System32\drivers\etc\hosts，添加127.0.1.1 cartodb.localhost
   

2. 使用自定义主机名：

   bash
   docker run -d -p 80:80 -h cartodb.example.com sverhoeven/cartodb
   # 或用环境变量
   docker run -d -p 80:80 -e CARTO_HOSTNAME=cartodb.example.com sverhoeven/cartodb
   

数据持久化

1. 复制容器内PostgreSQL数据到本地：

   bash
   docker create --name cartodb_pgdata sverhoeven/cartodb
   docker cp cartodb_pgdata:/var/lib/postgresql $PWD/cartodb_pgdata
   docker rm -f cartodb_pgdata
   

2. 启动带持久化数据的容器：

   bash
   docker run -d -p 80:80 -h cartodb.example.com -v $PWD/cartodb_pgdata:/var/lib/postgresql sverhoeven/cartodb
   

地理编码器数据填充

内部地理编码器默认无数据，执行以下命令填充：

bash
docker exec -ti <容器ID> bash -c /cartodb/script/fill_geocoder.sh

注意：此操作需约13.5GB磁盘空间，用于下载和导入数据。

镜像构建方法

bash
git clone https://github.com/sverhoeven/docker-cartodb.git
docker build -t=sverhoeven/cartodb docker-cartodb/

构建基于CartoDB GitHub仓库master分支，代码更新可能需调整依赖。