📖 前言

本项目提供一键 Docker 部署，能根据 IP 来源或指定 IP 生成符合本地格式的姓名、街道、城市、邮编等“真实感”地址，并内置临时邮箱用于接收验证码或一次性邮件，方便开发与测试。
⚠️ 仅限开发、测试与隐私保护场景使用，禁止用于欺诈或违法行为。

🌟 功能特点

地址生成

  • 自动检测当前 IP 生成
  • 支持手动输入 IP 或自选地区
  • 输出完整随机身份信息（姓名、电话、国家、省/州、城市、邮编、SSN 等）

地址管理

  • Google 地图显示生成地址
  • 一键复制信息
  • 保存、搜索、删除地址
  • 导出 TXT 文件

内置临时邮箱

  • 可接收验证码或一次性邮件，便于测试

🔗 Demo

⚙️ 部署方法

准备条件

  1. 一台服务器（VPS 或 NAS，内存占用 < 60M）
  2. 域名（需配置 SSL 才能复制信息）
  3. Docker 与 Docker Compose 环境

① 安装 Docker 与 Compose

一键安装脚本

bash
# Docker
bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

# Docker Compose
curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" \
-o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

② 创建项目目录与配置文件

bash
mkdir ip-geoaddress-generator && cd ip-geoaddress-generator
vim docker-compose.yml

写入以下内容：

yaml
services:
  ip-geoaddress-generator:
    image: guoogaii/ip-geoaddress-generator:latest
    ports:
      - "3050:3000"   # 宿主机 3050 → 容器 3000
    environment:
      - TZ=Asia/Shanghai
    restart: always

③ 启动容器

bash
docker-compose up -d
docker-compose ps

正常启动示例：

NAME                                                IMAGE                                     STATUS          PORTS
ip-geoaddress-generator-ip-geoaddress-generator-1   guoogaii/ip-geoaddress-generator:latest   Up 34 minutes   0.0.0.0:3050->3000/tcp

④ 访问 Web 界面

浏览器打开：

代码

http://服务器IP:3050

若需复制功能，请配置域名与 SSL 证书。

✅ 总结

  • ​轻量​：内存占用 < 60M
  • ​功能全​：地址生成 + 临时邮箱 + 管理导出
  • ​部署快​：一键 Docker Compose 启动
  • ​注意​：需绑定域名并配置 SSL 才能完整使用复制功能

项目地址