cicada

mebtteGPL-3.0活跃维护

自托管的多用户音乐服务,用 Docker 部署后即可搭建私人音乐库,支持多账号共享播放和 PWA 移动端访问。

🎵 💻 📱 A multi-user music service for self-hosting.

3.11.0发布于 2026-11-05 11:46 UTC1,113star79fork同步于 2026-11-10 17:53 UTC

怎么上手

由 README 提炼,执行前请确认
./cicada start --data /path/to/cicada_data --port 8000
硬件要求按 README 说明

README 未说明硬件要求

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

自托管多用户音乐服务,单二进制部署,数据完全自己掌控

自托管的多用户音乐服务,用 Docker 部署后即可搭建私人音乐库,支持多账号共享播放和 PWA 移动端访问。

核心能力

  • 单二进制部署,内嵌 PWA 静态资源与 ffmpeg/ffprobe
  • 支持多用户并可选启用 2FA 登录
  • 自定义播放队列,用户之间可分享歌单
  • 记录作词人与作曲者信息
  • 不收集隐私数据,数据由自己管理

容易踩的坑

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

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本3.11.0
  1. 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)
  2. 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. 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)
  4. 3.9.12026-09-01 · 2026-09-01 02:39 UTC

    这个版本没有写更新说明。

  5. 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 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Cicada

    A multi-user music service for self-hosting.

    version license

    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.

    License

    GPL