本文基于 Jamulus 官方网站(jamulus.app/zh-CN)的用户手册、入门指南、FAQ、故障排除与服务器管理手册整理,全面介绍这款免费开源的”在线乐队”软件的核心功能与各项设置。
一、Jamulus 是什么?
一句话:Jamulus 让你和朋友、乐队成员,或者任何在网上认识的音乐人,通过互联网实时一起演奏、排练或即兴 Jam。
- 完全免费、开源(GPLv2),由 Volker Fischer 及社区贡献者开发,前身为 llcon;
- 跨平台:Windows 10+、macOS 10.11+、Linux;Android / iOS 也可用但仍是实验性;
- 官网当前最新版本为 3.12.5;
- 用普通宽带连接即可获得高品质、低延迟的声音;
- 全球范围内被合唱团、摇滚乐队、民间/古典音乐家、学校和大学用于远程课程与排练。
工作原理:Jamulus 遵循经典的客户端–服务器架构。每个人的音频发送到服务器,在服务器上统一混合处理,再分发回每个客户端。因此任何两个人之间”能否合拍”取决于各自到服务器的距离——这也是选服务器时优先看 ping 的原因。
⚠️ 官方明确的”没有”
- 没有视频:只传音频。想看到人可以另开 Jitsi / Zoom,但视频会明显落后于音频;
- 没有节拍器/强制同步:靠人对齐。想合拍只能压低延迟(建议 30–50ms 内)+ 全员遵守”黄金法则”;
- 没有密码/身份验证:公共目录里的服务器任何人都可连接,规则靠管理员在欢迎消息里声明。
二、硬件与环境要求(决定成败的三件事)
官方入门页的原话是”至少需要”:
其它注意事项:外部音频硬件在启动 Jamulus 之前插好;开始前关闭其他占用声卡的程序(浏览器、会议软件等),从最简单的配置开始。
三、核心功能详解
3.1 黄金法则(Golden Rule)
🔑 黄金法则:连接服务器后,只听”从服务器返回的自己”,不要听本地直通的自己。
原因:当所有人都听服务器回来的混音时,大家听到的彼此是同步的;只要有一个人在听自己的本地信号,他就会不自觉地越打越慢,整个乐队就散了。原声乐器或歌手很难完全排除本地声,官方建议至少用封闭式耳机、把音量开到足够大来掩蔽自己的直达声。
3.2 主窗口:一目了然的状态区
- Ping:网络延迟(ms),越低越好。选服务器时尽量选 ping < 50ms;
- 延迟(Latency)灯:由当前 ping + 音频缓冲设置算出的整体延迟
- 🟢 绿色:非常适合即兴演奏
- 🟡 黄色:还能排练,但更难合拍
- 🔴 红色:延迟太大,别指望合奏
- 抖动(Jitter)灯:红灯 = 音频流被打断。原因可能是抖动缓冲太小、声卡缓冲太小、上下行流量超出带宽、或客户端/服务器 CPU 满载;
- 输入电平表:两个立体声通道的输入电平,注意别削波(削波 LED 会亮,声音会失真);
- 静音我自己:切断发往服务器的音频。你可以继续听到自己并看到电平,但别人听不到——注意别人不会知道你把自己静音了;
- 混响:给本地单声道通道(或立体声两通道)加混响。用通道选择器指定作用在左/右,再推推子控制混响量;
- 聊天:给所有已连接客户端发送文字,新消息会自动打开聊天窗口(可在设置里加声音提示)。
3.3 服务器混音器:像调音台一样工作
连接后,每个用户(包括你自己)占一条通道:
- 推子:调整”你听到的音量”,不影响别人听到的;
- VU 表:显示对方正在发送的输入电平;
- 声像(Pan):立体声/立体声输出模式下出现(按住 Shift 单击重置);
- 静音图标:如果你推子上方出现对方的静音图标,说明对方听不到你(你被静音、被 solo 排除、或被对方推到 0);
- 独奏(Solo):只听某几个人,其余全部静音;被 solo 者会看到你这边的静音图标;
- 分组(Grp):最多可定义 8 个组;拖动组内任一推子,整组同幅度移动。Shift 单击拖动可临时隔离某通道。大编制(弦乐/管乐团)必备;
- 录音提示:若服务器管理员开启了录音,混音器上方会出现”正在被录音”的横幅。
通道顺序也有讲究:新版客户端(3.12.0+)连接新版服务器(3.5.5+)时,自己的推子固定在最左侧;否则自己会排在已有参与者之后。”视图”菜单可按名称、乐器、城市、分组、通道号排序(按通道排序快捷键 Ctrl+E,配 MIDI 控制器时强烈建议)。
混音预设可保存:文件 > 加载/保存混音器通道设置,可以把推子/静音/声像/独奏整套存成文件,排练时随时加载(甚至演奏中),也支持拖放到混音器窗口加载。每支乐队存一份预设,切换排练对象就是一键切混音。
其他实用命令:
- 编辑 > 清除所有存储的独奏/静音设置(Jamulus 会记住你对每个人的 solo/mute,即使对方离开重连也自动生效);
- 编辑 > 将所有推子设定为新的客户端音量;
- 编辑 > 自动调整所有推子(按音量一次性配平,大合奏热身时很有用)。
四、连接服务器
点”连接”打开连接设置窗口,列表会显示每台服务器的 ping 距离、当前人数/上限、地点和版本:
- 永久服务器(上架超过 24 小时)以粗体显示;
- 目录下拉按流派分类(摇滚/爵士/古典/民谣/合唱等),可按名称或地点过滤;输入
#只显示有人的服务器;勾选”显示所有音乐家”能看到具体占用者; - 知道私有服务器地址的话,直接在”服务器地址”栏填
host:port(默认端口 22124;IPv6 要写成[::1]:22124这样的方括号形式)。该栏还会记住最近用过的地址。
建议第一次先连一个空服务器测试设置,确认自己听到的是”服务器回来的自己”(测试方法见第七节),再进入正式排练。
五、关键设置逐项说明(设置窗口)
5.1 我的个人资料
设置 > 我的个人资料:填写别名/名称(显示在推子下方)、乐器、国家/城市、技能等级。乐器和国家会显示为图标,技能等级决定推子标签的背景颜色,城市显示在推子标签的工具提示里。
5.2 界面类设置
- 皮肤:部分皮肤专为大编制设计;
- 仪表样式:音频表的视觉风格,与所选皮肤相互独立;
- 混合器的行:一屏显示多少行通道,大编制时调大;
- 音频警报:有人加入服务器、收到新聊天消息时的声音提示。
5.3 音频/网络设置(最核心)
设备:Windows 下选择 ASIO 驱动(声卡);所选驱动无效会报错并回退到上一个有效驱动。macOS 下分别选择输入/输出硬件。输入/输出通道映射:多通道声卡可以为 Jamulus 的左/右通道分别指定不同的物理通道。
音频通道模式,三选一:
| 模式 | 行为 | 适用场景 |
|---|---|---|
| 单声道 | 收发各 1 通道 | 麦克风单人 |
| 单声道输入 / 立体声输出 | 发送单声道,接收立体声 | 一个输入插乐器、一个插麦克风 |
| 立体声 | 收发各 2 通道 | 键盘立体声、需要宽声场 |
注意:立体声会提高数据速率(要盯上传带宽);官方还建议——每个声部/人最好各开一个客户端实例并各用独立 ini 文件,而不是靠内置的单声道转立体声混音器凑数。
音频质量:越高音质越好,数据速率也越大。原则永远是:别让上行超出你的实际上传速度(可用 librespeed.org 之类的工具测试)。
缓冲延迟,基础中的基础:
| 缓冲 | 说明 |
|---|---|
| 64 samples | 延迟最低,但不是所有声卡都支持 |
| 128 samples | 首选设置,绝大多数声卡可用 |
| 256 samples | 只在很慢的电脑或较慢网络下使用 |
有些驱动不允许在 Jamulus 里修改(设置变灰):Windows 点”ASIO 设置”按钮进驱动面板改;Linux/JACK 用 QJackCtl 改缓冲区大小并重启 JACK,PipeWire 则改 Quantum 参数。缓冲越小延迟越低,但红灯(丢包)概率越高——这是音质与延迟的权衡。
抖动缓冲区:补偿网络和声卡的定时抖动。可为本地客户端和远程服务器分别手动设置,也可勾选自动(勾选后大小推子被禁用)。缓冲越大越稳、延迟越高。本地抖动缓冲下方的灯变红 = 溢出/欠载,音频流中断。
小型网络缓冲区:只在声卡缓冲小于 128 samples 时生效,更小的网络包 = 更低延迟,但网络负载和丢包概率上升。官方提示:遇到高延迟或音质差可尝试启用,但禁用通常音质更好。
音频流速率:由当前音频包大小和压缩设置决定,实时显示,用来核对上传带宽。
5.4 高级设置
- 自定义目录:内置目录之外的目录地址(host:port);
- 新客户端级别:新用户接入时的默认推子百分比。开放排练时设成 10 之类的小值,可以防止陌生人的音量突然炸场(配合”编辑 > 将所有推子设定为新客户端音量”一键配平);
- 输入提升:设备增益太小就用这个拉起来;
- 反馈保护:连接后前三秒检测反馈啸叫/噪音,检测到会提示并自动按下”静音我自己”;
- 输入平衡:左右本地通道的相对电平;单声道信号下相当于声像——比如麦克风在右通道、乐器在左通道且音量大得多,就用它来平衡。
从 3.7.0 起 macOS / Linux / Windows-JACK 版支持;3.12.0 起 Windows 的 ASIO 版也支持。勾选”MIDI-in”启用:
- MIDI Device 下拉选择设备(Windows 非 JACK 版没选过时会自动连接所有可用设备);
- MIDI parameters:一个全局 MIDI 通道(0 = 所有通道)+ 每类控件(推子/声像/独奏/静音)的”首个 CC 号 + 连续数量”。可以直接填数字,或用 Learn 按钮(点 Learn → 动一下控制器上的推子/旋钮,自动识别并保存);
- 例:首个 CC = 0、数量 = 8 → CC 0–7 控制 8 条通道的推子;
- Pick-up Mode:物理推子位置和软件不一致时,先”追上”再接管,防止音量跳变;
- 按钮注意:Jamulus 不回传按钮状态,控制器要设成 toggle 模式(开 = CC 值 ≥64,关 = <64),LED 自己维护;
- 启用 MIDI 后每个客户端名字前会加通道号;配合”按通道排序”(Ctrl+E)可保证推子条顺序与硬件一一对应。
命令行写法(Korg nanoKONTROL2 经典配置:8 滑块控推子、8 旋钮控声像、8 独奏、8 静音):
--ctrlmidich "0;f0*8;p16*8;s32*8;m48*8;dnanoKONTROL2"
控制字母:f=推子、p=声像、s=独奏、m=静音、o=静音我自己、u=启用 pick-up、d=指定设备名。
5.6 备份设置
设置文件在版本之间不向后兼容,回退旧版本前必须还原:
- Windows:%APPDATA%Jamulus 文件夹里的 .ini 文件;
- macOS(3.8.1+ 签名安装版):
~/Library/Containers/app.jamulussoftware.Jamulus/Data/.config/Jamulus/; - 其他平台:
find ~ -name Jamulus.ini -ls。
注意:Jamulus 运行时不要备份/恢复设置文件;不建议手动编辑;退出后删除 ini 即可恢复全部默认设置。
常用参数:
| 参数 | 作用 |
|---|---|
-c host[:port] |
启动时自动连接指定服务器 |
-M |
静音自己的外发流(别人听不到我) |
-i file.ini |
指定配置文件(多实例/多乐队必备) |
-n |
无 GUI(headless 模式) |
-p 22124 |
本地 UDP 端口 |
-Q 128 |
QoS DSCP 字段(默认 128 = CS4,Windows 忽略) |
--clientname |
窗口标题 / JACK 客户端名 |
--jsonrpcport 等 |
启用实验性 JSON-RPC API(仅本机访问) |
JSON-RPC 仍处于实验阶段,但对自动化场景(无 GUI、外部程序联动)很有价值。
六、进阶:自己架一台服务器
不自建也能玩——公共目录里就有现成服务器。自建有三种模式:
默认模式,不上目录,只有知道地址的人能连。家用需要端口转发。
注册进内置目录,任何人都能发现并连接。通常不需要端口转发——服务器主动向目录发起出站连接,目录定期”ping”让路由器保持端口打开。单个目录最多注册 150 台服务器。
自己当目录服务器,适合线上活动、音乐协会、学校排课等多服务器场景。
内置目录地址一览:
| 类型 | 地址:端口 |
|---|---|
| 任意类型 1 / 2 / 3 | anygenre1/2/3.jamulus.io(22124 / 22224 / 22624) |
| 摇滚 | rock.jamulus.io:22424 |
| 爵士 | jazz.jamulus.io:22324 |
| 古典 / 民谣 | classical.jamulus.io:22524 |
| 合唱 | choral.jamulus.io:22724 |
(新版支持 DNS SRV 记录,可以只填主机名不填端口。)
注册服务器的最小命令:
jamulus-headless --nogui --server
--directoryaddress anygenre1.jamulus.io:22124
--serverinfo "我的乐队;北京;CN"
常用服务器选项:-w 欢迎消息(支持 HTML)、-L 连接前显示协议窗口、-u 最大客户端数、-T 多线程、-P 延迟声像(更接近人耳听感的立体声)、-d 服务器重启后强制客户端手动重连。
录音:-R 目录 开启录音,输出 Audacity 的 .lof 和 REAPER 的 .rpp(每轨分文件,用对应软件打开);录音期间客户端会显示红色横幅。SIGUSR1 = 开启新一段录音,SIGUSR2 = 开关录音,也可以用(实验性)JSON-RPC 控制。
Linux 无头服务器(systemd):
curl https://raw.githubusercontent.com/jamulussoftware/jamulus/main/linux/setup_repo.sh > setup_repo.sh
chmod +x setup_repo.sh
sudo ./setup_repo.sh && sudo apt install jamulus-headless
sudo systemctl enable jamulus-headless
sudo systemctl edit --full jamulus-headless # 往 ExecStart 行添加启动参数
硬件门槛不高:1.6GHz CPU + 1GB 内存即可。家庭上行 10M/1M 跑 5 人以内通常没问题;人多或 ping 不理想建议改用云主机。
七、常见问题与排查速查
| 症状 | 官方建议 |
|---|---|
| 完全没声音 / 别人听不到我 | 插孔插对了吗?有没有别的程序占用声卡?Windows 用 ASIO4ALL 的检查 ASIO4ALL 设置 |
| 新插的耳机/麦克风不在设备列表 | 保持通电重启 Jamulus(不支持热插拔检测) |
| 声音断断续续 | 换更大的缓冲区(64 → 128 → 256) |
| 都听得清但合不上拍 | 不听本地直通、只听服务器返回(见下方测试法) |
| Buffer 灯突然变红 / 怪声 | CPU 被抢了:关掉会议/直播/杀毒扫描;混响开太多也吃 CPU |
| Ping 一开始好后来变差 | 有人在抢带宽(高清视频/会议);进阶方案:路由器 SQM / 防缓冲膨胀 |
| 新进来的人声音炸 | “新客户端级别”调低,或对个别人使用独奏 |
| 看不到想加的服务器 | 检查连接窗口的流派筛选;知道名字的话查 IP 直连 |
| 服务器列表完全为空 | 检查 ISP/路由器(例如某些运营商的”阻止分段 IP 包”选项、SPI 防火墙) |
| macOS 提示”无法验证开发者” | 访达 → 应用程序 → 右键 Jamulus → 打开 |
| macOS 听不到输入 | 系统设置 > 隐私与安全性 > 麦克风,勾选 Jamulus |
黄金法则自测法(官方推荐):
- 连接一个 ping > 200ms 的服务器;
- 拍一下手 —— 应该听到明显延迟的”回来的掌声”;
- 静音混音器里自己的通道(不是”静音我自己”按钮);
- 再拍一次手。
如果第 2 步听到了两声、或第 4 步还能听到掌声,说明你在听本地信号——必须关掉监听直通(声卡的 Monitor 按钮、混音台的直接输出等)。
八、更多玩法
- 给线上演出加”虚拟观众”:用 JACK 的 JackRouter 把 Jamulus 音频路由进 Zoom;Windows 也可用 VoiceMeeter (Banana)、macOS 用 BlackHole,把输出同时送往耳机和会议软件;
- 录音:Windows 上可用 Reaper 的 ReaRoute 插件录制 Jamulus 输出(社区有完整指南);
- 实时推歌谱:社区的 305keepers 网页工具,领队用浏览器把 PDF 曲谱实时推给所有”Jammer”;
- Linux 效果链:JACK 启动脚本把吉他插进 Guitarix(模拟音箱/效果器)再接回 Jamulus,实现”软效果器 + 在线排练”;
- 服务器状态页:
-m statfile把服务器统计写入文件,再用几行 PHP 在网页上显示当前在线状态。
九、总结
Jamulus 的哲学很清晰:把延迟压到最低,把音频质量做好,其它一概不越界。它没有视频、没有花哨的协作功能,但正是这种专注,让它成为远程乐队排练的事实标准——免费、开源、可自建、可用 MIDI 实体化操控、可录音、可自动化。
如果你和乐队成员分布在不同城市,准备三样东西就能开排:一条有线网络、一副有线耳机、一个靠谱的声卡。然后把缓冲设到 128 samples,遵守黄金法则。
- 官网(多语言):https://jamulus.app/zh-CN/
- 下载:https://github.com/jamulussoftware/jamulus/releases/latest
- 用户手册 / FAQ / 故障排除 / 服务器手册:见官网文档区
- 讨论区:https://github.com/jamulussoftware/jamulus/discussions/
W E T Y U → 黑键
点击或键盘均可弹奏











暂无评论内容