Risuai

环境要求

• Docker 与 Docker Compose（使用 Docker 方式时需要）
• 可访问 raw.githubusercontent.com 的网络（Docker 方式会拉取 docker-compose.yml）
• 现代浏览器（通过 Web 访问 Risuai）
• 桌面版需从 GitHub Releases 下载对应系统的安装包

安装与启动步骤

1. 1选择使用方式

   README 给出三种安装途径：官网 risuai.net（推荐）、GitHub Releases 下载桌面版、Docker 自建，按需选一种即可。

2. 2官网直接使用

   不想本地安装可直接打开官网使用，无需 Docker 或下载安装包，适合快速体验。

3. 3下载桌面版

   访问 GitHub Releases 页面，按自己的操作系统下载对应安装包并安装，获得跨平台桌面体验。

4. 4Docker 一键启动

   用 README 提供的一行命令拉取 docker-compose.yml 并后台启动容器，适合 Web 托管场景。

   curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d

   复制

5. 5访问 Web 界面

   容器启动后，在浏览器打开 http://localhost:6001 即可进入 Risuai 界面。

如何确认成功

浏览器访问 http://localhost:6001，能正常显示 Risuai 界面即表示启动成功。

常见问题

注意事项

• README 明确推荐优先使用官网方式，Docker 只是可选方案。
• Docker 方式默认访问地址为 http://localhost:6001，请勿自行改动。
• docker-compose.yml 从 GitHub main 分支实时拉取，使用时需保证网络可访问 raw.githubusercontent.com。