Blueman 蓝牙管理器完整指南：10 分钟告别命令行蓝牙操作，配对、传文件、共享网络一图搞定

2026/8/15 1:45:43

Blueman 蓝牙管理器完整指南：10 分钟告别命令行蓝牙操作，配对、传文件、共享网络一图搞定

【免费下载链接】bluemanBlueman is a GTK+ Bluetooth Manager项目地址: https://gitcode.com/gh_mirrors/bl/blueman

Meta：Blueman 是一个基于 GTK+ 的开源蓝牙管理器，面向 Linux 桌面，把蓝牙设备配对、文件传输、网络共享等操作从复杂命令行中解放出来，变成几个直观的鼠标点击。本文用一个真实的使用场景带你从安装走到进阶，全程无废话。

场景开场：为什么你的蓝牙耳机在 Linux 上总是"失联"？

想象一下这个下午：你刚买了无线耳机，想连上笔记本听歌；手机里有一份 500MB 的视频想发到电脑；台式机还想借手机流量应急上网。结果打开终端，bluetoothctl、obexctl的一堆子命令让你直接头大——这本来是十分钟能做完的事，你在命令行里耗掉了一个钟头。

这正是 Blueman 存在的理由。它把 BlueZ（Linux 蓝牙协议栈）那套底层 API 包上一层友好的 GTK+ 图形界面，让你不用记任何命令，就能完成以下事情：

一键扫描并配对耳机、键盘、鼠标、手机等设备
通过 OBEX 协议收发文件，实时看传输进度
连接拨号网络、组建蓝牙网络（BNEP），甚至把电脑变成网络接入点
用系统托盘常驻小程序随时开关蓝牙、监控信号与电量

它轻量、纯 Python 编写、GPL 开源，几乎你在发行版软件源里能见到的所有蓝牙图形工具里，它都是最活跃的那个。接下来，我们从零开始把整套流程跑通。

第一步：把 Blueman 请进你的系统

大多数主流 Linux 发行版都收录了 Blueman，优先用软件源安装，省去编译依赖的麻烦。

sudo apt-get update sudo apt-get install blueman

Arch 系用户对应sudo pacman -S blueman，Fedora 用户则用sudo dnf install blueman。

如果你是开发者，想从源码跑最新版，也可以克隆官方仓库后按 README 的指引走./autogen.sh再./configure && make && make install：

git clone https://gitcode.com/gh_mirrors/bl/blueman

装好后，你实际上会得到三个可执行程序，它们各管一摊，别搞混：

命令	作用	什么时候用
`blueman-manager`	设备管理主窗口	扫描、配对、管理设备
`blueman-applet`	系统托盘小程序	常驻后台，快速开关蓝牙
`blueman-sendto`	文件发送器	直接给指定设备发文件

第一次使用，建议先启动托盘小程序，再打开主管理器：

blueman-applet & blueman-manager

主窗口会列出当前蓝牙适配器和已发现的设备，顶部是工具栏、底部是状态栏。如果托盘图标没出现，先检查你的桌面环境是否支持 StatusNotifier 协议——Gnome 上可以用blueman-tray作为替代方案。

第二步：三步完成设备配对，比手机还简单

配对这个环节最容易劝退新手，但在 Blueman 里就是三个动作。

1. 打开发现模式，让设备"可见"

在管理器界面左上角选择你的蓝牙适配器，点击"搜索"按钮开始扫描周边设备。同时，如果是手机要连电脑，请先在手机蓝牙设置里打开"可被发现"选项——两个设备只有都在"可发现"状态才能互相看到。

2. 在列表里选中目标设备

扫描结果会按信号强度和时间排序显示在设备列表里。设备的别名（Alias）、信号强度和配对状态都会展示出来，一眼就能认出哪台是你自己的耳机或手机。

3. 右键点击，选择"配对"并输入口令

配对码通常自动完成：耳机、音箱这类免密设备直接确认即可；手机和电脑配对则会弹出配对码确认窗口，两边数字一致就点接受。配对成功后，设备会显示已配对标记，之后再连接就不需要重复输入了。

小贴士：如果设备列表里看不到某台设备，检查它是不是已经超过蓝牙有效范围（一般 10 米内），或者换个 USB 蓝牙适配器插口再试。连接失败时，管理器窗口底部状态栏会直接给出原因提示，比在终端里翻 dmesg 快得多。

第三步：用 OBEX 传文件，速度和进度都看得见

蓝牙传文件在命令行里是obexctl的天下，图形界面下则只需要右键。

发送文件：在管理器里右键已配对的设备，选择"发送文件"，挑一个或多个文件即可。也可以直接在文件管理器里右键文件，选择"发送到 Bluetooth"，系统会自动调起blueman-sendto并弹出设备选择框。
接收文件：首次接收时，系统托盘会弹出通知，询问你是否接受传入的文件传输请求。确认后，文件会保存到你在设置里指定的接收目录。
进度追踪：传输过程中，托盘图标会显示传输速度和剩余时间，不需要再开任何窗口。

接收路径默认在"下载"目录，想改的话，在托盘图标右键菜单里打开"设置"，找到 OBEX 相关的"共享目录"选项即可，这个配置对应项目里的org.blueman.transferschema（见data/org.blueman.gschema.xml），里面还记录了opp-accept这个开关——开启后会自动接受所有传入文件，方便但不太安全，建议按需使用。

第四步：三种网络共享方式，总有一种适合你

Blueman 的网络能力远超"传个文件"，它内置了三种连网模式。打开管理器菜单里的"服务"，切到网络标签页即可配置。

模式	全称	典型场景	配置难度
DUN 拨号	Dial-up Networking	电脑借用手机流量上网	低，只需 APN
PANU 组网	Personal Area Network	设备间组成小局域网互访	中，需做 DHCP
NAP 接入点	Network Access Point	把电脑变成蓝牙热点	高，需固定 IP

用手机流量应急上网（DUN）

这是最实用的场景。在"服务"窗口的网络页签中选中手机设备，填入运营商 APN（中国移动常见为cmnet），连接后电脑就能通过蓝牙拨号上网。如果没填 APN 也能连，只是可能无法真正上网，因为部分运营商会校验接入点。连接成功后，Blueman 会配合 NetworkManager 自动生成一个 DUN 连接，断网重连也由它接管。

把电脑变成蓝牙热点（NAP）

如果你有多台设备想同时通过一台电脑上网，可以启用 NAP 模式：在适配器上开启"网络接入点"，Blueman 会为连接的设备分配 IP（默认网段10.15.15.0/24，见org.blueman.networkschema 中的nap-enable和ip4-address配置），相当于给蓝牙设备开了一个微型热点。

注意：NTP/DHCP 分配依赖系统的 dhclient 或 NetworkManager，部分最小化安装的系统需要额外装dhcp-client软件包才能拿到 IP。

进阶技巧一：用插件系统给 Blueman 加"外挂"

Blueman 的功能按插件组织，这也是它可扩展性最强的部分。所有插件源码都在项目的blueman/plugins/目录下，按运行位置分成四类：

blueman/plugins/applet/：托盘小程序插件，如电源管理、最近连接、自动连接
blueman/plugins/manager/：管理器窗口插件，如设备信息、备注、PulseAudio 配置
blueman/plugins/mechanism/：需要 root 权限的系统级操作（rfkill、rfcomm、PPP）
blueman/plugins/services/：服务端功能，如文件传输服务、网络服务

在托盘图标或管理器窗口的"插件"设置界面里，你可以直接勾选启用或停用这些插件，改动即时生效。几个值得优先开启的：

AutoConnect：记住上次连接的服务，设备出现后自动重连
RecentConns：在托盘菜单里保留最近连接过的设备，一键重连
Battery：显示已连接设备（耳机、手机）的剩余电量
KillSwitch：跟随系统电源键状态同步开关蓝牙，解决"物理开关关了就再也打不开"的问题

如果你想写自己的插件，参考blueman/plugins/applet/AutoConnect.py或PowerManager.py，继承对应的AppletPlugin/ManagerPlugin基类，实现on_load等回调即可，框架会自动帮你注册进 UI。

进阶技巧二：把状态栏变成你的蓝牙"仪表盘"

适配器的性能和安全配置都在"适配器设置"里，别忽略这几个参数：

可见性：只在需要被别人发现时打开，配对完成后建议关闭，省电又安全
发现超时：默认 60 秒（对应org.blueman.plugins.discvmanagerschema 的time键），扫描完自动关闭可见性
电源管理：配合 PowerManager 插件，蓝牙会跟随系统挂起/唤醒自动开关

日常使用中，托盘图标本身就是信息面板：图标颜色和形状代表蓝牙开关状态，连接设备后信号强度图标会实时更新，电池图标则显示耳机剩余电量。连接质量下降时，还能在blueman/plugins/applet/NetUsage.py看到每个设备的实时流量统计——这在排查"蓝牙音箱是不是占光了带宽"时特别好用。

附赠：一张连接故障排查速查表

症状	可能原因	解决动作
扫描不到任何设备	适配器未开启或不可见	托盘右键勾选"开启蓝牙"，打开发现模式
配对总是失败	配对码不匹配或设备端超时	两边同时确认，10 秒内完成
传文件一直转圈	接收方未确认或目录不可写	检查托盘通知，确认接收目录存在且可写
连上但上不了网	APN 未配置或 DHCP 失败	补填 APN；安装 dhcp-client
蓝牙图标灰色	rfkill 硬件开关被物理关闭	用笔记本功能键打开蓝牙，或检查 BIOS 设置
托盘图标消失	桌面不支持 StatusNotifier	改用`blueman-tray`状态图标程序