ipapi

KO | EN

gitlite — search

#javascript #python #ai #typescript #llm #go #golang #machine-learning #nodejs #awesome #vue #awesome-list #security #ios

(★ 13)

ip验证管理系统

ipapi Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ip验证管理系统

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

![image-20250102145303889](https://raw.githubusercontent.com/vbskycn/ipapi/main/assets/image-20250102145303889.png)

## 功能特点

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

## 部署方式

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

```bash
# 拉取镜像
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

## 安装步骤

1. ### 创建数据库

```
   CREATE DATABASE ipapi CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   ```

2. ### 导入数据表

```
   mysql -u your_username -p ipapi < create_table.sql
   ```

可以直接导入 sql/create_table.sql

3. ### 修改配置文件

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

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

4. ### 设置文件权限

```
   chmod 755 *.php
   chmod 644 *.dat
   ```

## Docker 镜像构建

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

```bash
# 克隆仓库
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：

```yaml
version: '3'

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

volumes:
  mysql_data:
```

运行：

```bash
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);
```

### 管理界面

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

## 数据清理

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

## 安全建议

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

## 文件说明

- 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.1

- 增加持久化

### v1.1.0 (2025-01-02)

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

### v1.0.0 (2025-01-01)

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

## 许可证

MIT License

## 作者

作者：周杰
联系方式：admin@zhoujie218.top

## 贡献

欢迎提交问题和建议！

1. Fork 项目
2. 创建新分支
3. 提交更改
4. 发起 Pull Request

ipapi

ipapi Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ipapi

ipapi Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README