v1.0 · Go 语言构建

{
"tool": "JSON DB",
"philosophy": "less is more"
}

基于 Go 语言的极简 JSON 数据库。通过优雅的 HTTP 接口实现数据的存储、查询和删除，每个作用域独立存储为 JSON 文件。

json-db terminal

$ curl https://jsondb.fangna.tech/users
 
{
  "alice": {
    "role": "admin",
    "active": true,
    "points": 42
  },
  "bob": {
    "role": "editor",
    "active": false,
    "points": 17
  }
}

核心特性

为什么选择 JSON DB?

没有复杂依赖，没有繁琐配置。一条命令启动，一个文件部署。

🚀

极速启动

单文件部署，一条命令启动服务。从零到运行只需 5 秒。

🎯

RESTful API

GET 查询、POST 保存、DELETE 删除。API 设计简洁直观，开箱即用。

💾

文件持久化

数据以 JSON 文件存储，可读性强，易于备份和版本控制。

🔒

安全验证

作用域名称自动验证，防止路径注入和非法字符。

📦

零依赖

纯 Go 标准库实现，编译后即可独立运行，无需任何运行时依赖。

⚙️

自动美化

保存的 JSON 自动格式化缩进，便于人工查看和编辑。

API 参考

简单到无需文档

三个 HTTP 方法，覆盖所有场景。

GET /{scopename}

查询指定作用域的完整 JSON 数据

# 查询用户数据
curl https://jsondb.fangna.tech/users

GET /{scopename}/e

在浏览器中打开在线 JSON 编辑器

# 在浏览器中访问
# https://jsondb.fangna.tech/mark/e

POST /{scopename}

保存或更新数据（请求体中的 JSON 将完整覆盖文件）

# 保存用户数据
curl -X POST https://jsondb.fangna.tech/users \
-H "Content-Type: application/json" \
-d '{ "name": "张三", "age": 25, "role": "admin" }'

DELETE /{scopename}

删除指定作用域的数据文件

# 删除用户数据
curl -X DELETE https://jsondb.fangna.tech/users

快速开始

4 步上手

从本地开发到线上部署，简单直接。

01 启动服务

                    Bash
                    # 开发模式

                    go run main.go

                    # 或编译后运行

                    go build -o json-db .

                    ./json-db

02 保存数据

                    JavaScript
                    const response = await fetch('https://jsondb.fangna.tech/app_config', {

                      method: 'POST',

                      headers: { 'Content-Type': 'application/json' },

                      body: JSON.stringify({ theme: 'dark', lang: 'zh-CN' })

                    });

                    const result = await response.json();

03 查询数据

                    Python
                    import requests

                    response = requests.get('https://jsondb.fangna.tech/app_config')

                    data = response.json()

                    print(data)

                    # {'theme': 'dark', 'lang': 'zh-CN'}

04 删除数据

                    Bash
                    curl -X DELETE https://jsondb.fangna.tech/app_config

                    # 响应

                    {"success": true, "message": "数据删除成功", "scope": "app_config"}

命名规则

作用域命名规范

简洁、安全、一致。

✓ 英文字母 a-z, A-Z

✓ 数字 0-9

✓ 下划线 _ 和连字符 -

✓ 长度 1-50 个字符

✗ 中文及特殊字符

✗ 路径分隔符 /

有效 users, app_config, my-data

无效用户数据, user/data, config.json

适用场景

轻量，但不简单

在真正需要的地方，发挥真正的价值。

⚙️ 配置管理

存储应用配置、用户偏好设置。简单的 key-value 也能胜任。

🧪 快速原型

前后端分离开发时的临时数据存储。不需要数据库，一个 API 就够了。

📊 小型项目

个人项目、内部工具的数据持久化。装 MySQL 太重，用 JSON DB 刚好。

🔄 数据缓存

频繁读写的轻量级缓存层。文件级存储，进程重启不丢失。

开始你的数据之旅

简单 · 优雅 · 高效

立即开始