网络问题排查指南-一起DIY吧

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

网络问题排查指南

本章节主要针对通用的网络故障。如果你遇到的是特定的 Wi-Fi 连接问题（例如缺少驱动程序），请查看专门的 Wi-Fi 帮助页面。

访问终端/控制台（Terminal/console access）

如果你因为网络不通而无法通过 SSH 远程连接（Secure Shell）访问系统，在 PC（x86/x86_64）平台上，你依然可以使用鼠标和键盘直接进入本地的命令行状态。

方法一：通过文件管理器进入
第一步：切换到系统列表界面（即选择游戏机的界面），按下键盘上的 [F1] 键打开文件管理器。
第二步：点击左侧的“应用程序（Applications）”，然后双击 xterm 即可打开终端。

方法二：强制切换控制台会话（TTY）
如果你连文件管理器都进不去，可以使用底层的“逃生通道”：
第一步：按下组合键 [Ctrl]+[Alt]+[F5]，系统会直接跳到一个纯文字的命令行界面。
第二步：输入用户名 root，然后输入默认密码 linux 进行登录。
【提示】当你完成操作后，按下 [Ctrl]+[Alt]+[F2] 即可返回原本的 Batocera 图形界面。

【注意】在 Batocera v31 及更早版本中，快捷键是 [Ctrl]+[Alt]+[F3]。但那个版本的终端非常不稳定，经常出现乱码或文字重叠，除非万不得已，否则不建议使用。

如何修改键盘布局？

如果你发现键盘打出来的符号不对，可以手动更改键盘映射（Keymap）。

操作步骤：
第一步：打开配置文件 /userdata/system/batocera.conf。
第二步：找到或添加 system.kblayout= 这一行，并填入你需要的布局名称。

生活化类比： 这就像是给翻译官（系统）换了一本字典。你告诉它现在用的是“法语字典”还是“美标字典”，这样它才能准确理解你按下的每一个键。

你可以去 /usr/share/keymaps/ 目录下查看所有可用的布局。在设置时，只需要写布局的名称，不需要写完整路径，也不需要写文件后缀。
* 示例： system.kblayout=fr-latin1

我无法通过网络共享添加 ROM 游戏文件！

（原文此处内容未完）

无法访问 Batocera 网络共享文件夹？试试这些招数！

情况一：共享路径根本没出现

如果你在电脑上找不到 Batocera 的图标，首先要确保你的电脑和 Batocera 设备连接在同一个网络下。

生活化类比： 这就像两台对讲机必须调到同一个频道才能通话。虽然有时候路由器的 Wi-Fi 和有线网看起来是分开的，但大部分情况下它们在内部是连通的。

操作步骤：
第一步：尝试手动输入路径。
* Windows 或 MacOS 用户： 在文件管理器地址栏输入 \Batocera。
* Linux 用户： 输入 smb://Batocera.local。
第二步：如果你的路由器比较老，不支持“主机名”识别，那就直接输入 IP 地址。
* 例如输入：\192.168.1.2（这里的数字请换成你机器的实际 IP）。
【提示】你可以在 Batocera 的 主菜单（MAIN MENU） -> 网络设置（NETWORK SETTINGS） -> IP 地址（IP ADDRESS） 中找到这一串数字。

情况二：如果你使用的是 Windows 系统

Windows 用户经常会因为系统安全设置太高而挡住共享连接。请检查以下三项：

1. 检查网络类型是否为“公用”
如果你的网络被设为“公用”，Windows 会为了安全关闭局域网共享。
* 第一步：在开始菜单搜索并打开 网络和共享中心（Network and Sharing Center）。
* 第二步：查看你当前激活的网络。如果显示的是“公用网络”或“工作网络”，请点击它。
* 第三步：在弹出的窗口中选择 家庭网络（Home network）。
【注意】千万不要在麦当劳或机场的公共 Wi-Fi 下做这个操作！
* 第四步：再次尝试访问 \Batocera。

2. 刷新网络列表
有时候网络发现还没反应过来，你可以手动催促一下。
* 第一步：打开文件资源管理器中的“网络”文件夹。
* 第二步：点击窗口内的任意位置，然后按下 [F5] 键刷新列表。
* 第三步：再次尝试连接。

3. 检查 SMB（Samba）功能是否被彻底禁用
如果上述方法都不管用，可能是 Windows 根本没开启共享协议支持。
* 第一步：在开始菜单搜索并打开 启用或关闭 Windows 功能（turn windows features on or off）。
* 第二步：在列表中找到相关选项并确保其已开启（通常涉及 SMB 1.0/CIFS 支持）。

第一步：在弹出的窗口列表中，找到并勾选“SMB 1.0/CIFS 文件共享支持”（SMB 1.0/CIFS File Sharing Support）或“SMB 1.0/CIFS 客户端”等相关选项。
第二步：重新启动 Windows 电脑，再次尝试在地址栏访问 \Batocera。

针对 Windows 10（1709 版本及以上）特定版本的修复

如果你使用的是 Windows 10 企业版（Enterprise）、教育版（Education） 或 Windows Server 2019，微软默认禁用了“匿名/访客访问”（Guest Shares）。

生活化类比： 这就像是微软为了安全，给你的大门加了一把必须有电子钥匙才能开的“高级锁”，导致像 Batocera 这种习惯“不敲门直接进”的本地共享设备被挡在了门外。虽然在家里这没什么必要，但规矩是微软定的。

操作步骤：

第一步：确认问题。在开始菜单搜索并打开“命令提示符”（cmd.exe），输入 net use \Batocera。如果屏幕显示“发生系统错误 1272”，说明这就是症结所在。
第二步：按下快捷键 [Win]+[R]，输入 regedit 后按回车，打开注册表编辑器（Registry Editor）。系统会询问管理员权限，点击“确定”。
第三步：按下 [Ctrl]+[F] 搜索 AllowInsecureGuestAuth。
第四步：找到后双击它，将“数值数据”改为 1。
【提示】如果你电脑上有多个用户，建议重复第三、四步多次，确保每个用户都修改到位。
第五步：再次按下 [Ctrl]+[F]，在搜索选项中取消勾选“项”和“数据”，仅保留“值”，然后搜索 RequireSecuritySignature。
第六步：找到后双击它，将数值也改为 1。同样地，如果有多用户，请重复此操作。

以太网（Ethernet）已连接但没有数据传输

（原文此处内容未完）

以太网已连接但无法上网？试试这几招

如果你发现网线在 Windows 下用得好好的，但在 Batocera 里却连不上网，可以按照以下步骤排查。

检查网口指示灯的状态

首先，请仔细观察网线接口上的 状态指示灯（Link LED）（通常是那个常亮的橙色灯，而不是闪烁的黄色灯）。

观察它在什么时候亮起：是在电脑刚开机显示 自检画面（POST screen）（即提示你按键进入 BIOS 的那个界面）时就亮了，还是等到 Windows 开始加载后才亮？

如果灯直到 Windows 启动才亮，那你可能需要关闭 Realtek 网卡的“关机唤醒”功能。

生活化类比： 这就像是你的网卡被 Windows 下了一道“休眠咒”。当 Windows 关机时，网卡也跟着彻底断电了，导致 Batocera 启动时找不到它。我们需要在 Windows 里解除这个咒语，让网卡保持待命状态。

操作步骤：
第一步：启动进入 Windows，点击开始菜单，输入并打开 设备管理器（Device Manager）。
第二步：展开 网络适配器（Network Adapters），右键点击你的 Realtek 以太网控制器（Realtek Ethernet adapter），选择 属性（Properties）。
第三步：切换到 高级（Advanced） 选项卡，在属性列表中向下滚动找到 “关机网络唤醒（Shutdown Wake-On-LAN）”。
第四步：如果当前状态是“开启（Enabled）”，请将其改为 “关闭（Disabled）”，然后点击确定。
第五步：重新启动进入 Batocera，观察在开机自检画面时，网口指示灯是否已经亮起。

【提示】如果上述操作无效，你可能还需要进入 BIOS 设置 开启相关功能。在 BIOS 中，它通常被称为 “Onboard LAN Boot ROM”、“Allow waking via LAN ROM” 或类似的名称。

手动配置网络连接

如果自动配置（DHCP）失败了，你可以尝试通过命令行手动建立网络连接。

【注意】操作前请确保网线已插好，且网口状态灯处于亮起状态。如果灯都不亮，那通常是硬件问题（请尝试更换网线或接口）。

操作步骤：
第一步：按下键盘上的 [F1] 进入文件管理器，点击左侧的 应用程序（Applications），双击运行 xterm 终端窗口。
第二步：输入以下命令来查看可用的网络服务：

connmanctl services

第三步：根据上一步返回的信息，运行以下命令（请根据实际情况替换 < > 中的内容）：

# 后续命令请见下文...

第三步：手动输入配置信息。你需要把下面命令中的括号部分替换为实际的数值：

connmanctl config ethernet_<MAC地址>_cable --ipv4 manual <IP地址> <子网掩码> <网关> --nameservers <DNS服务器1> <DNS服务器2>

生活化类比： 自动配置就像是去餐厅点“主厨精选”，如果主厨今天不在状态（DHCP失效），你就得按照菜单（手动配置）一项项告诉服务员：我要坐哪桌（IP地址）、这桌有多大（子网掩码）、门在哪（网关），以及我该去问谁要菜单（DNS服务器）。

执行完毕后，设置会立即生效。

显卡适配器完全无法工作

在某些情况下，Linux 系统自带的通用驱动程序可能无法正常驱动你的网卡，这时需要禁用内核驱动（Kernel Driver），转而使用硬件厂商提供的驱动。

【注意】在进行以下驱动替换操作后，必须运行保存命令才能永久生效。

Realtek 8111 系列网卡

如果你的 Realtek 8111 网卡无法正常通讯，请尝试切换驱动版本。

操作步骤：
第一步：打开并编辑配置文件 /etc/init.d/816x.conf。
第二步：将原本针对 r8168 的黑名单设置改为屏蔽 r8169。
第三步：在终端运行以下命令保存更改：

batocera-save-overlay

RealTek 8169 系列网卡

对于 8169 型号的网卡，操作方式略有不同。

操作步骤：
第一步：打开配置文件 /etc/init.d/blacklist-r8169.conf。
第二步：找到 blacklist r8169 这一行，删掉前面的注释符号（通常是 #），让这一行代码生效。
第三步：运行保存指令：

batocera-save-overlay

已知问题（Known issues）

RealTek 8169 速率限制： 目前已知该型号的网卡在支持的局域网环境下，可能无法达到 2.5GHz 的最高运行频率。如果你发现传输速度没达标，这可能是一个系统层面的已知 Bug。

原文: 网络问题排查指南 • 翻译: DIY8 Bot

文章版权归作者所有，未经允许请勿转载。