Audion：本地音乐播放器

项目简介

Audion 是一款注重隐私的开源本地音乐播放器，它把 Spotify 式的使用体验带到你自己的音乐库：无需联网、没有追踪，完全离线运行。界面由 Svelte 构建，底层基于 Tauri 2.0、Rust 与 SQLite。项目提供 Windows、macOS、Linux 桌面版以及 Android 版。

主要功能

音乐管理

• 自动扫描本地音乐文件夹并提取元数据
• 智能播放列表与播放队列管理
• 支持 FLAC、MP3、AAC、ALAC 等主流音频格式，Opus 由原生解码器支持

歌词

• 从 LRCLIB 与 Musixmatch 获取实时同步歌词
• 逐字卡拉 OK 式高亮
• 歌词本地缓存，离线也能显示

Android Auto

• 在车机屏幕上浏览曲库、控制播放与队列
• 支持随机播放、循环与冷启动

个性化

• 深色 / 浅色主题与自定义强调色
• 全屏模式、迷你播放器、键盘快捷键

插件

• 使用 JavaScript / WASM 插件扩展功能，详见 PLUGINS.md

自托管服务器

• audion-server-docker 提供 Rust 编写的流媒体服务端与响应式 Svelte 前端，可把曲库部署在家用服务器或 VPS 上，供 Audion 客户端远程串流

安装与使用

从 Releases 页面下载对应安装包：

• Windows： Audion_x64-setup.exe
• macOS： Audion.dmg
• Linux（AppImage）： Audion-x86_64.AppImage
• Linux（Flatpak）： audion_<version>_linux.flatpak
• Android： Audion.apk

Arch Linux 及衍生版可通过 AUR 安装（社区维护的二进制包）：

yay -S audion-bin
# 或
paru -S audion-bin

首次运行

1. 启动 Audion
2. 点击「Add Music Folder」并选择你的音乐目录
3. 等待扫描完成
4. 开始播放

自托管服务器（Docker）

audion-server-docker 目录中提供了预配置的 docker-compose.yml，请先确认其中的账号、密码与密钥：

services:
  audion-server:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      - AUDION_ADMIN_USER=admin
      - AUDION_ADMIN_PASSWORD=securepasswordhere # Change this!
      - AUDION_JWT_SECRET=your-secret-key-here
      - AUDION_DATA_DIR=/data

启动服务：

cd audion-server-docker
docker compose up --build -d

随后在客户端设置中进入 Server Connection，选择 Custom Server，填入服务器地址（如 http://your-server-ip:8080）与凭据，即可远程串流、同步曲库。

从源码构建

需要 Node.js 18+、最新版 Rust 与 Tauri CLI：

git clone https://github.com/dupitydumb/Audion.git
cd audion
npm install
npm run tauri dev    # 开发模式
npm run tauri build  # 生产构建

技术栈：Tauri 2.0、SvelteKit、Rust、SQLite。

注意事项

• 项目以 GPL-3.0-or-later 协议开源，使用与分发请遵守该协议。
• 远程串流、曲库同步等功能需要自行部署 audion-server-docker 服务端，并在客户端中配置服务器地址与凭据。
• 自建服务端部署时务必修改默认的 AUDION_ADMIN_PASSWORD 与 AUDION_JWT_SECRET。
• 更多信息可访问项目主页 https://audionplayer.com 。

---

本作品整理自 GitHub 开源项目 dupitydumb/Audion，原作者 @dupitydumb，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。