horizon 的安装和配置教程

1. 项目基础介绍和主要编程语言

Horizon 是 Stellar 生态系统中的客户端面向的 API 服务器。它充当 stellar-core 和希望访问 Stellar 网络的应用程序之间的接口。通过 Horizon，用户可以提交交易到网络、检查账户状态、订阅事件流等。Horizon 以 Go 为主编程语言，同时也包含一些 Ruby 代码。

2. 项目使用的关键技术和框架

• Go 语言: Horizon 的主要编程语言，用于构建高性能的 API 服务器。
• Ruby: 项目中的一部分脚本和工具使用 Ruby 语言编写。
• HTTP/REST API: Horizon 提供了一个基于 HTTP/REST 的 API，便于应用程序与之交互。
• PostgreSQL: 数据库系统，用于存储与 Stellar 网络交互的数据。
• stellar-core: Horizon 与 Stellar 网络核心层的接口。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：支持 macOS、Linux 或 Windows。
• Go 语言环境：版本 1.13 或以上。
• PostgreSQL：数据库系统，用于存储数据。
• Ruby：用于运行项目中的脚本。

安装步骤

步骤 1：安装 Go 语言环境

首先，您需要在系统中安装 Go 语言环境。具体步骤请参考 Go 官方文档，确保安装完成后，go 命令可以在终端中正常使用。

步骤 2：安装 PostgreSQL

接着，您需要在系统中安装 PostgreSQL 数据库。具体步骤请参考 PostgreSQL 官方文档。安装完成后，请确保 PostgreSQL 服务正在运行。

步骤 3：安装 Ruby

根据您的操作系统，使用包管理器安装 Ruby。在 macOS 上，您可以使用 Homebrew 来安装 Ruby。在 Linux 上，您可以使用系统自带的包管理器。

# 对于 macOS 用户
brew install ruby

# 对于 Linux 用户（以 Ubuntu 为例）
sudo apt-get install ruby

步骤 4：克隆项目代码

在您的计算机上创建一个新的目录，然后使用 Git 克隆 Horizon 项目的代码。

git clone https://github.com/stellar-deprecated/horizon.git
cd horizon

步骤 5：设置环境变量

在项目根目录下，创建一个 .envrc 文件，并设置必要的环境变量。

# 创建 .envrc 文件并编辑
touch .envrc
nano .envrc

# 在文件中添加以下内容，根据自己的 PostgreSQL 设置进行修改
DATABASE_URL="postgres://username:password@localhost/horizon"

保存并退出编辑器。

步骤 6：安装项目依赖

使用以下命令安装项目所需的依赖。

make build

这个命令会安装所有必要的 Go 依赖项。

步骤 7：启动 Horizon

最后，使用以下命令启动 Horizon 服务。

make run

如果一切设置正确，Horizon 服务将开始运行，并且您可以通过浏览器访问 http://localhost:8000 查看服务状态。

确保遵循上述步骤，您应该能够成功安装和配置 Horizon。如果在安装过程中遇到问题，请参考项目的官方文档或向社区寻求帮助。