AudioDock：桌面端下载和服务端部署指南

萌萌哒草头将军

发布于 2025-12-31 19:27:52

2750

文章被收录于专栏：前端框架前端框架

前言

好消息，昨天发布了服务端和 web 端的 docker 包！

今天已经搞定了桌面端和服务端的自动发布！

AudioDock（声仓）是一款免费开源的音频播放器，包含桌面端、移动端、服务端。

欢迎小伙伴给我 star：https://github.com/mmdctjj/AudioDock

桌面端

正文

桌面端下载

AudioDock 的自动发布依赖于 github workflow。

我的工作流程是将 desktop 包打包成 web 端的包，

然后基于 Electron 打包成不同平台的桌面端版本，

最后将打包制品发布到 release 上，

也就是目前可以下载到桌面端版本的地方。地址：

https://github.com/mmdctjj/AudioDock/releases

选择版本

选择对应的版本安装包下载安装即可。

web端、服务端下载

本次打包，也将 docker 包发布到了 GHCR （这个是github 官方的 docker 镜像库）上！

访问不了 docker 官方仓库的可以试试这个！

# 下载服务端
docker pull ghcr.io/mmdctjj/audiodock-api:sha-ffd61f2931a14084984ef30fecde94a9cea6ffdf
# 下载 web 端（可选）
docker pull ghcr.io/mmdctjj/audiodock-web:sha-ffd61f2931a14084984ef30fecde94a9cea6ffdf

如果你是docker 官方镜像库，需要看下名称，

# 下载 web 端（可选）
docker pull ctjj/audiodock-web:0.0.1
# 下载服务端
docker pull ctjj/audiodock-api:0.0.1

❝很抱歉，我的 Docker 和 Github 名称不一样，我会尽快修改统一

使用桌面端前必须安装好服务端！

下面是我的 nas 部署的示例，希望可以帮到大家！

version: "3.8"

services:
# 1. API 后端服务 (Node.js)
api:
    platform:linux/amd64
    # docker 镜像
    image:ctjj/audiodock-api
    # GHCR 镜像
    # image: ghcr.io/mmdctjj/audiodock-api
    container_name:audiodock-api

    # 容器内部端口 (3000) 默认对内部网络开放，无需 ports 字段映射到宿主机
    # 如果要直接测试 API，可以加上 ports: - "3000:3000"
    ports:
      -"8858:3000"

    environment:
      -AUDIO_BOOK_DIR=/audio
      -MUSIC_BASE_DIR=/music
      -CACHE_DIR=/covers
      -DATABASE_URL=file:/data/dev.db

    # 挂载数据文件和缓存，使用 Docker 命名卷更安全
    volumes:
      -/volume1/audio:/audio
      -/volume1/music:/music
      -./covers:/covers
      -api-db:/data

    restart:unless-stopped
    networks:
      -audiodock-network

# 2. Web 前端服务 (Nginx) - 用于托管静态文件和反向代理
# 不需要 web 端的话可以删掉这部分
web:
    platform:linux/amd64
    # docker 镜像
    image:ctjj/audiodock-web
    # GHCR 镜像
    # image: ghcr.io/mmdctjj/audiodock-web
    container_name:audiodock-web
    ports:
      -"9958:9958"# <--- 将 Web 服务的 80 端口映射到宿主机的 8080 端口
    volumes:
      -./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      -api# 确保 API 容器先启动
    networks:
      -audiodock-network

volumes:
api-cache:# 命名卷用于缓存
api-db:# 命名卷用于 SQLite 或其他数据文件

networks:
audiodock-network:

桌面端安装之后进入需要填入服务端地址，如果后面的状态是绿色说明链接成功（鼠标点击其他地方就可以触发检查）