Docker部署一个基于IP的真实地址生成器-自带临时邮箱

yyzq

2025-10-28 / 0 评论 / 1 点赞 / 21 阅读 / 1,135 字

10/28

前言

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

项目简介

这是一个基于Web的应用程序，可以根据IP地址生成真实的随机地址信息。它使用多个API来获取位置数据和随机用户信息，为您提供一个完整的虚拟身份。

功能特点

1.地址生成

自动检测当前IP地址生成
支持手动输入IP或自选地区生成
生成完整的随机地址信息
- 姓名
- 电话
- 国家
- 省/州
- 城市
- SSN（仅美国地区）

2.地址管理

在Google地图上显示生成的地址
一键复制各项信息
保存、搜索和删除地址
导出保存的地址为TXT文件

demo

如不想自己部署的可以使用以下demo
官方demo

我部署的demo

部署方法

使用Docker安装

本教程使用docker的方式安装部署,简单便捷
164b6ac419e23bc5390dc46601a202bf

准备条件

1）一台服务器

我们使用莱卡云VPS和飞牛云NAS来演示

需要vps的可以看以下信息配置可以参考以下资源占用情况
莱卡云官网

本期docker容器占用资源情况如下仅供参考,总体占用内存不足60M

2）本项目使用到的项目

本项目的官方github地址
https://github.com/GuooGaii/ip-geoaddress-generator
更多功能或者二次修改可以访问开源项目地址

3）域名(必须)

由于这个项目不要配置ssl证书才能复制信息
故需要配置域名和证书
飞牛云NAS可以利用官方的地址远程访问

① VPS部署

一、Docker环境部署

在vps安装docker和docker-compose
Docker官方安装文档（英文）
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档（英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose（中文）
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose（中文）
https://duan.yyzq.eu.org//04

推荐直接用一键脚本

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

二、创建docker-compose.yml文件

登录服务器使用root账户执行以下步骤

mkdir  ip-geoaddress-generator;cd ip-geoaddress-generator

然后再新建docker-compose.yml

vim docker-compose.yml

services:
  ip-geoaddress-generator:
    image: guoogaii/ip-geoaddress-generator:latest  # 使用的 Docker 镜像
    ports:
      - "3050:3000"  # 映射容器的 3050 端口到主机的 3000 端口
    environment:
      - TZ=Asia/Shanghai  # 设置容器的时区为上海
    restart: always  # 设置容器的重启策略为 always（容器停止后自动重启）

三、执行容器运行命令

docker-compose up -d #运行容器

docker-compose ps  #查看是否启动成功

正常启动如下所示

docker-compose ps
NAME                                                IMAGE                                     COMMAND                  SERVICE                   CREATED          STATUS          PORTS
ip-geoaddress-generator-ip-geoaddress-generator-1   guoogaii/ip-geoaddress-generator:latest   "docker-entrypoint.s…"   ip-geoaddress-generator   34 minutes ago   Up 34 minutes   0.0.0.0:3050->3000/tcp, [::]:3050->3000/tcp

四、打开web页面使用

成功以后需要打开自己相应的端口3050)防火墙就可以web端访问了

主界面

http://ip:3050

直接打开即可使用

需要配置ssl证书才能直接复制

②飞牛云NAS部署

新建项目

ip-geoaddress-generator

复制以上vps上的yaml文件

正常启动即可-端口有冲突的自行更改

绑定域名

VPS上的建议绑定下域名

视频教程

B站

YouTube

绑定域名可以参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch

有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我

欢迎关注我们的微信公众号！

目录CONTENT