
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址,或排查拉取失败等问题,请让 AI 先读规则再动手,只要在 AI 对话里直接发送下面这句话即可:
生成 docker pull、修改 compose 的 image,或排查拉取失败前,请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
一个简约的音乐播放器
严肃警告
- 请务必遵守 GNU Affero General Public License (AGPL-3.0) 许可协议
- 在您的修改、演绎、分发或派生项目中,必须同样采用 AGPL-3.0 许可协议,并在适当的位置包含本项目的许可和版权信息
- 禁止用于售卖或其他商业用途,如若发现,作者保留追究***责任的权利
- 若发现未遵守 AGPL-3.0 许可协议的行为,本项目将永久停更
- 感谢您的尊重与理解
Win,其他平台可自行构建Star 哦 😍i18n 支持待办
通常情况下,可以在 https://github.com/imsyy/SPlayer/releases 中获取稳定版
可以通过 GitHub Actions 工作流获取最新的开发版,目前开发版仅提供 Win 版本
https://github.com/imsyy/SPlayer/actions/workflows/build.yml
安装及配置
Docker将不在此处说明,请自行解决
bash# 构建 docker build -t splayer . # 运行 docker run -d --name SPlayer -p 7899:7899 splayer # 或使用 Docker Compose docker-compose up -d
bash# 拉取 docker pull imsyy/splayer:2.0.0-beta.5 # 运行 docker run -d --name SPlayer -p 7899:7899 imsyy/splayer:2.0.0-beta.5
以上步骤成功后,将会在本地 localhost:7899 启动,如需更换端口,请自行修改命令行中的端口号
其他部署平台大致相同,在此不做说明
本程序依赖 https://github.com/Binaryify/NeteaseCloudMusicApi 运行,请确保您已成功部署该项目,并成功取得在线访问地址
点击本仓库右上角的 Fork,复制本仓库到你的 GitHub 账号
复制 /.env.example 文件并重命名为 /.env
将 .env 文件中的 RENDERER_VITE_SERVER_URL 改为第一步得到的 API 地址
jsRENDERER_VITE_SERVER_URL = "https://example.com";
将 Build and Output Settings 中的 Output Directory 改为 out/renderer
点击 Deploy,即可成功部署
重复 ⚙️ Vercel 部署 中的 1 - 4 步骤
克隆仓库
将链接中的 example/repository.git 替换为你要克隆的实际仓库的地址
bashgit clone https://github.com/example/repository.git
安装依赖
bashpnpm install # 或者 yarn install # 或者 npm install
编译打包
bashpnpm build # 或者 yarn build # 或者 npm build
将站点运行目录设置为 out/renderer 目录
本地部署需要用到 Node.js。可前往 Node.js 官网 下载安装包,请下载最新稳定版
安装 pnpm
bashnpm install pnpm -g
克隆仓库并拉取至本地,此处不再赘述
使用 pnpm install 安装项目依赖(若安装过程中遇到网络错误,请使用国内镜像源替代,此处不再赘述)
复制 /.env.example 文件并重命名为 /.env 并修改配置
打包客户端,请依据你的系统类型来选择,打包成功后,会输出安装包或可执行文件在 /dist 目录中,可自行安装
| 命令 | 系统类型 |
|---|---|
pnpm build:win | Windows |
pnpm build:linux | Linux |
pnpm build:mac | MacOS |
特此感谢为本项目提供支持与灵感的项目
本项目部分功能使用了网易云音乐的第三方 API 服务,仅供个人学习研究使用,禁止用于商业及非法用途
同时,本项目开发者承诺 严格遵守相关****和网易云音乐 API 使用协议,不会利用本项目进行任何违法活动。** 如因使用本项目而引起的任何纠纷或责任,均由使用者自行承担。本项目开发者不承担任何因使用本项目而导致的任何直接或间接责任,并保留追究使用者违法行为的权利
请使用者在使用本项目时遵守相关******,不要将本项目用于任何商业及非法用途。如有违反,一切后果由使用者自负。 同时,使用者应该自行承担因使用本项目而带来的风险和责任。本项目开发者不对本项目所提供的服务和内容做出任何保证
感谢您的理解
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
不支持 push
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务