扫描入库
把 MP3music 目录里的歌曲导入数据库扫描入库
扫描指定目录下的全部音频文件, 写入数据库—已入库分类
按所在文件夹聚合曲库列表
0 首| ID | 封面 | 歌名 | 歌手 | 专辑 | 分类 | 音频文件 | 时长 | 播放 | 操作 |
|---|
联网补齐元信息
自动到酷狗等音源匹配封面与歌词补齐过程会联网请求, 建议每次 20~40 首, 分批执行。已存在的封面/歌词默认跳过, 勾选「强制覆盖」则重写。
播放器主题
点选即预览, 记得保存站点信息
显示在前台顶部与 Hero 区SEO / TDK
浏览器标签与搜索结果里的标题、描述这些标签由 index.php 在服务端写进 <head>，改完刷新前台即生效，不需要重新上传。
播放器行为
前台默认表现默认音效
前台首次进入时使用的音效预设10 段均衡器默认值 (dB)
播放地址加密
让前端拿不到任何真实音源地址
开启后, 播放器只会拿到 api/media.php?t=<签名令牌>。
令牌绑定曲目、有效期与客户端指纹; 酷狗等第三方真实地址只在服务器内部使用,
绝不回传浏览器。缓存目录 data/ 必须由 Web 服务器拒绝直接访问
—— Apache 下靠目录内的 .htaccess 生效; nginx 不读 .htaccess,
必须把 deploy/nginx-secure.conf 的规则加进站点配置, 否则
data/music.db 等文件可被公网直接下载 (可用下方「安全自检」验证)。
防盗链与限速
防止被外站引用 / 刷流量代理与上游安全
控制 api/proxy.php 取上游资源时的严格程度两项默认都关闭, 以兼容证书异常的音源 CDN。若你的音源都正规、 且更看重安全, 可以打开; 打开后若出现「取不到音源」, 关掉即可恢复。
安全自检
逐条探测敏感文件是否可被公网直接下载
自检会用你当前浏览器逐个请求下面这些路径 —— 这正是访客的真实视角,
会经过 CDN / 反代 / 防火墙, 比服务器自己回连更准。
重点:把目录权限改成 644 或 755 解决不了这个问题。
nginx 只要对文件有读权限就会把它下发出去, 而 PHP 又必须能读。
唯一有效的办法是让 nginx 不路由这些路径
(把 deploy/nginx-secure.conf 的规则粘进站点配置文件)。
密钥轮换与登录态
怀疑密钥已泄露时立即执行
如果 data/secret.key 曾被公网下载过, 它就必须视为已泄露:
持有该密钥的人可以伪造任意播放地址, 绕过防盗链、限速与听歌密码。
轮换后旧令牌全部作废, 已打开的播放页需刷新一次。
听歌密码
开启后进入主页需要输入密码
用于规避版权外泄: 开启后访客必须先输入密码才能进入主页,
未通过时首页只显示密码页, 曲库列表 / 播放令牌 / 歌词 / 封面接口全部拒绝访问。
关闭后无需任何密码即可正常访问。密码以 password_hash 加密存放在
data/access.json, 不会明文保存。
音乐导航
前台「音乐导航」页展示的常用音乐站点
这里维护的是前台左侧「音乐导航」里展示的站点卡片。
每个站点有名称、网址、分类、图标 (单个 emoji 或字符) 与排序;
关闭「启用」后前台不再显示, 但配置会保留。
前台点击会走 api/sites.php?visit=id 累计点击量, 可按热度排序参考。
| 排序 | 图标 | 名称 | 网址 | 分类 | 点击 | 启用 | 操作 |
|---|---|---|---|---|---|---|---|
| 加载中… | |||||||
一键导入常用站点
把常见音乐平台一次性加进来, 之后可自行删改会跳过网址已存在的条目, 不会产生重复。
操作日志
最近 200 条加载中…
数据库
当前存储驱动与连接状态
默认使用 SQLite 存储曲库 (数据文件 data/music.db, 零配置, 无需账号密码)。
若要改用 MySQL: 在 config/config.php 把 MUSIC_DB_DRIVER 设为 mysqli
并填好 MUSIC_DB_HOST / PORT / NAME / USER / PASS / PREFIX;
也可新建 config/db.php 或用环境变量覆盖。
数据库不可用时会自动退化为 JSON 文件存储, 站点仍可访问。