Hasura Backend Plus 安装与配置指南

Hasura Backend Plus 安装与配置指南

hasura-backend-plus 🔑Auth and 📦Storage for Hasura. The quickest way to get Auth and Storage working for your next app based on Hasura. 项目地址: https://gitcode.com/gh_mirrors/ha/hasura-backend-plus

1. 项目基础介绍

Hasura Backend Plus 是一个基于 Hasura 的开源项目，旨在为 Hasura 提供认证和存储的解决方案。它使得开发者能够快速搭建具有用户认证和文件存储功能的后端服务。该项目完全使用 TypeScript 编写，提供了高度可定制性和易于使用的接口。

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

• TypeScript：一种由微软开发的开源编程语言，它是 JavaScript 的一个超集，为 JavaScript 提供了静态类型检查。
• Hasura：一个开源的 GraphQL 引擎，可以轻松地将你的 PostgreSQL 数据库转换为实时 GraphQL API。
• JWT（JSON Web Tokens）：一种用于双方之间传递安全可靠信息的简洁的、URL安全的表达方式。
• OAuth：一种开放标准，允许用户提供一个token而不是用户名和密码来访问他们存储在特定服务提供者的数据。
• S3 兼容存储：允许使用类似 Amazon S3 的存储解决方案。

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

准备工作

在开始安装 Hasura Backend Plus 之前，你需要确保以下准备工作已完成：

• 安装了 Node.js 和 npm（Node.js 的包管理器）。
• 准备了一个 PostgreSQL 数据库。
• 确保你的系统中安装了 Docker 和 Docker Compose（如果使用容器化部署）。

安装步骤

步骤 1：克隆仓库

首先，从 GitHub 克隆 Hasura Backend Plus 仓库到本地环境：

git clone https://github.com/nhost/hasura-backend-plus.git
cd hasura-backend-plus

步骤 2：安装依赖

接着，安装项目所需的依赖：

npm install

步骤 3：配置环境变量

创建一个 .env 文件，并添加必要的环境变量：

HASURA_GRAPHQL_ENDPOINT=http://localhost:8080/v1/graphql
HASURA_ADMIN_SECRET=youradminsecret
DB_NAME=hasura_db
DB_USER=hasura_user
DB_PASS=hasura_password
DB_HOST=localhost
DB_PORT=5432

确保将 youradminsecret 替换为你自己的 Hasura 管理密钥，以及用你自己的 PostgreSQL 数据库配置替换 DB_NAME、DB_USER、DB_PASS、DB_HOST 和 DB_PORT。

步骤 4：启动 Hasura Backend Plus

最后，启动 Hasura Backend Plus：

npm run start

或者，如果你使用 Docker 容器化部署，可以通过以下命令启动服务：

docker-compose up

以上步骤完成后，你的 Hasura Backend Plus 服务应该已经成功安装并运行。你可以通过访问 Hasura Graphql Engine 的终端点来测试服务是否正常工作。

请注意，这只是一个基础指南，具体安装和配置细节可能会根据你的具体需求和环境有所不同。在安装和配置过程中遇到问题时，请查阅 Hasura Backend Plus 的官方文档和社区资源，如 GitHub 仓库中的 README 文件和项目文档，可以帮助你更深入地了解和解决任何可能出现的问题。

通过以上步骤，你可以成功安装和配置 Hasura Backend Plus，开始利用该工具为你的项目提供强大的认证和存储功能。

hasura-backend-plus 🔑Auth and 📦Storage for Hasura. The quickest way to get Auth and Storage working for your next app based on Hasura. 项目地址: https://gitcode.com/gh_mirrors/ha/hasura-backend-plus