GeneralShare 支持

版本 1.3.0 · 2026-11-12

遇到问题时，请先确认两台设备在同一 Wi-Fi 或同一局域网，并且没有开启 AP 隔离、访客网络隔离或 VPN 分流。下面是最常见的安装与连接问题。

联系我们

邮箱：software@generaldriver.com

请尽量附上：操作系统版本、GeneralShare 版本、发送端和接收端类型、错误提示、网络环境（家庭 Wi-Fi / 热点 / 企业网络），以及问题发生的时间。不要发送密码、证件或私密文件。

Windows

安装

把 ZIP 完整解压到普通文件夹，双击 install.cmd。安装位置是 %LOCALAPPDATA%\GeneralShare，不需要管理员权限。安装后从开始菜单打开 GeneralShare。

首次运行提示

程序尚未代码签名，Windows SmartScreen 可能提示“Windows 已保护你的电脑”。请先核对官网提供的 SHA-256；确认一致后可以选择“更多信息 → 仍要运行”。

Get-FileHash .\GeneralShare-Windows-1.3.0-x64.zip -Algorithm SHA256

防火墙

首次启动时如出现防火墙提示，请允许“专用网络”。如果没有提示或局域网内无法访问，请用管理员 PowerShell 执行：

netsh advfirewall firewall add rule name="GeneralShare" dir=in action=allow program="%LOCALAPPDATA%\GeneralShare\generalshare-hub.exe" enable=yes profile=private

只建议在专用/家庭网络放行，不要把 5134 暴露到公网。

右键菜单

Windows 11 默认显示精简菜单，请选择“显示更多选项”，再点“Send with GeneralShare”。多选文件建议使用“发送到 → GeneralShare”或命令行。

Linux

安装

tar -xzf GeneralShare-Linux-1.0.0-x86_64.tar.gz
cd GeneralShare-Linux-1.0.0-x86_64
./install.sh

也可以使用发行版原生包（安装后从应用菜单启动）：

# Fedora / RHEL / Rocky / Alma
sudo dnf install ./generalshare-1.0.0-1.x86_64.rpm

# Debian / Ubuntu / Mint
sudo apt install ./generalshare_1.0.0_amd64.deb

通用包默认安装到 ~/.local，并启用 systemd 用户服务。查看状态：

systemctl --user status generalshare-hub.service
journalctl --user -u generalshare-hub.service -f

依赖

桌面接收窗口需要 X11 或 Wayland、OpenGL 和 fontconfig。最小系统可安装 libX11、libxkbcommon、libxkbcommon-x11、libXcursor、libXi、libXrandr、libwayland-client、libglvnd/mesa、fontconfig。发送命令还需要 curl 和 jq；文件管理器菜单需要 zenity。

# Debian / Ubuntu / Mint
sudo apt install libx11-6 libxkbcommon0 libxkbcommon-x11-0 \
  libxcursor1 libxi6 libxrandr2 libgl1 fontconfig \
  curl jq zenity libnotify-bin wl-clipboard

# Fedora / RHEL / Rocky / Alma
sudo dnf install libX11 libxkbcommon libxkbcommon-x11 libXcursor \
  libXi libXrandr mesa-libGL fontconfig \
  curl jq zenity libnotify wl-clipboard

防火墙

# firewalld
sudo firewall-cmd --permanent --add-port=5134/tcp
sudo firewall-cmd --permanent --add-service=mdns
sudo firewall-cmd --reload

# ufw
sudo ufw allow 5134/tcp
sudo ufw allow 5353/udp

菜单或窗口没有图标

1.0.0 发布包会安装 16–512 像素图标、generalshare.desktop 和 hicolor 图标缓存。若从旧版本升级后仍显示默认图标，请重新登录桌面，或执行：

gtk-update-icon-cache -f -t ~/.local/share/icons/hicolor
update-desktop-database ~/.local/share/applications

使用 RPM/DEB 时图标安装在 /usr/share/icons/hicolor，由包管理器 的 post-install 脚本刷新。

支持范围

通用包支持 x86_64、glibc 2.28 及以上：RHEL/Rocky/Alma 8+、Fedora、Debian 10+、Ubuntu 20.04+、Linux Mint、Pop!_OS、openSUSE、Arch。更老的 glibc 或非 x86_64 架构当前不提供官方包。

Android / 鸿蒙

安装

下载 APK 后打开安装。若系统提示“未知来源”或“外部来源应用”，请在浏览器或文件管理器的设置中允许安装未知应用。Android 8.0 及以上可用；鸿蒙 2–4 的 Android 兼容环境可安装，鸿蒙 NEXT 不支持 APK。

发现不到电脑

• 确认手机和电脑在同一 Wi-Fi，且没有连接访客网络或开启 VPN 全局代理。
• 确认电脑端 GeneralShare 正在运行并显示在线。
• 部分路由器开启 AP 隔离后会禁止设备互访，需要在路由器中关闭。
• Android 省电策略可能在锁屏后限制后台；传输时请保持屏幕亮起。

Linux 能主动发送到 Android 吗？

可以，但需要在 Android 的 Receive mode 中开启接收，并保持 GeneralShare 打开。Android 会显示 6 位配对码，并在局域网广播一个 临时接收端；Linux 接收窗口的 Send to a phone 卡片或 generalshare-send CLI 会自动发现它，输入配对码后即可发送， 接收端仍需点 Accept。Linux GUI 使用 zenity 选择文件。

Receive mode

在 Android 首页的 Receive mode 卡片中勾选 Enable receiving。系统会请求 通知权限，并启动一个前台接收服务，显示 6 位配对码。接收完成后文件保存到 公共 Downloads/GeneralShare。关闭开关即可停止接收。

通知镜像

通知镜像默认关闭。在 Android 的 Advanced 中手动开启并授予“通知使用权”后，消息、邮件、通话和社交通知会经 Hub 显示在已配对的 Linux、Windows、macOS 和 iOS 客户端上；可随时关闭或撤销权限。客户端只显示已配对设备转发的提醒，不读取本机通知。

iPhone 通知需要蓝牙 ANCS：iOS App 不能直接读取其他 App 的通知，但 iPhone 可以作为蓝牙 ANCS 通知源，由附近一台 Android 设备作为 BLE 接收端并转发到 Hub。Android 端已完成 iPhone 15 Pro Max / iOS 27.2 实机验证：先在 iPhone“设置 → 蓝牙”中配对 Android 设备，再在设备详情中打开“共享系统通知”，即可接收应用通知、短信提醒、来电/未接来电提醒。当前只做提醒，不支持短信回复或通话音频接听。Windows/macOS 目前作为通知显示客户端，不是 BLE ANCS 接收端。仅靠 Wi-Fi 不能读取 iPhone 通知。

iPhone 通知/短信/来电配对步骤

1. Android 打开 GeneralShare → Advanced → iPhone notifications → Connect iPhone。
2. 在 iPhone 设置 → 蓝牙中与 Android 设备配对；配对成功后点设备右侧 ⓘ，打开 共享系统通知 / Share System Notifications。
3. 保持两台设备靠近，Android 状态显示 Waiting for iPhone notifications。应用通知、短信提醒、来电/未接来电会显示在 Android 上并转发到已配对客户端。

未接来电在能看到号码或匹配 Android 联系人时提供 Call back，否则提供 Open Phone。联系人查询是可选权限，仅本地使用。iOS 版（App Store 准备中）只显示 Hub 转发的提醒，不读取本机通知。

iPhone / iPad

iPhone / iPad 版正在准备 App Store 上架。安装后可通过 Bonjour 发现同一 Wi-Fi 下的 Linux/Windows 接收端，扫码或输入 6 位配对码，使用系统分享面板发送文件，并在 Alerts 页面查看已配对设备转发的提醒。上架后本页会更新 App Store 链接。

配对与传输

• 配对码显示在接收端窗口；配对码变化或接收端重启后需要重新确认。
• 接收端必须点击“接受”后才会写入文件；拒绝或超时不会产生文件。
• 传输中断后，重新发送同一个文件可以续传；接收端会按 SHA-256 校验完整性。
• 同名文件会保留为 name (2).ext，不会覆盖已有文件。
• 撤销信任设备后，该设备需要重新配对。

安全边界

当前版本面向可信局域网，尚未启用 TLS。不要在公共 Wi-Fi、酒店网络、访客网络或不可信企业网络中传输敏感内容。不要把 5134 端口映射到公网。

隐私

详见 隐私政策。文件与剪贴板只在你选择的设备之间传输。