goCzdb

KO | EN

gitlite — search

#javascript #hacktoberfest #typescript #rust #deep-learning #docker #nodejs #java #windows #cli #kubernetes #awesome-list #pytorch #mcp

(★ 10)

GO解析CZDB免费IP数据库

goCzdb 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# goCzdb 使用指南

goCzdb 是一个用于在纯真(CZ88)IP库中搜索数据的类。它支持三种类型的搜索算法：内存搜索（MEMORY）和B树搜索（BTREE）。数据库类型（IPv4或IPv6）和查询类型（MEMORY、BTREE）在运行时确定。

## goMod 依赖

如果你想在你的项目中使用`goCzdb` ： `go get github.com/zhengjianyang/goCzdb`

## 支持 IPv4 和 IPv6

goCzdb 支持 IPv4 和 IPv6 地址的查询。在创建 DbSearcher 实例时，你需要提供相应的数据库文件和密钥。

数据库文件和密钥可以从 [www.cz88.net](https://cz88.net/geo-public) 获取。

## 如何使用

首先，你需要创建一个 DbSearcher 的实例。在创建实例时，你需要提供数据库文件的路径、查询类型和用于解密数据库的密钥。

```
searcher, err := NewDbSearcher(databasePath, queryType, key)
defer searcher.Close()
```

然后，你可以使用 `searcher` 方法来根据提供的 IP 地址在数据库中搜索数据。

```
searcher.Search("8.8.8.8")
```

如果搜索成功，`searcher` 方法将返回找到的数据块的区域。如果搜索失败，它将返回 null。

返回的字符串格式为 "国家–省份–城市–区域 ISP"。例如，对于一个位于中国上海市虹口区的IP地址，返回的字符串可能是 "中国–上海–上海–虹口区 电信"。如果搜索失败，它将返回 null。

## 查询类型

DbSearcher 支持2种查询类型：MEMORY 和 BTREE。

- MEMORY：此模式是线程安全的，将数据存储在内存中。
- BTREE：此模式使用 B-tree 数据结构进行查询。它不是线程安全的。不同的线程可以使用不同的查询对象。

你可以在创建 DbSearcher 实例时选择查询类型。

```
searcher, err := NewDbSearcher(databasePath, "MEMORY", key)
```

## 线程安全

请注意，只有 MEMORY 查询模式是线程安全的。如果你在高并发环境下使用 BTREE 查询模式，可能会导致打开的文件过多的错误。在这种情况下，你可以增加内核中允许打开的最大文件数（fs.file-max），或者使用 MEMORY 查询模式。当然更合理的一个方式是为线程池中的每一个线程只创建一个DbSearcher实例。

## 关闭数据库

当查询结束时，你应该关闭数据库。注意**并不是说**每次查询都需要创建DbSearcher实例查完后关闭，如果是为每个线程创建一个DbSearcher实例，那么只有在线程结束时才需要关闭数据库。

```
searcher.Close()
```

这将释放所有使用的资源，并关闭对数据库文件的访问。

goCzdb

goCzdb 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

goCzdb

goCzdb 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README