diff --git a/astro.config.mjs b/astro.config.mjs
index 772ccefaa..1db071d0b 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -202,6 +202,7 @@ export default defineConfig({
{ label: 'Plex', slug: 'music-providers/plex' },
{ label: 'Podcast Index', slug: 'music-providers/podcast-index' },
{ label: 'Podcast RSS Feed', slug: 'music-providers/podcastfeed' },
+ { label: 'NetEase Cloud Music', slug: 'music-providers/netease-cloud-music' },
{ label: 'Qobuz', slug: 'music-providers/qobuz' },
{ label: 'Radio Browser', slug: 'music-providers/radio-browser' },
{ label: 'Radio Paradise', slug: 'music-providers/radio-paradise' },
diff --git a/public/assets/icons/netease-cloud-music-icon.png b/public/assets/icons/netease-cloud-music-icon.png
new file mode 100644
index 000000000..e2db1c23b
Binary files /dev/null and b/public/assets/icons/netease-cloud-music-icon.png differ
diff --git a/src/content/docs/music-providers/netease-cloud-music-zh.md b/src/content/docs/music-providers/netease-cloud-music-zh.md
new file mode 100644
index 000000000..3ccd08f4f
--- /dev/null
+++ b/src/content/docs/music-providers/netease-cloud-music-zh.md
@@ -0,0 +1,62 @@
+---
+title: "网易云音乐"
+---
+
+# 网易云音乐
+
+**语言:** [English](/music-providers/netease-cloud-music/) | **中文**
+
+Music Assistant 已支持 网易云音乐。
+由 xiasi0 贡献与维护。
+
+网易云音乐是中国大陆主要流媒体平台之一,提供中文曲库、推荐内容与歌词能力。
+
+> [!NOTE]
+> - 需要网易云音乐账号。
+> - 当前该提供商依赖本地运行的 NeteaseCloudMusicApi 兼容服务。
+> - 本提供商不会绕过平台权限校验。
+
+## 功能
+
+| | |
+|:-----------------------|:---------------------:|
+| 免费订阅可用 | 否 |
+| 本地自托管媒体 | 否 |
+| 支持媒体类型 | 歌手、专辑、歌曲、歌单、电台 |
+| [发现推荐](/ui/#view-home) | 支持 |
+| 歌词 | 支持 |
+| [电台模式](/ui/#track-menu) | 支持 |
+| 最高音质 | Hi-Res FLAC(取决于上游接口返回) |
+| 登录方式 | 网易云 App 扫码登录 |
+
+### 其他
+
+- 支持搜索:歌曲、歌手、专辑、歌单
+- 支持同步:喜欢/收藏内容与用户歌单
+- 动态推荐/电台条目包括:每日推荐歌曲、每日推荐歌单、私人 FM、心动模式
+- 库同步当前按单向(网易云音乐 -> Music Assistant)使用
+
+## 配置
+
+### 后端 API 服务
+
+该提供商需要可访问的 NeteaseCloudMusicApi 兼容 HTTP 服务(默认:`http://127.0.0.1:3000`)。
+
+Home Assistant 用户可参考配套 add-on PR:
+home-assistant-addon#16
+
+### 扫码登录流程(网易云 App)
+
+1. 打开 **设置 -> 音乐源 -> 添加音乐源 -> 网易云音乐**。
+2. 将 **API base URL** 设置为你的本地 API 服务地址。
+3. 点击 **QR Login**,会弹出新的二维码页面。
+4. 使用 **网易云音乐 App** 扫码,并在 App 内确认登录。
+5. 关闭二维码页面。
+6. 回到 Music Assistant 点击 **Save**。
+
+## 合规与说明
+
+- 播放严格遵循上游返回的账号与歌曲权限。
+- 对无权益内容可能返回试听/受限播放,或返回不可播放 URL。
+- 不使用任何解锁、破解或绕过订阅限制的逻辑。
+
diff --git a/src/content/docs/music-providers/netease-cloud-music.md b/src/content/docs/music-providers/netease-cloud-music.md
new file mode 100644
index 000000000..bef23e3d5
--- /dev/null
+++ b/src/content/docs/music-providers/netease-cloud-music.md
@@ -0,0 +1,62 @@
+---
+title: "NetEase Cloud Music"
+---
+
+# NetEase Cloud Music
+
+**Language:** **English** | [中文](/music-providers/netease-cloud-music-zh/)
+
+Music Assistant has support for NetEase Cloud Music.
+Contributed and maintained by xiasi0.
+
+NetEase Cloud Music is a major streaming platform in Mainland China with a large Chinese catalog, recommendations, and lyrics support.
+
+> [!NOTE]
+> - A NetEase Cloud Music account is required.
+> - This provider currently requires a local NeteaseCloudMusicApi-compatible backend service.
+> - This provider does not bypass entitlement checks.
+
+## Features
+
+| | |
+|:-----------------------|:---------------------:|
+| Subscription FREE | No |
+| Self-Hosted Local Media | No |
+| Media Types Supported | Artists, Albums, Tracks, Playlists, Radio |
+| [Recommendations](/ui/#view-home) Supported | Yes |
+| Lyrics Supported | Yes |
+| [Radio Mode](/ui/#track-menu) | Yes |
+| Maximum Stream Quality | Hi-Res FLAC (upstream response dependent) |
+| Login Method | NetEase App QR Code |
+
+### Other
+
+- Search support for tracks, artists, albums, and playlists
+- Library sync for liked/favorited content and user playlists
+- Dynamic recommendation/radio entries include Daily songs, Daily playlists, Private FM, and Heart Mode
+- Library sync is currently one-way (NetEase Cloud Music -> Music Assistant)
+
+## Configuration
+
+### Backend API Service
+
+This provider requires a running NeteaseCloudMusicApi-compatible HTTP service (default: `http://127.0.0.1:3000`).
+
+For Home Assistant users, see the companion add-on PR:
+home-assistant-addon#16
+
+### QR Login Flow (NetEase App)
+
+1. Open **Settings -> Music Sources -> Add Music Source -> NetEase Cloud Music**.
+2. Set **API base URL** to your local API service.
+3. Click **QR Login**. A new QR page will open.
+4. Scan with the **NetEase Cloud Music app** and confirm login in the app.
+5. Close the QR page.
+6. Click **Save**.
+
+## Compliance / Notes
+
+- Playback strictly follows upstream account and track entitlement.
+- Non-entitled tracks may return preview/limited playback or no playable URL.
+- No unlock/crack/bypass logic is used for subscription-locked content.
+