当前位置：首页 > news >正文

如何快速搭建专属私人音乐服务器：Any Listen完整部署指南

news 2026/6/15 7:41:37

如何快速搭建专属私人音乐服务器：Any Listen完整部署指南

【免费下载链接】any-listenA cross-platform private music playback service项目地址: https://gitcode.com/gh_mirrors/an/any-listen

你是否曾梦想拥有一个完全属于自己的音乐空间？一个不受平台限制、不担心版权下架、可以随时随地访问的私人音乐库？Any Listen正是这样一个开源解决方案，它让你能够在几分钟内搭建起专属的音乐播放服务。

为什么选择Any Listen？

在流媒体平台盛行的今天，我们常常面临这样的困扰：喜欢的歌曲突然下架、不同平台需要来回切换、网络不佳时无法流畅播放。Any Listen解决了这些痛点，它不仅仅是一个播放器，更是一个完整的音乐管理系统。

核心价值体现在：

🎵完全自主控制：你的音乐库你做主，无需担心版权变更
🌐跨平台访问：支持桌面端和网页端，随时随地享受音乐
📁多源支持：本地文件、WebDAV远程存储一网打尽
🎨个性化体验：丰富的主题和音效定制选项
🔧扩展性强：插件系统让功能无限扩展

五分钟快速上手体验

让我们从一个最简单的场景开始：你想在本地电脑上快速体验Any Listen。跟着下面三个步骤，五分钟内就能听到自己的音乐！

第一步：获取项目代码

打开终端，执行以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/an/any-listen.git cd any-listen

第二步：一键安装依赖

Any Listen使用pnpm作为包管理器，如果你还没有安装pnpm，可以先用npm安装：

npm install -g pnpm

然后安装项目依赖：

pnpm install

第三步：构建并启动服务

构建网页版服务：

pnpm run build:web

进入构建目录并启动：

cd build mkdir data node index.cjs

现在打开浏览器访问http://localhost:9500，输入默认密码123456a，你的私人音乐服务器就已经在运行了！

深度配置：打造个性化音乐空间

基础体验完成后，你可能想要根据自己的需求进行更精细的配置。Any Listen提供了灵活的配置选项，让我们一步步来优化。

配置文件详解

在build/data目录下创建config.cjs文件，这是服务的主要配置文件：

const config = { // 服务绑定配置 port: '9500', // 服务端口，默认9500 bindIp: '127.0.0.1', // 绑定IP，设置为0.0.0.0可允许局域网访问 // 安全设置 password: 'mySecurePassword123', // 修改为你的安全密码 'cors.enabled': true, // 启用跨域，方便前端调用 'cors.whitelist': [ // 允许跨域的域名 'http://localhost:3000', 'https://music.mydomain.com' ], // 音乐目录配置 allowPublicDir: [ '/home/username/Music', // Linux/Mac音乐目录 'D:\\MyMusic' // Windows音乐目录 ], // 代理和网络设置 httpProxy: 'http://127.0.0.1:7890', // 如果需要代理访问外部资源 'upstreamProxy.enabled': false, // 是否作为反向代理 // 日志和调试 httpLog: true, // 记录HTTP请求日志 'extension.ghMirrorHosts': [ // 扩展商店镜像地址 'https://ghproxy.com' ] }; module.exports = config;

环境变量配置

如果你更喜欢使用环境变量，Any Listen也完全支持：

# 启动时设置环境变量 PORT=8080 \ BIND_IP=0.0.0.0 \ LOGIN_PWD=myPassword \ ALLOW_PUBLIC_DIR=/music,/audio \ node index.cjs

关键环境变量说明：

PORT：服务监听端口
BIND_IP：绑定地址，0.0.0.0允许所有IP访问
LOGIN_PWD：登录密码
ALLOW_PUBLIC_DIR：允许访问的音乐目录，逗号分隔
DATA_PATH：数据存储路径，默认为./data
LOG_PATH：日志文件存储路径

Docker部署：生产环境的最佳选择

对于正式的生产环境，我们强烈推荐使用Docker部署。这不仅简化了部署流程，还确保了环境的一致性。

单机Docker部署

docker run -d \ --name any-listen \ -p 8080:9500 \ -v /path/to/your/music:/music:ro \ -v /path/to/data:/server/data \ -e PORT=9500 \ -e BIND_IP=0.0.0.0 \ -e LOGIN_PWD=your_password \ -e ALLOW_PUBLIC_DIR=/music \ lyswhut/any-listen-web-server:latest

Docker Compose部署

创建docker-compose.yml文件：

version: '3.8' services: any-listen: image: lyswhut/any-listen-web-server:latest container_name: any-listen ports: - "8080:9500" volumes: - ./music:/music:ro - ./data:/server/data environment: - PORT=9500 - BIND_IP=0.0.0.0 - LOGIN_PWD=${LOGIN_PASSWORD} - ALLOW_PUBLIC_DIR=/music restart: unless-stopped

然后启动服务：

# 设置密码环境变量 export LOGIN_PASSWORD=your_secure_password # 启动服务 docker-compose up -d

高级功能配置指南

音乐库管理技巧

Any Listen支持多种音乐源管理方式：

本地音乐库：直接扫描本地文件夹，自动识别音频文件
WebDAV远程存储：连接NAS或云存储服务
智能分类：根据专辑、艺术家、流派自动整理

扩展插件系统

通过扩展管理器，你可以安装各种功能插件：

歌词匹配插件：自动为歌曲匹配歌词
封面下载插件：从网络获取专辑封面
音效增强插件：提供均衡器、混响等音效

多用户支持配置

虽然Any Listen主要面向个人使用，但通过适当的配置可以实现家庭成员共享：

// 在config.cjs中添加 const config = { // ... 其他配置 multiUser: { enabled: true, users: [ { username: 'user1', password: 'pass1' }, { username: 'user2', password: 'pass2' } ] } };