BrowserBoxPro 浏览器自动化解决方案¶

安装方式¶

类型: Synology DSM 套件包
安装时间: 2026-02-02
状态: ✅ 正常运行

配置信息¶

端口配置¶

Web 端口: 8818 (HTTP)
Chrome Debug 端口: 5818
访问 Token: Visense1987

文件路径¶

配置文件: /volume1/@appdata/BrowserBox/userdata/config/browserbox.conf
日志文件: /volume1/@appstore/BrowserBox/logs/BrowserBox.log
PID 文件: /volume1/@appdata/BrowserBox/BrowserBox.pid

配置内容 (browserbox.conf)¶

BROWSERBOX_PORT=8818
CHROME_PORT=5818
TOKEN=Visense1987

访问方式¶

本地访问¶

http://192.168.30.30:8818/?token=Visense1987

通过 Cloudflare Tunnel¶

域名: gg.lalayunssl.xyz
Service: http://192.168.30.30:8818
注意: 需要在 URL 中添加 token 参数

常见问题¶

问题 1: 启动失败 - 权限错误¶

症状:

Error: EACCES: permission denied, mkdir '/var/packages/tmp'

原因: 缺少 /var/packages/tmp 目录

解决方案:

mkdir -p /var/packages/tmp
chmod 755 /var/packages/tmp
synopkg restart BrowserBox

问题 2: Token 修改后无法访问¶

解决步骤: 1. 检查配置文件是否正确修改 2. 确保 /var/packages/tmp 目录存在 3. 重启服务: synopkg restart BrowserBox 4. 检查日志: tail -50 /volume1/@appstore/BrowserBox/logs/BrowserBox.log

管理命令¶

重启服务¶

synopkg restart BrowserBox

停止服务¶

synopkg stop BrowserBox

启动服务¶

synopkg start BrowserBox

查看状态¶

synopkg status BrowserBox

查看进程¶

ps aux | grep bbpro | grep -v grep

查看端口监听¶

netstat -tlnp | grep 8818

查看日志¶

tail -f /volume1/@appstore/BrowserBox/logs/BrowserBox.log

与其他方案对比¶

BrowserBoxPro (当前方案) ✅¶

优点:
DSM 原生套件，管理方便
稳定性好
通过 Cloudflare Tunnel 正常工作
Token 认证简单
缺点:
需要手动创建 /var/packages/tmp 目录
仅支持 HTTP (无 HTTPS)

linuxserver/chromium Docker ❌¶

优点:
功能丰富
支持 HTTPS
缺点:
WebSocket 通过 Cloudflare Tunnel 不稳定
Selkies WebSocket 实现有兼容性问题
配置复杂

Mac 本地 Chrome (备选)¶

优点:
性能最好
完全兼容
缺点:
需要 Mac 保持运行
无法远程访问

集成到 OpenClaw¶

配置 OpenClaw 使用 BrowserBoxPro¶

# 在 OpenClaw 配置中添加浏览器连接
openclaw browser connect --url ws://192.168.30.30:5818

测试连接¶

openclaw browser status

备份与恢复¶

备份配置¶

cp /volume1/@appdata/BrowserBox/userdata/config/browserbox.conf \
   /volume1/sjchu/browserbox-backup.conf

恢复配置¶

cp /volume1/sjchu/browserbox-backup.conf \
   /volume1/@appdata/BrowserBox/userdata/config/browserbox.conf
synopkg restart BrowserBox

监控脚本¶

自动重启脚本 (可选)¶

#!/bin/bash
# /volume1/sjchu/check-browserbox.sh

if ! netstat -tlnp | grep -q ":8818"; then
    logger "BrowserBox port 8818 not listening, restarting..."
    synopkg restart BrowserBox
fi

添加到 DSM 任务计划¶

任务名称: Check BrowserBox
用户: root
计划: 每 5 分钟
命令: /volume1/sjchu/check-browserbox.sh

更新日志¶

2026-02-02¶

✅ 解决 /var/packages/tmp 权限问题
✅ 成功通过 Cloudflare Tunnel 访问
✅ Token 认证正常工作
✅ 服务稳定运行

参考资料¶

BrowserBoxPro 官方文档: https://github.com/BrowserBox/BrowserBox
Synology 套件管理: https://kb.synology.com/