address

用真实开放数据一键生成27国测试地址

开源 unknown 数据集

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2225

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类数据集

开发团队daimon3332

所属国家

官网地址https://address.daimonna.com

GitHubhttps://github.com/daimon3332/address

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型address,address-generation,address-generator,mock-data,mock-data-generator

GitHub 星标★ 2225

30天Star增速

HF 下载量

上线时间2026-07-15 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-20

浏览次数1

项目介绍

address 是一个自托管的地址与合成测试资料生成器，基于真实开放数据（街道、行政区划、坐标、邮编）构建，覆盖 27 个国家和地区。它主要解决开发测试中需要大量真实感地址数据的问题：传统假数据往往格式失真、地区单一，而真实数据又涉及隐私和合规。项目提供多语言地址输出、根据 IP 位置生成附近地址、地图预览以及 API 调用能力，可作为独立服务部署在本地或内网。核心能力包括：按国家/地区生成结构化地址字段，生成配套的合成测试资料（如姓名等），支持通过 API 批量获取数据，并能在页面上直观预览地址对应的地图位置。适合需要地址测试数据、地理围栏测试、表单验证、演示数据填充的开发者和测试团队，数据来源开放、可审计，避免使用真实个人地址。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：Docker 4 步

环境要求

已安装 Docker Engine 与 Docker Compose 插件
服务器可访问 raw.githubusercontent.com 以拉取 Compose 文件
浏览器（用于访问管理控制台，可选）

安装与启动步骤

1创建部署目录

新建并进入专用目录，后续 Compose 文件与服务数据都放在这里，便于统一管理。
```
mkdir address && cd address
```
2下载 Compose 文件

从官方仓库拉取 docker-compose.yml，用 -f 让网络错误时直接失败，避免拿到空文件。
```
curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml
```
3启动服务

在 docker-compose.yml 所在目录执行 Compose 启动，首次运行会拉取镜像，需等待一段时间。
```
docker compose up -d
```
4进入管理控制台

浏览器打开服务的访问地址；端口以 docker-compose.yml 里的端口映射为准，README 未固定具体端口。

如何确认成功

执行 docker compose ps 查看容器为运行状态，并用浏览器打开管理控制台，能看到仪表盘与按国家划分的工作区即启动成功。

常见问题

Q：下载 docker-compose.yml 失败怎么办？

A：先确认服务器能访问 raw.githubusercontent.com；若被网络限制，可在能上网的机器上打开该链接，手动保存为 docker-compose.yml 再上传到部署目录。

Q：服务端口是多少？

A：README 节选中未固定端口，请查看 docker-compose.yml 中的 ports 映射，用宿主机映射端口在浏览器访问。

Q：生成的数据是随机拼凑的吗？

A：不是。每条记录来自官方地址登记库、开放地图数据或经过验证的地理编码结果，并带有来源、精度与坐标信息。

Q：某些地址字段为空是出错了吗？

A：不是。缺失字段会保持为空，项目不会虚构数据；若按地区筛选无数据，接口会直接返回错误而不会自动切换到其他区域。

注意事项

README 节选在快速开始处被截断，启动后的端口、账号与镜像细节请以仓库中的 docker-compose.yml 和完整文档为准。
部署前建议先 review 一遍 docker-compose.yml，确认端口映射、数据卷与凭据配置符合内网安全要求。
数据同步与提供方凭据在管理控制台中配置，勿将凭据硬编码进 Compose 文件或提交到代码仓库。
该项目适合本地或内网自托管，用于表单测试、地址格式校验与物流演示等场景。

核心亮点

基于真实开放街道、行政区划和邮编数据，生成地址格式与地理分布更可信
覆盖 27 个国家和地区，支持多语言输出，适合国际化产品测试
提供 IP 附近地址生成、地图预览和 API 调用，集成方式灵活

不足之处

仅覆盖 27 个国家和地区，未覆盖的地区无法使用
项目以 JavaScript 实现，大规模数据生成时性能和内存占用需自行评估

适用场景

国际化产品的地址表单自动化测试与数据填充
本地化演示环境需要真实感用户地址数据
基于 IP 的地理位置相关功能（如附近门店、配送范围）测试

替代项目

Faker.js、Mockaroo

上一篇：datamimic

下一篇：没有了！