跳转到主要内容
使用 v0.5.0 或更早版本内置节点创建的钱包及其备份，无法在 v0.5.1 中打开。升级前，请先用 v0.5.0 关闭通道并转出资金，然后再创建新钱包。

​
安装方式

安装 KaleidoSwap 桌面应用有两种方式：

​
1. 下载二进制文件

  1. 下载：从 KaleidoSwap 下载页面 或 GitHub Releases 页面获取最新构建，选择与你操作系统匹配的二进制文件。
  2. 校验：安装前，用经 GPG 签名的 SHA256 校验和清单核对下载文件。详细步骤见二进制文件校验指南。
  3. 安装：执行该二进制文件即可运行应用。

​
2. 本地构建

​
通用前置条件

  • Tauri 2.x
    确认已安装全部官方 Tauri 前置依赖（Rust、Node.js、pnpm）。
  • 代码仓库

​
各平台专用说明

Windows：
  • Windows 上不提供原生二进制 (Native Binary) 节点后端。要在 Windows 上运行本地节点，请在应用中选择「本地节点 → Docker 容器」(Local Node → Docker Container)（需要 Docker Desktop 处于运行状态），或连接远程节点 —— 参见节点托管，其他远程节点方案见故障排查
  • 安装 vcpkg，用它安装 openssl、sqlite3 等库
  • 确认已安装 Microsoft Visual C++（通过 Visual Studio 或 Build Tools）
Linux：
  • 安装 build-essential 和 pkg-config
  • 安装 CI 构建所用的 WebKitGTK / GTK 依赖：libwebkit2gtk-4.1-dev、libwebkit2gtk-4.0-dev、libgtk-3-dev、libglib2.0-dev、librsvg2-dev、libappindicator3-dev 和 patchelf
  • 确认 Rust、Node.js 和 pnpm 均已正确安装

​
构建与运行

  1. 安装依赖：
  2. 构建 Tauri 应用：
  3. 以开发模式运行 KaleidoSwap：

​
节点配置选项

安装 KaleidoSwap 之后，你需要连接到一个 RGB Lightning Node。有两种选择：

​
方案 1：连接远程节点

如果你不想在本机运行节点，可以连接到远程 RGB Lightning Node：
  • 自托管远程节点：按照 RGB Lightning Node 托管指南，在 VPS 或服务器上搭建自己的 RGB Lightning Node。
  • 托管服务商：连接由 ThunderStack 等服务商专业运维的节点。
远程节点必须运行 RGB Lightning Node 0.10.0 或更高版本（例如 kaleidoswap/rgb-lightning-node:0.10.0）。
远程节点的优势：
  • 不占用本地资源
  • 7×24 可用（托管方案）
  • 配置流程更简单

​
方案 2：创建带集成节点的本地钱包

如果追求完全的控制权和隐私，可以直接在本机运行节点：
  • 按照创建新钱包指南，创建一个带集成 RGB Lightning Node 的本地钱包。
应用可以以原生二进制 (Native Binary，macOS/Linux) 方式运行节点，也可以在 Docker 容器 (Docker Container，所有平台；由应用拉取并管理容器) 中运行。 本地节点的优势：
  • 完全掌控自己的节点
  • 更强的隐私性
  • 不依赖外部服务
在 Windows 上不提供原生二进制后端。请选择「本地节点 → Docker 容器」（需要 Docker Desktop 处于运行状态），或连接远程节点。
在继续 KaleidoSwap 的配置之前，请先选择最符合你技术水平和需求的方案。

下载桌面应用

获取适用于 macOS、Windows 或 Linux 的最新 KaleidoSwap 桌面应用版本。