Musicn：Docker 部署音乐下载器

bdzxb 字数: 2601 阅读耗时: 6 分钟 2026/10/28 2026/10/28 博客独享热度: 1 评论: 0

本文属于「自托管 Docker 部署实战」系列（共 35 篇），第 24 篇。示例中的 IP（192.0.2.10）、域名（example.com）、密码均为占位符，请按实际环境替换。

它是什么

Musicn 是一个自托管音乐搜索/下载工具：在网页里搜索歌曲、选择音质，下载到本地目录，适合给家庭媒体库补歌。

它基于 msc 命令行封装，容器启动时用 msc -q 拉起 Web 服务，默认端口 7478。

前置条件

一台 Linux 服务器（1C512M 起）；
已安装 Docker 与 Compose v2；
下载目录要留足空间（无损专辑很占地方）。

curl -fsSL https://get.docker.com | sh
mkdir -p /srv/docker/active/musicn && cd /srv/docker/active/musicn

镜像地址

ghcr.io/wy580477/musicn-container:latest

目录结构

/srv/docker/active/musicn/
├── docker-compose.yml
└── data/                 # 下载的音乐与缓存

部署步骤

# docker-compose.yml
services:
  musicn:
    image: ghcr.io/wy580477/musicn-container:latest
    container_name: musicn
    restart: always
    ports:
      - "7478:7478"
    volumes:
      - ./data:/data
    entrypoint: ["/sbin/tini", "--", "msc", "-q"]

docker compose up -d
docker compose logs -f --tail=100

打开 http://<SERVER_IP>:7478，搜索歌曲并选择下载目录。

关键配置

项	说明
`7478`	Web 端口
`./data`	下载目录与缓存，必须持久化
`entrypoint`	`msc -q` 启动 Web 模式，不要删掉

注意事项

版权风险：只下载你有权获取的内容，公开传播可能侵权；
搜索/下载依赖第三方音乐平台接口，平台改版就会失效，等上游更新；
下载目录属主要与容器内用户一致，否则写文件会失败；
无损音乐体积大，定期清理或在媒体库侧做去重；
服务无认证，别直接暴露公网。

备份与升级

# 备份下载目录（按需，体积可能很大）
tar czf "musicn-data-$(date +%F).tar.gz" ./data

docker compose pull
docker compose up -d

升级后搜不到歌，多半是平台接口变了，关注项目更新。