安装 FFB-Bridge

FFB-Bridge 作为独立的 Windows 安装程序和 Linux AppImage 提供。两者都捆绑了 .NET 10 运行时。无需下载驱动程序；您的 SideWinder 力反馈 2 已经可以在任何现代 Windows 或 Linux 内核上以 HID 级别运行。

开始之前

你需要：

A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). The bridge is currently hardcoded to this specific stick.
支持的模拟器：Microsoft Flight Simulator 2024、X-Plane 11 或 X-Plane 12。MSFS 2020 未经测试。不支持 DCS、Prepar3D 和早期的飞行模拟器。
Windows 10 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

窗户安装人员

下载

当您注册后主页, we email you a tokenised download link. Click the Windows installer link to save FfbBridge-Setup-x64.exe (about 34 MB).

运行安装程序

双击安装程序。您会看到一两个提示：

SmartScreen“无法识别的应用程序”。 安装程序尚未进行代码签名 - 签名已在 1.0 路线图上。点击 更多信息，那么 无论如何都要跑.
Inno Setup 设置向导。 点击 下一页 through the two pages. The default install location is %LOCALAPPDATA%\Programs\FfbBridge — a per-user install, no administrator permission required.

视窗11 智能应用程序控制完全阻止未签名的应用程序

如果您使用的是 Windows 11 智能应用程序控制 (SAC) 在活动模式下启用，安装程序根本不会启动 — 没有 SmartScreen 提示，没有“仍然运行”选项，什么也没有发生。 SAC 拒绝任何没有可信代码签名签名的应用程序，并且 Beta 版本尚未签名。

今天解决这个问题的唯一方法是关闭智能应用程序控制足够长的时间来安装。微软自己的指南涵盖了流程（包括如何通过 设置 → 隐私和安全 → Windows 安全 → 应用程序和浏览器控制 → 智能应用程序控制设置):

Microsoft：智能应用程序控制常见问题解答

与早期 Windows 11 相比的好消息： 最近的累积更新允许您在安装完成后从 Windows 安全应用程序重新启用 SAC - Microsoft 过去要求完全重新安装 Windows，但该限制已消失。 SAC恢复后，FFB-Bridge应用程序本身将继续正常运行； SAC 仅在启动时检查以前未见过的应用程序。

代码签名安装程序位于 1.0 路线图上，并将完全删除此步骤。

启动中

名为“开始”菜单的快捷方式 FFB-Bridge lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

注意——防病毒软件

Some antivirus products flag unsigned binaries. If yours quarantines the installer outright (rather than just warning), please email the flagged sample to feedback·ffb-bridge.com (replace the · with an @) so we can investigate.

卸载

打开 应用程序和功能 在 Windows 设置中，搜索 FFB-Bridge，并选择卸载. Your profiles and preferences under %APPDATA%\ffb-bridge are left in place so a reinstall picks them up again; remove that folder by hand if you want a clean slate.

Linux 应用程序图像

下载

Same signup flow as Windows — click the Linux link in the email and you'll get FfbBridge-x86_64.AppImage (about 40 MB).

使其可执行并安装

AppImages need the executable bit set and, on most distros, to be registered in the application menu so the desktop launcher picks them up. The included install.sh script does both; the long form is:

chmod +x FfbBridge-x86_64.AppImage
mkdir -p ~/Applications
mv FfbBridge-x86_64.AppImage ~/Applications/
~/Applications/FfbBridge-x86_64.AppImage --install

The --install flag registers a .desktop file and icon into your XDG data directories. After that, a FFB-Bridge 条目与其他 GUI 应用程序一起显示在您的应用程序菜单中。

安装后 KDE Plasma 应用程序启动器中的 FFB-Bridge 条目 — Figure 1. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

udev规则（推荐）

Out of the box, only the user whose login session owns the joystick can open its /dev/input/eventN node. For the bridge to keep working after a fast-user-switch, or simply to avoid polkit prompts on some distributions, the 医生页面提供以下 udev 规则的一键安装：

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"

尼克斯操作系统

NixOS reads udev rules from the system config, not /etc/udev/rules.d. Add the equivalent to your configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
'';

Then sudo nixos-rebuild switch and replug the stick.

卸载

Either delete ~/Applications/FfbBridge-x86_64.AppImage and run the bundled uninstaller, or run the AppImage with the --uninstall flag to reverse the menu/icon registration automatically. Profiles and preferences under ~/.config/ffb-bridge are kept for a later reinstall.

验证安装

启动 FFB-Bridge。您应该看到的第一件事是欢迎对话框（下一节将介绍）。如果应用程序根本无法启动，或者启动时崩溃，请直接跳至故障排除.