首次启动会在日志中打印默认用户的用户名和密码,需及时查看并修改;需从 GitHub Releases 下载对应平台压缩包并解压后再运行;使用 Docker 部署需另行参考 docs/docker_deployment 文档

./cicada start --data /path/to/cicada_data --port 8000 硬件要求按 README 说明
README 未说明硬件要求
自托管多用户音乐服务,单二进制部署,数据完全自己掌控
自托管的多用户音乐服务,用 Docker 部署后即可搭建私人音乐库,支持多账号共享播放和 PWA 移动端访问。
核心能力
- 单二进制部署,内嵌 PWA 静态资源与 ffmpeg/ffprobe
- 支持多用户并可选启用 2FA 登录
- 自定义播放队列,用户之间可分享歌单
- 记录作词人与作曲者信息
- 不收集隐私数据,数据由自己管理
容易踩的坑
内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README
- 3.11.0最新正式版2026-11-05 · 2026-11-05 11:46 UTC
Changes
Since
3.10.0:- Merge pull request #204 from mebtte/beta.v3 (57ce5c78)
- update docs (c8c90acb)
- fix: render captchas as PNG without plaintext answers (26939538)
- feat: support deployment under a base path (15250a70)
- 3.10.02026-09-08 · 2026-09-08 14:39 UTC
查看更新说明
Changes
Since
3.9.1:- Merge pull request #202 from mebtte/beta.v3 (aa5a4d09)
- feat: log ffmpeg calls with daily rotation and retention (7adfc2cf)
- feat: manage embedded tools in scratch bin (be00063e)
- fix: validate scratch path is a directory (c21f4826)
- chore: remove music cache retention startup output (af42d0b8)
- docs: explain music transcoding modes and cache migration (25a9071a)
- feat: add eager and lazy music transcoding modes (7e3cd44b)
- feat: track music cache access with independent files (290835ad)
- chore(cli): pass full Cicada commands through Air (7bcaa2d2)
- feat(cli): add configurable scratch directory and migrate legacy layout (3d34cdc9)
- feat(cli): track scratch migrations alongside data versions (3995fd86)
- fix(cli): make filesystem migration recovery safe and retryable (f46aa3b3)
- fix(cli): support cross-filesystem upload finalization (374d2a43)
- 3.9.22026-09-01 · 2026-09-01 02:51 UTC
查看更新说明
Changes
Since
3.9.0:- Merge pull request #201 from mebtte/beta.v3 (065e7adf)
- fix(pwa): improve offline cache loading and scrolling (f1e0ff26)
- fix pwa admin role update (1d393e6c)
- 3.9.12026-09-01 · 2026-09-01 02:39 UTC
这个版本没有写更新说明。
- 3.9.02026-08-20 · 2026-08-20 14:32 UTC
查看更新说明
Changes
Since
3.8.1:- Merge pull request #200 from mebtte/beta.v3 (15731d01)
- Merge branch 'codex/music-drawer-hide-missing-cover' into beta.v3 (cd52c186)
- fix(pwa): hide missing drawer artwork (8f68fa4e)
- Merge branch 'codex/admin-create-artist-error-dialog' into beta.v3 (ea8e0ecd)
- fix(pwa): prevent stale iOS media metadata on next (536721ae)
- fix(pwa): show create artist errors in dialog (13a83046)
- update readme (a1282f35)
- fix(pwa): keep media keys active while loading (6b155f58)
- merge: fix PWA radio fast next (6d97ab44)
- fix(pwa): prevent radio next queue overflow (56c06d08)
- update docs (f2756499)
- fix(pwa): keep notice close icon visible (932b3c13)
用户点评
登录用户的真实使用记录,可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
Cicada
A multi-user music service for self-hosting.

Demo
There is an online demo you can visit on https://cicada.mebtte.com, you can login by username: cicada and password: cicada@mebtte.
Features
- No privacy collection and manage data by yourself
- Single-binary deployment with embedded PWA assets and bundled
ffmpeg/ffprobe - Custom playqueue and share musicbills between users
- Multiple user and support 2FA
- Support lyricist and composer
Deploy
If you use docker, see this docs.
Download the archive for your platform from GitHub Releases. Extract and start the server:
./cicada start --data /path/to/cicada_data --port 8000
On Windows, use cicada.exe:
.\cicada.exe start --data C:\path\to\cicada_data --port 8000
On the first startup, Cicada creates a default user and prints username/password to the log. After startup, you can visit cicada on http://localhost:8000.