bluez 5.50 与 obexctl 实战：从手机接收与发送文件的2种完整操作流程

BlueZ 5.50与OBEX实战手机与Linux设备间文件传输的完整指南1. 环境准备与基础配置在开始文件传输操作前确保你的Linux系统已正确安装并配置了BlueZ 5.50及相关组件。以下是基础环境检查清单BlueZ版本验证bluetoothd --version确认输出显示版本为5.50或更高必要组件安装sudo apt-get install bluez bluez-obexd obexftp服务状态检查systemctl status bluetooth确保蓝牙服务处于active (running)状态关键配置文件位置组件路径说明bluetoothd/usr/lib/bluetooth/bluetoothd蓝牙守护进程obexd/usr/lib/bluetooth/obexdOBEX文件传输服务obexctl/usr/bin/obexctl交互式OBEX控制工具提示如果使用Buildroot等嵌入式系统需确认已启用以下配置选项BR2_PACKAGE_BLUEZ5_UTILSBR2_PACKAGE_BLUEZ5_UTILS_OBEX2. 服务启动与设备连接2.1 初始化蓝牙服务创建启动脚本/usr/local/bin/bluetooth_init.sh#!/bin/bash # 设置设备名称 btmgmt -i hci0 name BlueZ_File_Transfer # 启用基本功能 btmgmt -i hci0 connectable on btmgmt -i hci0 le on btmgmt -i hci0 advertising on btmgmt -i hci0 power on # 启动DBUS会话 export $(dbus-launch) # 添加基础服务 sdptool add --channel1 OPUSH # 启动蓝牙守护进程 /usr/lib/bluetooth/bluetoothd -n # 启动OBEX服务自动接收模式 /usr/lib/bluetooth/obexd -a -r /var/bluetooth/received 赋予执行权限并启动chmod x /usr/local/bin/bluetooth_init.sh sudo /usr/local/bin/bluetooth_init.sh2.2 设备配对流程进入bluetoothctl交互界面bluetoothctl执行扫描与配对[bluetooth]# power on [bluetooth]# scan on [bluetooth]# pair 手机MAC地址 [bluetooth]# trust 手机MAC地址 [bluetooth]# connect 手机MAC地址验证连接状态[bluetooth]# info 手机MAC地址确认输出中包含Connected: yes3. 从手机接收文件3.1 自动接收模式配置启动obexd时使用以下参数组合-a启用自动接收-r 路径设置接收文件存储目录-d调试模式可选推荐命令/usr/lib/bluetooth/obexd -a -r /var/bluetooth/received -d3.2 手机端操作步骤在手机蓝牙设置中连接到你的Linux设备选择要发送的文件使用通过蓝牙分享功能选择已配对的Linux设备作为接收方等待传输完成提示文件验证ls -lh /var/bluetooth/received确认收到的文件大小与手机端一致3.3 常见问题排查问题现象可能原因解决方案传输中断编码不支持安装libiconv库并重新编译BlueZ找不到接收目录路径权限不足chmod 777 /var/bluetooth/received手机无法发现OBEX服务服务未正确注册检查sdptool add OPUSH执行情况连接成功但传输失败防火墙阻止sudo ufw allow 6500:6505/tcp4. 使用obexctl发送文件到手机4.1 obexctl交互式操作启动obexctlobexctl连接目标设备[obex]# connect 手机MAC地址发送文件[设备MAC地址]# send /path/to/local/file.txt监控传输状态[设备MAC地址]# list4.2 自动化脚本实现创建发送脚本send_file.sh#!/bin/bash DEVICE_MAC00:11:22:33:44:55 # 替换为实际手机MAC FILE_PATH$1 obexftp --nopath --noconn --uuid none --bluetooth $DEVICE_MAC --channel 12 --put $FILE_PATH使用示例chmod x send_file.sh ./send_file.sh ~/Documents/test.pdf4.3 高级参数调优RFCOMM通道发现sdptool search --bdaddr 手机MAC OPUSH输出示例Service Name: OBEX Object Push Service RecHandle: 0x1000d Protocol Descriptor List: RFCOMM (0x0003) Channel: 12传输性能优化obexftp --bluetooth 手机MAC --channel 12 \ --tcp-window 65535 \ # 增大TCP窗口 --timeout 60 \ # 延长超时时间 --put large_file.zip5. 安全与权限管理5.1 文件系统权限配置推荐目录结构/var/bluetooth/ ├── received/ # 接收目录777 ├── sent/ # 发送缓存755 └── logs/ # 操作日志755ACL设置示例sudo setfacl -R -m u:bluetooth:rwx /var/bluetooth/received sudo setfacl -d -m u:bluetooth:rwx /var/bluetooth/received5.2 DBUS策略配置创建/etc/dbus-1/system.d/bluetooth.confpolicy userbluetooth allow ownorg.bluez.obex/ allow send_destinationorg.bluez.obex/ /policy policy contextdefault allow send_interfaceorg.bluez.obex.Agent1/ /policy5.3 传输加密验证检查安全连接状态[bluetoothctl]# info 设备MAC确认输出中包含Secure: Yes6. 实战技巧与性能优化6.1 批量传输处理使用shell脚本实现目录批量发送#!/bin/bash DEVICE_MAC00:11:22:33:44:55 TARGET_DIR/mnt/share find $1 -type f | while read file; do obexftp --bluetooth $DEVICE_MAC --channel 12 --put $file --path $TARGET_DIR echo Transferred: $file → $TARGET_DIR/$(basename $file) done6.2 传输监控看板实时监控命令watch -n 1 df -h /var/bluetooth; ls -l /var/bluetooth/received | wc -l6.3 日志分析技巧启用详细日志/usr/lib/bluetooth/obexd -d -n -a -r /var/bluetooth/received /var/log/obexd.log 21关键日志模式成功传输Transfer complete失败传输Error occurred连接问题Connection refused7. 系统集成与自动化7.1 systemd服务配置创建/etc/systemd/system/obex.service[Unit] DescriptionOBEX File Transfer Service Afterbluetooth.target [Service] ExecStart/usr/lib/bluetooth/obexd -a -r /var/bluetooth/received Restarton-failure Userbluetooth [Install] WantedBymulti-user.target启用服务sudo systemctl daemon-reload sudo systemctl enable --now obex.service7.2 udev自动触发规则创建/etc/udev/rules.d/99-bluetooth-transfer.rulesACTIONadd, SUBSYSTEMbluetooth, \ RUN/usr/bin/systemctl start obex.service7.3 传输完成通知集成桌面通知示例inotifywait -m /var/bluetooth/received -e create | while read path action file; do notify-send 蓝牙传输完成 收到文件: $file done