MockAddress – 真实随机美国免税州地址生成器，纯前端零后端

 

今天给大家介绍一款非常实用的开源测试数据工具 —— MockAddress Core，这是真实随机美国免税州地址生成器的前端核心引擎，纯 JavaScript、零后端依赖，支持 10+ 国家/地区地址格式，可在 Google Maps / Apple Maps 验证，适合开发测试、表单验证、跨境电商等场景。

 

 

项目概述

 

MockAddress Core（GitHub）是一款纯前端、零后端依赖的测试数据引擎，专为开发者和 QA 工程师设计。它提供：

 

  • 真实格式地址数据，符合官方邮政标准（可在 Google Maps / Apple Maps 验证）
  • 可选的身份字段 + 信用卡字段（仅用于表单/支付流程测试）
  • MAC 地址生成 + 厂商查询 + IPv6 Link-Local 推导等网络测试数据

 

所有核心逻辑完全在浏览器端运行，可直接部署到 GitHub Pages、Cloudflare Pages、Vercel 等静态托管环境。

 

  • 生产站点：https://mockaddress.com/
  • 许可证：MIT

 

 

核心特性

 

  • 多国家/地区地址生成：美国、香港、英国、加拿大、日本、印度、台湾、新加坡、德国等 10+ 国家/地区
  • 美国免税州地址：支持俄勒冈、特拉华等免税州格式
  • 真实格式 & 可验证：基于官方邮政数据 + OpenStreetMap，生成结果可在地图服务中验证
  • 可选身份 & 信用卡字段：姓名、性别、生日、职业、身份证号格式；信用卡号（Luhn 校验）、有效期、CVC（仅测试用）
  • MAC 工具：多种格式 MAC 地址、OUI 厂商识别、IPv6 Link-Local 推导
  • 批量导出：CSV / JSON 导出，适合自动化测试、CI/CD
  • 纯前端、隐私优先：不依赖后端，可选 localStorage 本地保存，服务器不存储任何数据

 

 

快速开始

 


import { generateTaxFreeAddress } from './src/js/address-generator.js';

// 生成俄勒冈州（免税州）地址
const address = await generateTaxFreeAddress('OR');
console.log(address);
// 输出: { street: "123 Main St", city: "Portland", state: "OR", zip: "97201", ... }

 

 

部署方式

 

纯静态站点，无需后端：

 

  • Cloudflare Pages：绑定 Git 仓库，框架预设选 None，输出目录为项目根目录
  • VPS + Nginx：上传静态文件到 /var/www/mockaddress-core，配置 try_files 即可
  • 本机离线：使用 Python / PHP / Node.js 启动本地 HTTP 服务，双击 start-local-server.bat 即可

 

 

适用与不适用场景

 

适用：软件开发测试、表单验证、跨境电商地址流程模拟、UI/UX 原型、教学演示、网络测试（MAC 工具）

 

不适用：真实邮寄地址、长期实名注册、规避 KYC/风控、一切违法或灰色用途

 

 

隐私与安全

 

  • 纯前端运行，不依赖后端服务
  • 生成数据可仅保存在浏览器 localStorage，服务器不存储
  • 身份/信用卡数据为随机生成，不对应任何真实个人或卡片
  • MIT 开源协议，可自由使用与二次开发

 

 

资源下载

 

  • GitHub：https://github.com/hotbob011/real-random-taxfree-address
  • 生产站点：https://mockaddress.com/
  • 许可证：MIT