henryclw/jsonhero-web

henryclw/jsonhero-web Docker镜像文档

镜像概述

henryclw/jsonhero-web是JSON Hero的Docker化版本。与原仓库jsonhero-io/jsonhero-web相比，其核心差异在于提供了Docker支持。JSON Hero是一款帮助用户轻松阅读和理解JSON文件的工具，通过简洁美观的UI及丰富功能，让JSON文件查看和分析变得简单。

!Docker Pulls !Docker Image Size (tag) !https://github.com/henryclw/jsonhero-web/actions/workflows/docker-image.yml/badge.svg

核心功能与特性

多视图支持

• 列视图：受macOS Finder启发，提供层级浏览体验，支持键盘导航、路径栏和历史记录，可按住Option/Alt键保持上下文浏览
• 树视图：传统树形结构展示，支持折叠/展开和键盘快捷键
• 编辑器视图：完整JSON编辑界面，同时保留侧边栏预览和相关值展示

内容智能预览

自动识别字符串内容并提供预览：

• 日期时间：格式化显示时间信息
• 图片URL：直接展示图片预览
• 网站URL：显示网站预览卡片
• 推文URL：展示推文内容预览
• JSON URL：解析并预览JSON内容
• 颜色值：显示颜色预览块

实用功能

• 搜索：模糊搜索JSON文件的键名、路径和值，支持毫秒级响应
• 相关值分析：快速查看特定字段在整个JSON文档中的所有相关值，包括undefined和null
• 键盘访问：全键盘操作支持
• 可分享URL：生成包含路径的可分享链接

使用场景

• 本地JSON文件查看与分析
• 开发过程中JSON数据结构调试
• API响应数据可视化
• 复杂JSON文件的快速导航与理解

使用方法

拉取并运行镜像

bash
# 拉取最新镜像
docker pull henryclw/jsonhero-web:latest

# 运行容器，访问 http://localhost:8787
docker run -it -d --name jsonhero_web -p 8787:8787 henryclw/jsonhero-web:latest

本地构建镜像

如需自定义，可本地构建：

bash
# 克隆仓库
git clone https://github.com/henryclw/jsonhero-web.git
cd jsonhero-web

# 构建本地镜像
docker build . -t yourname/jsonhero-web:localdev

# 运行自定义镜像
docker run -it -d --name jsonhero_web_dev -p 8787:8787 yourname/jsonhero-web:localdev

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  jsonhero-web:
    image: henryclw/jsonhero-web:latest
    container_name: jsonhero_web
    ports:
      - "8787:8787"
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置说明

环境变量

设置环境变量示例：

bash
docker run -it -d --name jsonhero_web -p 8787:8787 -e SESSION_SECRET=your_secret_key henryclw/jsonhero-web:latest

发送JSON到JSON Hero

除本地部署外，还可通过多种方式将JSON发送到JSON Hero：

• 访问jsonhero.io，拖放JSON文件或粘贴JSON内容/URL
• 使用Base64编码JSON：jsonhero.io/new?j=eyAiZm9vIjogImJhciIgfQ==
• 通过URL加载：jsonhero.io/new?url=https://jsonplaceholder.typicode.com/todos/1
• 安装VS Code扩展或Raycast扩展
• 调用API：

  bash
  curl -X POST https://jsonhero.io/api/create.json \
    -H "Content-Type: application/json" \
    -d '{"title":"test","content":{"foo":"bar"}}'
  

问题反馈

如有bug或功能需求，可在https://github.com/henryclw/jsonhero-web%E6%8F%90%E4%BA%A4issue%EF%BC%8C%E6%88%96%E5%8A%A0%E5%85%A5***%E9%A2%91%E9%81%93%E8%AE%A8%E8%AE%BA%E3%80%82