ceramicwhite/stacks-explorer

ceramicwhite/stacks-explorer 镜像文档

镜像概述和主要用途

ceramicwhite/stacks-explorer是一个Stacks浏览器应用镜像，用于可视化展示Stacks网络的实时数据，包括交易记录、区块信息、地址余额、智能合约等。通过配置环境变量，可灵活连接不同网络（主网/测试网）的API服务器，提供用户友好的Web界面，适用于***数据查询、开发调试及自定义部署场景。

核心功能和特性

• 多网络支持：可配置连接Stacks主网和测试网API服务器，支持网络切换
• 灵活配置：通过环境变量自定义API服务器地址、轮询间隔、部署URL等参数
• 实时数据：默认配置下定期轮询API获取最新***数据
• Web访问：暴露3000端口，通过浏览器访问Web界面
• 环境变量驱动：无需修改代码，通过环境变量即可完成个性化部署

使用场景和适用范围

• 开发者场景：调试Stacks***应用时，查询交易状态、区块信息
• 用户场景：普通用户查询Stacks***上的交易、地址余额等数据
• 自定义部署：企业或个人部署私有Stacks浏览器实例，连接特定API服务器

详细使用方法和配置说明

环境变量说明

Docker部署示例

1. 使用docker run快速启动

bash
docker run -p 3000:3000 -e "NEXT_PUBLIC_MAINNET_API_SERVER=http://127.0.0.1:3999" ceramicwhite/stacks-explorer

• 说明：启动容器并映射3000端口，配置主网API服务器地址为本地3999端口，其他环境变量使用默认值。访问http://localhost:3000即可打开浏览器界面。

2. 使用docker-compose配置完整部署

创建docker-compose.yml文件：

yaml
version: "3.7"

services:
  web:
    image: ceramicwhite/stacks-explorer
    init: true
    restart: on-failure
    user: "1000:1000"
    stop_grace_period: 1m
    environment:
      NEXT_PUBLIC_MAINNET_API_SERVER: http://127.0.0.1:3999  # 自定义主网API地址
      NEXT_PUBLIC_TESTNET_API_SERVER: https://api.testnet.hiro.so  # 测试网API地址
      NEXT_PUBLIC_LEGACY_EXPLORER_API_SERVER: https://explorer-api.legacy.blockstack.org  # 旧版API地址
      NEXT_PUBLIC_DEPLOYMENT_URL: https://explorer.stacks.co  # 部署URL
      NEXT_PUBLIC_MAINNET_ENABLED: "true"  # 启用主网
      NEXT_PUBLIC_DEFAULT_POLLING_INTERVAL: "10000"  # 轮询间隔（10秒）
    ports:
      - 3000:3000  # 映射Web访问端口

启动命令：docker-compose up -d，访问http://localhost:3000使用浏览器。

访问方式

容器启动后，通过浏览器访问 http://<主机IP>:3000 即可打开Stacks浏览器界面，根据配置的API服务器查看对应网络的数据。