learnedmachine/speakr

Speakr 镜像文档

镜像概述和主要用途

Speakr 是一款面向个人用户的自托管 Web 应用镜像，核心功能为音频录音转录。该镜像允许用户在本地部署应用，无需依赖第三方云服务，即可将音频文件转换为文本内容，适用于对数据隐私有要求的个人音频处理场景。

核心功能和特性

• 个人自托管：支持本地部署，数据存储在用户自有服务器或设备上，保障数据隐私与安全。
• 音频转录：专注于音频录音到文本的转换，提供便捷的转录功能。
• Web 界面：通过浏览器访问的直观界面，简化音频上传、转录管理等操作流程。
• 本地处理：音频文件在本地服务器处理，无需上传至外部服务，降低数据泄露风险。

使用场景和适用范围

• 个人音频处理：适用于转录个人会议录音、采访记录、语音笔记等音频内容。
• 隐私优先场景：对数据隐私有较高要求的用户，如需要处理敏感语音信息的场景。
• 离线使用需求：网络不稳定或需要离线处理音频的环境，通过本地部署实现无网络依赖的转录功能。

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速部署 Speakr 应用：

bash
docker run -d \
  --name speakr \
  -p 8080:8080 \
  -v ./speakr-data:/app/data \
  docker.xuanyuan.run/speakr:latest

• -p 8080:8080：将容器内 8080 端口映射到主机 8080 端口，通过 http://localhost:8080 访问 Web 界面。
• -v ./speakr-data:/app/data：挂载本地目录 ./speakr-data 至容器内 /app/data，用于持久化存储转录文件、配置数据等。

环境变量配置

可通过环境变量调整应用配置，常用变量如下：

• PORT：应用运行端口，默认值 8080。如需修改容器内端口，可设置 PORT=3000，并同步调整端口映射参数。
• DATA_DIR：数据存储目录，默认值 /app/data。如需自定义容器内数据路径，可设置 DATA_DIR=/custom/data，并相应调整数据卷挂载路径。

访问与使用

1. 部署完成后，通过浏览器访问 http://<主机IP>:8080 进入 Speakr Web 界面。
2. 在界面中上传音频文件（支持常见格式如 MP3、WAV 等，具体格式依赖应用实际支持范围）。
3. 点击转录按钮，等待处理完成后查看或下载转录文本。

注意事项

• 自托管环境需确保服务器具备足够的计算资源（CPU、内存）以支持音频转录处理，复杂音频或长时长文件可能需要更长处理时间。
• 数据卷挂载为推荐配置，避免容器重启后转录历史数据丢失。