构建时间: 2026-11-04T11:35:00Z
新手安装指南

安装 YuE2

回答六个简短问题。我们会根据你的选择给出一套明确的安装方案,并用简单语言解释每一步。

开发快照 · 滚动 latest
YuE2 当前只发布 CUDA 镜像 latest,尚无稳定应用摘要或内置模型的完整/tiny 变体。启动前请下载约 4.34 GB 的 GGUF 模型。

告诉我们这台电脑的情况

答案只保留在浏览器中,不会提交或存储到我们的服务器。

操作系统
电脑硬件
镜像来源
谁可以打开它?

安装 Docker

从官方指南下载 Docker Desktop,使用推荐的 WSL 2 选项安装,然后打开 Docker 并等待引擎启动: Docker Desktop for Windows ↗.

打开命令窗口

选择任务栏上的 Windows 搜索,输入 PowerShell,然后打开 Windows PowerShell: .

粘贴以下检查命令并按 Enter:

检查 Docker
docker version

应同时看到 Client 和 Server 部分。如果缺少 Server,请打开 Docker 并等待启动完成。

下载并启动 YuE2

复制完整的单行命令,粘贴到同一窗口并按 Enter。首次下载可能较大,请保持窗口打开。

生成的命令
docker run -d --name yue2 --restart unless-stopped -p 127.0.0.1:8087:8087 --gpus all --mount "type=bind,source=$($PWD.Path)\data\models,target=/models,readonly" hangrylabs/yue2:latest

打开 YuE2

等待应用显示已就绪,然后选择此按钮:

在 localhost:8087 打开 YuE2 ↗

先下载模型并启动 Docker,再打开 Create。输入音乐提示和歌词,选择 Generate。Library 将歌曲保存在当前浏览器中,请导出需要长期保留的作品。

如果页面尚未打开,请再等一分钟后重试。

以后常用的命令

需要时重新打开 PowerShell 或 Terminal 并使用以下命令。

停止
docker stop yue2
再次启动
docker start yue2
查看启动消息
docker logs -f yue2

SHA-256 摘要标识一个确切构建,并不保证其安全更新足够新。不可变版本不会加入后续修复。选择前请查看发布说明和未解决的安全公告,必要时使用更新的已发布构建。 发布与安全说明 ↗

这些选择改变了什么?

完整镜像包含模型资源,首次拉取后最适合离线使用。精简镜像会在首次使用时下载模型。Docker Hub 和 GHCR 是官方来源;1ms 是可选的第三方镜像服务。本机访问绑定到 127.0.0.1;家庭网络访问会在所有接口发布端口,只应在可信私有网络使用。