Self-Hosting (私有化部署)

Quasar Community Edition 是基于 Apache-2.0 许可证开源的 Quasar 版本，代码发布在 TuwaIO/quasar-community ，并在 GHCR 提供官方容器镜像。它运行与 Quasar Cloud 完全相同的链上追踪引擎和 API，专为单租户自建节点打造：详情参见 Quasar Cloud 与 Quasar Community 的区别。

详细的部署说明位于代码仓库中，核心指南如下：

指南文档	核心内容
README	社区版所含组件、仓库代码结构、5 分钟本地快速上手以及工作区配额设置。
本地快速启动	环境变量配置、单节点 Docker Compose 配置文件、初始数据填充 (Seed) 与首次管理员登录。
生产级高可用部署	高可用架构：PostgreSQL 主从复制、Redis 哨兵/集群、PgBouncer、WAL-G 归档与 Traefik 反向代理。
CI/CD 自动化部署	通过仓库自带的 GitHub Actions 流水线自动化构建与发布您的定制 Fork 镜像。
初始数据填充	种子数据脚本生成的资源明细以及在开发环境中重置和重新初始化的方法。

基于最新开发分支构建的公开预览节点运行在 community-stg.tuwa.io 。此节点仅供开发预览体验，请勿在生产环境依赖。

🔌 将 SDK 指向自建节点

应用程序代码完全无需改动：在节点的 /admin 控制面板中创建一个应用，复制其 Secret Key，并将自定义节点地址传入 SDK：

src/lib/quasar.ts


import { Quasar } from '@tuwaio/quasar-sdk'; export const quasar = new Quasar({  secretKey: process.env.QUASAR_SECRET_KEY ?? '',  baseUrl: process.env.QUASAR_BASE_URL ?? 'https://api.tuwa.io',});

在前端浏览器中，向 @tuwaio/quasar-sdk/react 的 preFlightTxCheck(url) 传入相同地址；在本地调试 Webhook 时，使用 npx @tuwaio/quasar-sdk listen --api-url <url>（或在 .env 中指定 QUASAR_BASE_URL）。

如需将云端组织的 API 密钥、Webhook 密钥及完整历史交易平滑迁移至自建节点，请参考从 Quasar Cloud 迁移至社区版。