zhoujie218/ipapi

By zhoujie218

•Updated almost 2 years ago

Image

1.6K

Overview Tags

zhoujie218/ipapi repository overview

⁠ip验证管理系统

一个简单高效的IP访问管理系统，用于记录和管理IP访问记录，支持地理位置显示和设备信息识别。

⁠功能特点

IP访问记录和管理，验证
IP地理位置自动识别
设备信息识别
访问统计和分析
分页和搜索功能
数据自动清理
Docker 部署支持（支持 x86_64/ARM64/ARMv7）

⁠部署方式

⁠方式一：Docker 部署（推荐）

# 拉取镜像
docker pull zhoujie218/ipapi:latest

#删除容器
docker stop ipapi
docker rm ipapi

# 运行容器(数据持久化,要先安装后把数据库copy到你的映射目录)
docker run -d \
  --name ipapi \
  --restart always \
  -p 8081:80 \
  -v /root/docker/ipapi:/var/lib/mysql \
  zhoujie218/ipapi:latest

# 运行容器 
docker run -d \
  --name ipapi \
  --restart always \
  -p 8081:80 \
  zhoujie218/ipapi:latest

支持的标签：

latest: 最新版本
YYYYMMDD-HHMM: 指定版本（北京时间）

支持的架构：

linux/amd64 (x86_64)
linux/arm64 (ARM 64位)
linux/arm/v7 (ARM 32位)

数据持久化：

MySQL 数据存储在 /var/lib/mysql
建议使用 volume 挂载保存数据

⁠方式二：传统部署

⁠系统要求

PHP 7.0+
MySQL 5.6+
Web服务器（Apache/Nginx）
PHP扩展：
- mysqli
- curl
- mbstring
- json

⁠安装步骤

⁠创建数据库

CREATE DATABASE ipapi CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

⁠导入数据表
```
mysql -u your_username -p ipapi < create_table.sql
```
可以直接导入 sql/create_table.sql

⁠修改配置文件

编辑 config.php，设置数据库连接信息：

$db_host = "localhost:3306";
$db_user = "your_username";
$db_pwd = "your_password";
$db_database = "ipapi";

⁠设置文件权限
```
chmod 755 *.php
chmod 644 *.dat
```

⁠Docker 镜像构建

如果您想自己构建 Docker 镜像：

# 克隆仓库
git clone https://github.com/vbskycn/ipapi.git
cd ipapi

# 构建镜像
docker build -t ipapi .

# 运行容器
docker run -d -p 80:80 -v mysql_data:/var/lib/mysql ipapi

⁠Docker Compose 部署

创建 docker-compose.yml：

version: '3'

services:
  ipapi:
    image: zhoujie218/ipapi:latest
    ports:
      - "80:80"
    volumes:
      - mysql_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql_data:

运行：

docker-compose up -d

⁠默认账号

用户名：admin
密码：admin123456

请在首次登录后立即修改密码！

⁠使用说明

⁠IP记录接口

发送POST请求到check_ip.php记录IP访问：

curl -X POST http://your-domain/index.php

⁠IP访问验证

发送GET请求到check_ip.php验证IP是否允许访问：

curl http://your-domain/index.php

php集成

			// 添加 IP 检查的 POST 请求
			$check_ip_url = 'https://your-domain/index.php';
			$post_data = array(
				'ip' => $ip,
				'user_id' => $name,
				'device_id' => $androidid
			);
			
			$headers = array(
				'X-Forwarded-For: ' . $ip,
				'X-Real-IP: ' . $ip,
				'Client-IP: ' . $ip
			);
			
			$ch = curl_init();
			curl_setopt($ch, CURLOPT_URL, $check_ip_url);
			curl_setopt($ch, CURLOPT_POST, true);
			curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post_data));
			curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
			curl_setopt($ch, CURLOPT_TIMEOUT, 1);
			curl_setopt($ch, CURLOPT_NOSIGNAL, 1);
			curl_setopt($ch, CURLOPT_FRESH_CONNECT, 1);
			curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);  // 添加自定义头部
			$response = curl_exec($ch);
			curl_close($ch);
			
			// 记录日志
			error_log("IP check response for user $name (IP: $ip): " . $response);

⁠管理界面

访问 http://your-domain/admin.php⁠
使用管理员账号登录
可以进行以下操作：
- 查看IP访问记录
- 搜索特定IP
- 删除IP记录
- 清理过期数据
- 查看访问统计

⁠数据清理

默认清理72小时未访问的记录
输入0小时，清楚所有记录
可以在管理界面手动设置清理时间
IP地理位置缓存7天自动更新

⁠安全建议

修改默认管理员密码
配置服务器防火墙
使用HTTPS协议
定期备份数据库
及时更新系统

⁠文件说明

admin.php: 管理界面主文件
IpManager.php: IP管理核心类
check_ip.php: IP访问记录接口
config.php: 系统配置文件
login.php: 登录界面
logout.php: 退出登录
change_password.php: 修改密码
create_table.sql: 数据库结构

⁠常见问题

⁠1. 地理位置显示"未知位置"

检查IP库文件权限
确保PHP有读取权限

⁠2. 设备信息显示"未知设备"

检查User-Agent是否正确传递
可能是特殊客户端访问

⁠3. 数据库连接失败

检查数据库配置

确认数据库服务是否运行

⁠qqwry.dat

纯真IP数据库文件，dat数据非exe安装包

下载直链
https://raw.githubusercontent.com/adysec/IP_database/main/qqwry/qqwry.dat
国内下载直链
https://raw.gitmirror.com/adysec/IP_database/main/qqwry/qqwry.dat

⁠GeoLite.mmdb

⁠更新日志

⁠v1.1.0 (2025-01-02)

添加 Docker 支持
支持多架构部署（x86_64/ARM64/ARMv7）
优化数据库初始化流程

⁠v1.0.0 (2025-01-01)

初始版本发布
基础功能实现

⁠许可证

MIT License

⁠作者

作者：周杰联系方式：[email protected]⁠

⁠贡献

欢迎提交问题和建议！

Fork 项目
创建新分支
提交更改
发起 Pull Request

Tag summary

Recent tags

Content type