Horizon.js完整安装教程：从零开始配置开发环境
项目地址: https://gitcode.com/gh_mirrors/ho/horizon Horizon是一个开源实时后端平台，专为JavaScript应用设计，提供完整的实时数据同步和认证功能。无论你是前端新手还是经验丰富的开发者，Horizon都能让你快速构建实时应用而无需编写复杂的后端代码。🌐
🚀 Horizon项目概述
Horizon基于RethinkDB构建，包含四个核心组件：
- Horizon服务器 - 连接RethinkDB的中间件服务器，为前端应用提供简单的API
- Horizon客户端库 - 封装服务器协议的JavaScript客户端库
- Horizon CLI工具 - 用于项目脚手架、开发和部署的命令行工具
- GraphQL支持 - 即将推出的功能，支持React/Relay应用
📋 系统要求检查
在开始安装之前，确保你的系统满足以下要求：
- Node.js版本 ≥ 4.0.0
- npm版本 ≥ 3.0.0
- RethinkDB已安装并可从PATH访问
🛠️ 步骤1：安装Horizon CLI
打开终端，执行以下命令全局安装Horizon：
npm install -g horizon
这个命令会安装Horizon CLI工具（hz），它是你管理Horizon项目的主要接口。
🎯 步骤2：创建你的第一个Horizon应用
使用Horizon CLI初始化一个新项目：
hz init my-first-app
该命令会创建包含以下结构的项目目录：
my-first-app/
├── dist/
│ └── index.html
├── .hz/
│ └── config.toml
└── src/
目录说明：
dist/- 存放静态文件的输出目录.hz/- Horizon服务器配置文件src/- 源代码目录（仅约定）
🔧 步骤3：启动Horizon开发服务器
进入项目目录并启动开发服务器：
cd my-first-app
hz serve --dev
--dev标志启用开发模式，自动处理以下任务：
- 启动RethinkDB服务器
- 启用不安全模式（无HTTPS/WSS）
- 自动创建表和索引
⚙️ 步骤4：配置Horizon服务器
编辑.hz/config.toml文件来配置Horizon服务器。这是一个TOML格式的配置文件，你可以设置各种服务器选项。
核心配置文件：
- .hz/config.toml - 主要服务器配置
- Horizon服务器源码
- 客户端库源码
🔐 步骤5：添加OAuth认证（可选）
要启用用户认证，你可以在.hz/config.toml中配置OAuth提供商：
[auth.github]
id = "your_client_id"
secret = "your_client_secret"
🎉 验证安装成功
打开浏览器访问http://localhost:8181，你应该看到"它工作了！"的消息，证明Horizon服务器正常运行。
💡 开发环境优化技巧
- 使用热重载 - 在开发过程中保持服务器运行，代码更改会自动更新
- 利用自动索引 - 开发模式下查询会自动创建所需索引
- 调试工具 - 使用浏览器开发者工具监控WebSocket连接
🚨 常见问题解决
问题：端口8181已被占用 解决方案：使用--port标志指定不同端口
问题：RethinkDB连接失败 解决方案：确保RethinkDB已安装并在PATH中可用
📚 下一步学习资源
现在你已经成功安装了Horizon开发环境！准备好开始构建你的第一个实时JavaScript应用了吗？🎯
Horizon的完整安装教程到此结束，接下来你可以开始探索Horizon的强大功能，构建令人惊艳的实时应用！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
