一、项目介绍

1.项目简述
Musicn是一款可播放及下载高品质音乐的兼容web和命令行的工具,支持咪咕、酷狗和网易云的服务,容器支持amd64/arm64架构。

2.项目功能
工具可以在linux命令行批量下载音乐,在web页面上播放搜索后的音乐列表以及下载音乐。

3.项目开源地址
https://gitcode.com/zonemeen/musicn/overview?utm_source=csdn_github_accelerator&isLogin=1
https://gitcode.com/wy580477/musicn-container/overview?utm_source=csdn_github_accelerator&isLogin=1

二、项目搭建环境

1. 项目测试环境

A.项目搭建在腾讯云centos7.6,外网地址为43.138.153.157
Linux VM-8-12-centos 3.10.0-1160.108.1.el7.x86_64 #1 SMP Thu Jan 25 16:17:31 UTC 2024 x86_64 x86_64 x86_64 GNU/Linux

B.docker版本为26.01,docker-compose版本为v2.26.1
注意:本次实践部署环境为个人腾讯云的测试环境,若是生产环境请谨慎部署;对应开启了容器的端口,在linux下和防火墙下需开放对应端口。

2. 本次项目实施过程

使用docker下载镜像,创建好项目需要挂载的路径,通过docker-cli或者docker compose启动容器,启动容器后查看容器启动状态,查看容器的运行日志是否正常,以上全部正常执行后体验项目功能。

3.注意:docker下载镜像有可能遇到比较慢的情况,参考以下解决措施:

A.docker配置换源,进入/etc/docker的路径,如果没有就创建这个目录
cd /etc/docker/
mkdir -p /etc/docker

B.编辑配置文件
vim daemon.json   ##可以清空里面的内容:%d 然后复制下面的源进去wq保存

{
    "registry-mirrors":[
        "https://286u3d9d.mirror.aliyuncs.com"
    ]
}

C.registry-mirrors:指定了一个镜像仓库的 URL https://286u3d9d.mirror.aliyuncs.com。 这个配置项用于设置 Docker镜像的镜像仓库地址,使得在拉取和推送 Docker 镜像时能够通过该镜像仓库进行加速。这边提供的是广东广州服务器的镜源,建议个人自己去阿里云建一个个人账号,根据实际所在区获取镜源。

D.重新加载源,重启docker服务
sudo systemctl daemon-reload 
sudo systemctl restart docker

三、项目搭建前巡检

1. 检查docker是否正常运行
systemctl status docker
or
service docker status
注:我个人测试环境是使用systemctl进行管理,若有使用service管理请使用第二条的命令进行查看。   

[root@VM-8-12-centos ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Mon 2024-04-22 23:13:57 CST; 4 days ago
     Docs: https://docs.docker.com
 Main PID: 17092 (dockerd)
    Tasks: 158
   Memory: 142.3M
   CGroup: /system.slice/docker.service

若显示docker的Active是active (running),即表明docker是正常运行的。

2.一般我会使用docker-compose去管理,所以预先需要创建好yaml文件,vim docker-compose.yml,格式如下例子:

version: '3.9'
services:
    nginx:
        image: nginx
        logging:
            options:
                max-size: 1g
        restart: always
        volumes:
            - '/var/run/docker.sock:/tmp/docker.sock:ro'
        ports:
            - '80:80'

四、项目实施过程

1.根据开源项目,找到对应的镜像进行pull,若遇到很慢的情况,先检查是否网络问题以及是否已经换源。
docker pull ghcr.io/wy580477/musicn-container:latest

[root@VM-8-12-centos musicn]# docker pull ghcr.io/wy580477/musicn-container:latest
latest: Pulling from wy580477/musicn-container
4abcf2066143: Already exists 
4ca66ffdb793: Pull complete 
2f555b4e18c3: Pull complete 
f6ee91b14c47: Pull complete 
cd6ffe1a15b5: Pull complete 
252c28c1a150: Pull complete 
Digest: sha256:e4f0b7d8119ce38945479e9da4730894c255b2a30869513b13f0200572088a20
Status: Downloaded newer image for ghcr.io/wy580477/musicn-container:latest
ghcr.io/wy580477/musicn-container:latest

2.若已经下载完成显示新的一行,可以输入命令查看是否上一条命令执行成功
echo$?
若返回0,则成功;返回其他则根据实际情况重新下载或者查找原因。

3.docker下载完后,可以查看对应的镜像是否下载成功

docker images |grep musicn

[root@VM-8-12-centos musicn]# docker images |grep musicn
ghcr.io/wy580477/musicn-container   latest      aa751dad36de   3 months ago    160MB
 
4.下载成功后,编辑docker-compose.yml文件

cd /opt && mkdir musicn
vim docker-compose.yml

注:命令行 + Web 模式
version: '2'
services:
  music:
    image: ghcr.io/wy580477/musicn-container:latest
    container_name: music
    restart: always
    entrypoint: ["/sbin/tini", "--", "msc", "-q"]
    ports:
      - "13388:7478"
    volumes:
      - ./data:/data

注:仅命令行模式 (空闲时几乎不耗内存)     
version: '2'
services:
  music:
    image: ghcr.io/wy580477/musicn-container:latest
    container_name: music
    restart: always
    entrypoint: ["/sbin/tini", "--", "msc", "-q"]
    ports:
      - "13388:7478"
    volumes:
      - ./data:/data

编辑后输入wq进行保存
    
5.为了便捷启动,也可以使用docker-cli启动

命令行 + Web 模式    
docker run -d --name=music --restart=unless-stopped -v ${PWD}/musicn:/data -p 13388:7478 ghcr.io/wy580477/musicn-container:latest msc -q

仅命令行模式 (空闲时几乎不耗内存)
docker run -d --name=music --restart=unless-stopped -v ${PWD}/musicn:/data ghcr.io/wy580477/musicn-container:latest tail -f

6.启动docker-compose

docker compose up -d  

7.启动容器后,查看容器的状态是否正常  

docker ps |grep  music或者docker compose ps都可以查询
    
[root@VM-8-12-centos musicn]# docker compose ps
NAME      IMAGE                                      COMMAND                  SERVICE   CREATED          STATUS          PORTS
music     ghcr.io/wy580477/musicn-container:latest   "/sbin/tini -- msc -q"   music     12 minutes ago   Up 12 minutes   0.0.0.0:13388->7478/tcp, :::13388->7478/tcp

8.启动容器后,查看容器的日志是否正常

docker logs -f gopeed

[root@VM-8-12-centos musicn]# docker logs -f music

扫描二维码,播放及下载音乐
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▄▀▀▄▄█▀█▄█ ▄▄▄▄▄ █
█ █   █ ███▄█  ▀█▄█ █   █ █
█ █▄▄▄█ ██▄▀▄▀▀▀█▀█ █▄▄▄█ █
█▄▄▄▄▄▄▄█ █ ▀▄▀▄▀ █▄▄▄▄▄▄▄█
█▄▄▀▄▄▀▄█▀ ▄▄▀██▀ ▀▄█▀▀▀▀▄█
█ ▀██▄ ▄▄ ▀  ▀██▄▀ ▄ █ ▀▀ █
█ ▀▄ █ ▄█▀ █▄▄▀▄ █▄▄▀▀██▀▄█
█ ▄▀ █ ▄▄█▀▄ ▄█▄ ▄▄██▀▄ ▄ █
█▄██▄▄▄▄▄ ▀ ▀▀  █ ▄▄▄ █▄ ██
█ ▄▄▄▄▄ ██▄▄▄▀  █ █▄█ ▄█▀▄█
█ █   █ █ █▀█▄▀▀▄ ▄  ▄ █  █
█ █▄▄▄█ █▀█▀█▄▄▀▀█▀▀▀ █   █
█▄▄▄▄▄▄▄█▄███▄▄▄▄▄▄███▄██▄█

访问链接: http://172.24.0.2:7478/

9.${PWD}/musicn 为命令行模式下载文件存放目录,默认当前目录下 musicn 文件夹。

执行 musicn 命令:
docker exec -it musicn msc 周杰伦

# 设置 bash 命令别名方便使用,重新登陆 shell 后生效
echo "alias msc='docker exec -it musicn msc'" >> ~/.bashrc

# 查看命令帮助
msc -h

# 指定子目录 test 为下载目录
msc 周杰伦 -p ./test

# 升级版本
docker container rm musicn --force && docker pull ghcr.io/wy580477/musicn-container:latest
# 然后重新执行安装命令

# 容器内升级 (不推荐,万一我以后弃坑不更新 image 版本,可以用这个方法更新)
docker exec -it musicn npm i musicn -g

五、项目体验

注:云服务器记得放开防火墙13388!
访问地址https://43.138.153.157:13388/,欢迎点击玩一下!
ps:内网穿透搭建好了,minipc可以撑一段时间,这些测试的服务应该会保留一段时间...如果有需要体验的但是服务已经被我down了的,可以在微信公众号《零氪的云原生》私我开启!