daimon3332/address

这是什么？

核心功能

• 01覆盖 27 个国家和地区，筛选条件遵循各国行政层级。
• 02每条地址附带数据来源、匹配精度和坐标。
• 03支持十种显示语言，包括简体中文、繁体中文、日语、韩语及多种欧洲语言。
• 04增量后台同步，带有重试上限和数据源耗尽检测。
• 05提供 Bearer 认证的 API，支持单条与批量生成、地点搜索和地址翻译。
• 06通过单个 Docker Compose 文件部署，首次启动时自动生成内部密钥。

适用场景

• 为结账和注册表单准备测试数据。
• 在多个国家之间校验地址格式。
• 为物流或地图演示生成真实感的地址。
• 通过 API 批量生成地址，用于测试流水线。

快速上手

1. 1

   下载 Docker Compose 文件

   curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml
2. 2

   启动所有服务

   docker compose up -d
3. 3

   检查服务是否就绪

   curl -fsS http://127.0.0.1:8787/api/v1/ready

使用前须知

• !需要 Linux（AMD64 或 ARM64）系统，并安装 Docker Engine 24+ 和 Compose v2。
• !至少需要 4 GB 内存，首次导入大国家数据时建议 8 GB 或更多。
• !上游数据集保留各自的许可证和署名要求。

收录于专题

标签

常见问题

address 是什么？

自托管地址生成器，基于官方登记数据与开放地图数据，返回真实存在的地址，覆盖 27 个国家和地区。 Address 用于生成真实存在的地址，适合表单测试、结账流程测试、地址格式校验和物流演示。每条记录都来自官方地址登记、开放地图数据或经过校验的地理编码结果，并附带数据来源、精度和坐标，缺失的字段保持为空，不会被虚构补全。

address 可以免费使用吗？用的什么许可证？

address 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

address 还在维护吗？

活跃维护中。address 最近一次提交是在 2026年11月4日。

address 适合用来做什么？

为结账和注册表单准备测试数据。 在多个国家之间校验地址格式。 为物流或地图演示生成真实感的地址。 通过 API 批量生成地址，用于测试流水线。

address 怎么安装和运行？

下载 Docker Compose 文件: curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml 启动所有服务: docker compose up -d 检查服务是否就绪: curl -fsS http://127.0.0.1:8787/api/v1/ready

在哪里获取 address？

源代码和安装说明在 GitHub 上：https://github.com/daimon3332/address