自托管Esplora教程：提升隐私与安全的本地部署步骤

【免费下载链接】esplora Explorer for Bitcoin and Liquid 项目地址: https://gitcode.com/gh_mirrors/es/esplora

Esplora是一款功能强大的Bitcoin和Liquid区块链浏览器，通过自托管部署，您可以完全掌控数据隐私与访问安全。本指南将带您完成从环境准备到成功运行的全流程，无需专业技术背景也能轻松上手。

📋 准备工作：部署前的必要检查

在开始部署前，请确保您的系统满足以下要求：

• 至少4GB RAM（推荐8GB以上）
• 100GB以上可用磁盘空间（区块链数据会持续增长）
• Docker与Docker Compose环境
• Git工具链

通过以下命令检查Docker是否已安装：

docker --version && docker-compose --version

🚀 快速部署：3步完成Esplora自托管

1. 获取项目源码

首先克隆官方仓库到本地：

git clone https://gitcode.com/gh_mirrors/es/esplora
cd esplora

2. 配置部署参数

项目提供了完整的Docker化部署方案，配置文件位于 contrib/docker-compose.yml。默认配置适用于本地测试环境，主要包含：

• esplora服务：默认映射80端口（HTTP）和50001端口（API）
• 自动构建机制：基于项目根目录的Dockerfile
• 预配置的bitcoin-regtest环境

3. 启动服务集群

在项目根目录执行启动命令：

cd contrib && docker-compose up -d

首次启动会自动下载镜像并初始化区块链数据，整个过程可能需要10-30分钟（取决于网络速度）。

🔍 验证部署：确认服务正常运行

服务启动后，通过以下方式验证部署状态：

1. 检查容器状态

docker-compose ps

确保所有服务都显示为"Up"状态

2. 访问Web界面 打开浏览器访问 http://localhost，您将看到Esplora的主界面。首次加载可能需要几分钟同步初始区块数据。

图：Esplora区块链浏览器主界面，显示最新区块和交易信息

3. 测试API接口 通过curl命令测试API可用性：

curl http://localhost/api/blocks/tip/height

成功返回当前区块高度即表示API服务正常。

⚙️ 高级配置：自定义您的Esplora实例

修改端口映射

如需更改默认端口，编辑 contrib/docker-compose.yml 文件中的ports部分：

ports:
  - "50001:50001"  # API端口
  - "8080:8080"    # 内部服务端口
  - "80:80"        # Web界面端口

切换网络环境

默认配置使用regtest测试网络，如需切换到主网或测试网，修改command参数：

command:
  - bash
  - -c
  - '/srv/explorer/run.sh bitcoin-mainnet explorer nonverbose'

支持的网络参数包括：bitcoin-mainnet、bitcoin-testnet、liquid-mainnet等。

启用SSL加密

生产环境建议配置HTTPS，可通过修改Nginx配置实现。相关配置模板位于 contrib/nginx.conf.in。

🔒 安全最佳实践

1. 限制访问权限 通过防火墙只开放必要端口，避免直接暴露API端口到公网

2. 定期更新 保持项目代码最新：

git pull origin master
cd contrib && docker-compose down && docker-compose up -d --build

3. 监控系统状态 使用工具监控磁盘空间和内存使用，区块链数据会持续增长，建议设置自动清理策略。

🛠️ 故障排除常见问题

服务启动失败

检查日志获取详细错误信息：

docker-compose logs esplora

区块同步缓慢

确保网络连接稳定，可修改比特币节点配置提高同步速度：

# 编辑bitcoin.conf
vi contrib/bitcoin-regtest-explorer.conf.in

API访问异常

确认端口映射正确，尝试重启服务：

docker-compose restart esplora

图：Esplora API接口示意图，支持多种区块链数据查询功能

📚 扩展学习资源

• 项目配置文件：contrib/
• 本地化支持：lang/
• 开发文档：API.md

通过自托管Esplora，您不仅获得了一个功能完整的区块链浏览器，更掌握了数据主权。无论是个人学习还是企业部署，这套方案都能满足您对隐私和安全的核心需求。现在就开始您的区块链探索之旅吧！

【免费下载链接】esplora Explorer for Bitcoin and Liquid 项目地址: https://gitcode.com/gh_mirrors/es/esplora