{"id":20986634,"url":"https://github.com/dpwgc/maybe-db","last_synced_at":"2026-05-01T21:35:25.344Z","repository":{"id":144485546,"uuid":"439832788","full_name":"dpwgc/maybe-db","owner":"dpwgc","description":"MaybeDB - 基于Golang整合Nacos的分布式键值型内存数据库。支持主从复制(一主多从/多主多从)。支持数据持久化。可插入string、int64、map、array类型的值。可使用等值查找、关键字检索和前缀检索方法搜索数据。可对数据设置过期时间，实时清除过期数据。","archived":false,"fork":false,"pushed_at":"2021-12-20T17:24:59.000Z","size":17798,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-02T20:47:34.638Z","etag":null,"topics":["cluster","databases","distributed","gin","golang","key-value","memory-database","nacos","server"],"latest_commit_sha":null,"homepage":"https://gitee.com/dpwgc/maybe-db","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dpwgc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-19T10:21:21.000Z","updated_at":"2025-03-29T15:31:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"0e495437-3775-4b66-9cd1-2483bd50971f","html_url":"https://github.com/dpwgc/maybe-db","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dpwgc/maybe-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpwgc%2Fmaybe-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpwgc%2Fmaybe-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpwgc%2Fmaybe-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpwgc%2Fmaybe-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dpwgc","download_url":"https://codeload.github.com/dpwgc/maybe-db/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpwgc%2Fmaybe-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32513968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cluster","databases","distributed","gin","golang","key-value","memory-database","nacos","server"],"created_at":"2024-11-19T06:14:25.227Z","updated_at":"2026-05-01T21:35:25.316Z","avatar_url":"https://github.com/dpwgc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MaybeDB\n\n## 基于Golang整合Nacos的分布式键值型内存数据库\n\n`Golang` `Gin` `Nacos` `sync.Map`\n\n***\n\n### 集群实现功能\n\n* 主从节点读写分离：主节点负责插入/删除数据，从节点负责查询数据。\n\n* 高可用：支持一主多从集群部署或多主多从集群部署，单个主节点宕机重启后，可拉取其他健康的主节点的数据或从本地持久化文件中提取数据来进行数据恢复。\n\n* 主节点之间数据同步：在任意一个主节点进行数据插入/删除操作，该操作都会扩散同步到其他主节点。\n\n* 主从节点数据同步：从节点从Nacos上获取任意一个健康的主节点实例，向目标主节点实例发出同步请求，并将请求结果解析同步到本地。\n\n### 单机实现功能\n\n* 数据持久化与重启数据恢复\n\n* 插入数据（value的类型：支持string、int64、map、int类型数组）\n\n* 根据key查找数据\n\n* 根据key中关键字获取数据列表\n\n* 根据key的前缀获取数据列表\n\n* 获取全部数据\n\n* 统计数据总数\n\n* 给数据设置过期时间\n\n* 自动清除过期数据\n\n* 删除数据\n\n***\n\n### 项目结构\n\n##### clientConn 客户端连接\n\n* set.go `存储数据相关操作`\n\n* get.go `获取数据相关操作`\n\n* del.go `删除数据相关`\n\n* detail.go `获取数据详情相关操作`\n\n##### config 配置类\n\n* application.yaml `项目配置文件`\n\n* config.go `项目配置文件加载`\n\n##### middleware 中间件\n\n* safeMiddleware.go `访问密钥验证`\n\n##### router 路由\n\n* router.go `路由配置`\n\n##### server 服务层\n\n* cluster `集群服务`\n\n  * sync.go `主从节点数据同步`\n\n  * master.go `主节点同步相关操作`\n\n  * slave.go `从节点同步相关操作`\n\n  * nacos.go `Nacos注册中心连接`\n\n* database `数据库服务`\n\n  * clear.go `清理过期数据`\n\n  * data.go `内存数据存储`\n\n  * log.go `本地日志记录`\n\n* persistent `持久化服务`\n\n  * fileRW.go `文件读写操作`\n\n  * persData.go `数据持久化`\n\n  * recovery.go `数据恢复`\n\n##### utils 工具类\n\n* httpUtil.go `http请求工具`\n\n* jsonUtil.go `Json字符串转换工具`\n\n##### main.go 主函数\n\n***\n\n### 打包方式\n\n* 填写application.yaml内的配置。\n\n* 运行项目：\n\n```\n（1）GoLand直接运行main.go(调试)\n```\n\n```\n（2）打包成exe运行(windows部署)\n\n  GoLand终端cd到项目根目录，执行go build main.go命令，生成main.exe文件\n```\n\n```\n（3）打包成二进制文件运行(linux部署)\n\n  cmd终端cd到项目根目录，依次执行下列命令：\n  SET CGO_ENABLED=0\n  SET GOOS=linux\n  SET GOARCH=amd64\n  go build main.go\n  生成main文件\n```\n\n***\n\n### 部署说明\n\n##### 集群部署\n\n* 在一台服务器上部署Nacos，添加命名空间(命名空间Id及命名空间名称设置为：maybe-db),填写各节点application.yaml配置文件中的Nacos配置信息。\n\n* 采用一主多从/多主多从方式部署项目,主节点负责写入数据，从节点负责读取数据。\n\n* application.yaml主从节点配置\n\n```\n# 主节点配置\nisCluster: 1\nisMaster: 1\n```\n\n```\n# 从节点配置\nisCluster: 1\nisMaster: 0\n```\n\n* 将主从节点打包好，分别上传至服务器运行即可。\n\n```\nWindows\n/maybe-db                 # 数据库节点所在文件根目录\n    MaybeDB.exe           # 打包后的exe文件\n    /config               # 配置目录\n        application.yaml  # 配置文件\n    /cache                # Nacos缓存目录\n    /log                  # 日志目录\n    data.csv              # 持久化文件\n```\n\n```\nLinux\n/maybe-db                 # 数据库节点所在文件根目录\n    MaybeDB               # 打包后的二进制文件(程序后台执行:setsid ./main)\n    /config               # 配置目录\n        application.yaml  # 配置文件\n    /cache                # Nacos缓存目录\n    /log                  # 日志目录\n    data.csv              # 持久化文件\n```\n\n##### 单机部署\n\n* 无需部署Nacos，将application.yaml配置文件中的isCluster设置为0，直接打包部署到服务器。\n\n```\n# 是否以集群方式部署（1:是，0:否）\nisCluster: 0\n# 是否为主节点（1:是，0:否）\nisMaster: 1\n```\n\n##### 数据持久化\n\n* 集群模式下，只有主节点需要进行持久化操作，从节点会自动同步主节点数据，无需进行数据持久化/数据恢复\n\n```\n# 是否开启持久化（1:是，0:否）\nisPersistent: 1\n# 数据持久化操作的时间间隔（单位：秒）\npersistentTime: 5\n# 持久化文件保存路径\npersistentPath: ./data.csv\n```\n\n```\n# 数据恢复策略（0:不进行数据恢复，1:从本地持久化文件中获取数据，2:从集群其他健康的主节点获取数据）\nrecoveryStrategy: 2\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpwgc%2Fmaybe-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdpwgc%2Fmaybe-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpwgc%2Fmaybe-db/lists"}