lsiodev/audacity

linuxserver/audacity

镜像概述和主要用途

Audacity 是一款易于使用的多轨音频编辑器和录音机，由志愿者团队开发并开源。LinuxServer.io提供的此Docker镜像将Audacity封装为容器化应用，基于KasmVNC技术支持通过Web浏览器访问，同时具备LinuxServer.io容器的核心特性，如用户权限映射、定期更新和安全加固，适用于需要便捷部署音频编辑环境的用户。

!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/audacity-logo.png

核心功能和特性

• 定期更新：应用和基础镜像定期更新，确保功能最新和安全性
• 用户权限映射：通过PUID/PGID参数轻松配置容器内用户权限，避免权限冲突
• KasmVNC支持：基于Docker Baseimage KasmVNC，提供Web浏览器访问界面，支持HTTP/HTTPS
• 灵活配置：支持自定义端口、身份验证、子文件夹代理等多种配置选项
• 安全加固：每周基础OS更新，跨生态系统共享通用层以减少空间占用和 downtime

支持的架构

该镜像利用Docker manifest实现多平台支持，仅支持以下架构：

拉取 lscr.io/linuxserver/audacity:latest 将自动获取适合您架构的镜像。

应用设置

应用可通过以下地址访问：

• [***]
• [***]

KasmVNC基础容器的通用选项

本容器基于https://github.com/linuxserver/docker-baseimage-kasmvnc%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BB%A5%E4%B8%8B%E9%A2%9D%E5%A4%96%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%92%8C%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE%EF%BC%9A

可选环境变量

可选运行配置

无损模式

通过将"Stream Quality"预设改为"Lossless"，容器可向浏览器传输真无损图像，详情见技术背景。非本地访问需使用3001 HTTPS端口；若通过反向代理访问3000端口，需设置特定 headers，详见https://github.com/linuxserver/docker-baseimage-kasmvnc#lossless%E3%80%82

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  audacity:
    image: lscr.io/linuxserver/audacity:latest
    container_name: audacity
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=audacity \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/audacity:latest

参数说明

容器参数格式为<外部>:<内部>，以下是主要参数说明：

环境变量文件（Docker secrets）

可通过FILE__前缀从文件加载环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

此命令将从/run/secrets/mysecretpassword文件内容设置PASSWORD环境变量。

应用运行的Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。umask通过减法调整权限，而非直接设置权限，详情参考umask说明。

用户/组标识符

使用卷(-v参数)时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机卷目录所有者与指定ID一致。

查看当前用户的ID：

bash
id username
# 输出示例：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=audacity&query=%24.mods%5B%27audacity%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([]

可通过https://github.com/linuxserver/docker-mods%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E8%87%B3%E5%8F%AF%E7%94%A8mod%E5%88%97%E8%A1%A8%E3%80%82

支持信息

• 容器运行时Shell访问：docker exec -it audacity /bin/bash
• 实时查看容器日志：docker logs -f audacity
• 查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' audacity
• 查看镜像版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/audacity:latest

更新信息

大部分镜像为静态版本，需更新镜像并重建容器以更新应用。以下是更新方法：

通过Docker Compose

• 更新所有镜像：docker-compose pull
• 更新单个镜像：docker-compose pull audacity
• 重建容器：docker-compose up -d（或docker-compose up -d audacity重建单个容器）
• 清理旧镜像：docker image prune

通过Docker Run

• 更新镜像：docker pull lscr.io/linuxserver/audacity:latest
• 停止容器：docker stop audacity
• 删除容器：docker rm audacity
• 使用原参数重建容器（配置存储在/config卷中，数据会保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅推荐用于忘记原始参数时）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once audacity

注意：不推荐使用自动更新工具，建议使用Docker Compose管理容器。

镜像更新通知 - Diun

推荐使用Diun接收更新通知，不建议使用自动更新工具。

本地构建

如需修改镜像用于开发或自定义：

bash
git clone https://github.com/linuxserver/docker-audacity.git
cd docker-audacity
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/audacity:latest .

在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

然后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 05.05.23：Audacity启动时默认全屏
• 18.03.23：基于KasmVNC基础镜像重构
• 13.12.22：基于Jammy重构
• 14.09.21：使用官方AppImage，仅支持x86_64架构（armhf和aarch64用户可保留3.0.2版本，但不再更新）
• 07.04.21：初始发布