📖 本文由 Batocera 官方 Wiki 翻译整理，内容可能随版本更新而变化。

网络配置指南：让你的系统“连通世界”

说明：本章节内容正在建设中。

Wi-Fi 基础知识

虽然 Batocera 在离线状态下也能完美运行，但接入互联网能让你解锁更多酷炫功能。

• 连接建议：虽然 以太网（Ethernet） 电缆能提供最稳定的连接质量（尤其是进行联机对战时），但 Wi-Fi 依然是一个便捷的替代方案。
• 硬件支持：对于普通 PC 而言，Batocera 应该支持大多数内置和 PCI-e 插槽（Peripheral Component Interconnect Express） 的 Wi-Fi 模块。
• 型号差异：比较新出的硬件型号可能无法“开箱即用”。你可以参考“已知兼容的 USB 无线网卡（Wi-Fi Dongles）列表”来选购合适的设备。

Wi-Fi 设置步骤

有线网络通常插上就能自动识别并配置，但 Wi-Fi 需要你手动“牵线搭桥”。

• 第一步：开启 Wi-Fi 开关
  进入 主菜单（MAIN MENU） -> 网络设置（NETWORK SETTINGS） -> 开启 Wi-Fi（ENABLE WIFI）。
  【提示】：如果你使用的是电池供电的掌上设备，不使用网络时关闭 Wi-Fi 可以显著延长续航。
• 第二步：等待信号扫描
  打开开关后，请稍等片刻，让 Wi-Fi 芯片完成启动并搜索周围的信号。
  【提示】：部分设备可能需要完整重启系统才能激活芯片。
• 第三步：选择网络
  稍后，所有可用的 Wi-Fi 热点都会出现在列表中，选择你的网络并输入密码即可。

关于连接数量的限制：
* 通过 EmulationStation 游戏前端 的菜单操作，你只能配置一个 Wi-Fi 连接。
* 如果你直接编辑 batocera.conf 配置文件，则最多可以配置三个不同的无线连接。

手动输入网络名称（Manual SSID）

如果你的路由器设置了隐藏 服务集标识（SSID，即 Wi-Fi 名称），或者它死活不出现在搜索列表里，你可以尝试手动添加。

• 第一步：手动输入名称
  点击菜单中的“手动输入（INPUT MANUALLY）”。

• 第二步：注意字符格式
  【注意】：SSID 是区分大小写的。
  【提示】：如果你的 Wi-Fi 名称或密码中包含特殊字符，需要在这些字符前加上反斜杠（\）进行转义。
  > 生活化类比：这就像是在填写正式表格。如果你的名字里有个生僻字或特殊符号，你得额外加个注脚（转义符），系统才能准确读懂，而不是把它当成指令给“吃掉”了。

  • 示例：如果密码是 special?characters@*，你应当输入 special?characters@*。
  • 你也可以选择直接在 Batocera.conf 配置文件中手动修改这些字段。

• 第三步：确认连接状态
  连接成功后，屏幕右上角会出现 Wi-Fi 图标（部分自定义主题可能会改变图标位置）。

命令行操作指南

说明：此部分内容尚在完善中（WIP）。

如果你无法通过图形界面操作，可以利用 SSH 远程连接（Secure Shell） 或 本地终端（Local Terminal） 来执行以下命令。
【提示】：如果没有网络，你可以插上网线进行 SSH 连接；如果连网线也没有，那就直接在 Batocera 本机上打开本地终端。

以下是继续为您改写的命令行工具及 Wi-Fi 故障排查教程：

Wi-Fi 故障排查

Wi-Fi 完全无法工作

在你开启 Wi-Fi 开关后，系统可能需要一点时间来“反应”。

• 第一步：重启试试
  有时候开关打开了，但系统得重启后才能真正激活驱动。这就是 Linux 的“脾气”，重启往往能解决一半的问题。
• 第二步：耐心等待
  重启进入主界面后，先别急着进菜单，在主菜单静候约 10 秒钟，再进入 Wi-Fi 设置界面查看。

如果依然无效，可能是你的 Wi-Fi 芯片组需要特定的驱动程序（Drivers），而这些驱动并没有被内置在 Batocera 中。你可以参考下文关于如何安装驱动的章节。

搜不到自家 Wi-Fi，但能搜到邻居的

这通常是因为你的 Batocera 设备与路由器所使用的“频道”不匹配。

生活化类比：这就像是收音机调频。如果你的路由器在 13 频道广播，而你的设备只能接收 1 到 11 频道的信号，那它当然听不到自家的声音，只能听到那些在常用频道广播的邻居信号。

• 典型案例：例如，臭名昭著的树莓派（Raspberry Pi）系列就不支持 2.4GHz 频段下的 13 信道。

操作步骤：修改地区代码
你可以通过更改国家/地区代码（Country Region）来尝试解锁更多频段：

• 第一步：编辑配置
  打开 batocera.conf 配置文件。
• 第二步：添加代码
  在文件中添加 wifi.country 密钥，并将其设置为你所在地区的代码。
  例如，设置为美国代码：
  wifi.country=US

如果你不确定自己国家的缩写代码是什么，可以参考 ISO 3166 国家代码标准（Alpha-2 code） 列表来查找。

我的 Wi-Fi 又慢又卡！

面对这个问题，最真诚的建议是……别用 Wi-Fi。尤其是当你想要进行对延迟极其敏感的操作，比如 联网对战（Netplay） 或 游戏串流（Game Streaming） 时，请务必使用 以太网（Ethernet） 电缆连接。

生活化类比：在现代的高科技生活中，空气中充满了各种看不见的“无线噪音”。想要获得一个完全不卡顿的 Wi-Fi 信号，简直就像在闹市区里指望能听到针掉在地上的声音。除非你紧挨着路由器坐着，否则干扰无处不在。

如果你所处的环境实在没法拉网线，必须使用 Wi-Fi，可以尝试以下几个“自救”小妙招：

• 第一步：减少干扰源
  尽量关闭周围其他开启了 Wi-Fi 的设备，包括手机、智能温控器，甚至是智能冰箱。
• 第二步：远离大型设备
  避开那些会产生大量电磁干扰的大型机械设备，比如内燃机、发电机、不间断电源（UPS）、微波炉等。

• 第三步：排查接口冲突
  如果你使用的是 2.4 GHz 频段 的 Wi-Fi（这是大多数路由器的默认频段），请确保周围没有正在运行的 USB 3.0 设备。
  【提示】：USB 3.0 接口在工作时产生的频率噪音会直接干扰 2.4 GHz 无线信号，导致连接质量大幅下降。

• 第一步：优化空间布局
  尽量让设备与路由器之间保持“视线直达”。如果中间隔着墙，也请尽量减少两者之间的杂物。

• 第二步：提高路由器高度
  通常情况下，将路由器放置在靠近天花板的高处效果最好。
  > 生活化类比：这就像是在广场上找人，站在高处（天花板）看下面总是清清楚楚，而蹲在地上（地板）则会被各种家具和杂物遮挡视线。
• 第三步：避开金属和平整物体
  特别要注意金属制品或镜面等非常平整的物体，因为它们会反射无线信号，造成严重的多径干扰（Multipath Interference）。
• 第四步：调整路由器高级设置
  进入路由器的管理界面，尝试开启服务质量（QoS，Quality of Service）或智能队列管理（SQM，Smart Queue Management）等功能。
  【提示】：这些功能通常只有现代高端路由器才支持，因为它们比普通网络传输更消耗处理器的性能。如果你的路由器支持安装 OpenWRT（开源路由器系统），那么它很可能也支持这些设置。
• 第五步：关掉多余的无线接口
  如果你正在使用外接的 USB 无线网卡，请关闭设备自带的蓝牙或内置 Wi-Fi。
  【注意】：如果你的 Wi-Fi 运行在 2.4 GHz 频段，这一步尤为重要，因为该频段与蓝牙的频率非常接近，极易发生冲突。

针对树莓派用户的特别提示：
如果你使用的是树莓派 4（Raspberry Pi 4），想彻底禁用其板载 Wi-Fi 以免干扰外接网卡，可以在 /boot/config.txt 文件中添加一行代码：dtoverlay=disable-wifi。

进阶篇：如何手动添加驱动程序

虽然 Batocera 内置的 Linux 内核（Kernel）已经能够支持绝大多数网络设备，但在极少数情况下（例如你使用了刚上市的顶级硬件），系统可能还没来得及收录它的驱动。如果制造商提供了预编译好的二进制驱动文件（Binary Driver Files），你可以尝试手动安装。

操作步骤：补全缺失的固件

生活化类比：这就像是你买了一台高科技厨电，但说明书（驱动）里少了几页关键操作说明。系统虽然能识别出这台机器，但不知道该怎么指挥它工作，我们需要手动把这几页说明书塞进它的文件夹里。

• 第一步：查明病因
  通过终端输入 dmesg 命令查看系统日志。如果你的网络或 Wi-Fi 设备因为缺少固件而罢工，你会看到类似的报错信息：
  [ X.XXXXXXX ] Wi-Fi: xxx0: RTL: firmware file rtlwifi/XXXXXXXXXX.bin not found
• 第二步：放置固件文件
  将报错信息中提到的 .bin 固件文件放入系统目录：/lib/firmware/rtlwifi/。
• 第三步：保存并永久生效
  确认 Wi-Fi 可以正常工作后，输入以下命令来保存你的更改，防止重启后丢失：
  batocera-save-overlay

【提示】：如果你通过这个方法成功修复了网络，请一定要联系开发者！这样他们就能把这些驱动加入到下一个版本的 Batocera 中，让其他用户免受折腾之苦。

其他网络故障

如果你遇到的问题不仅仅局限于 Wi-Fi，或者属于更通用的网络连接故障，请参考专门的“网络问题排查页面”。

原文: WiFi连接设置教程 • 翻译: DIY8 Bot