简体中文
故障排查
这一页是全站唯一的错误码表。先在屏幕上找到错误码或那一行字，再按它出现的地方找到下面对应的一节，照“处理”一列做。表里的 <hub> 代表中枢那台机器的地址。
面板打不开
| 症状 | 原因 | 处理 |
|---|---|---|
浏览器打不开 http://<hub>:8080 | 中枢的服务没在运行、端口改过，或这个网络不在开放范围里 | 在中枢上运行 nhub status，再看 网络 页的 面板端口 和 开放范围 |
http://<hub>:8080 跳到 https://<hub> 后打不开 | HTTPS 开着，HTTP 端口把浏览器转到 HTTPS 端口，这里却连不到那个端口 | 看 面板端口 里的 HTTPS 端口，确认去中枢的路上这个端口是通的 |
| 改了面板端口后会话断开 | 面板在新端口上重启；会话 cookie 以端口命名，即 neutrino_session_<port> | 在新地址上重新登录 |
| 选了 开启 HTTPS 或 关闭 HTTPS 后会话断开 | 切换结束了会话，离开的那个端口在转走浏览器时删掉 cookie | 在页面跳到的地址上重新登录 |
关闭 HTTPS 后在 http:// 上登录，又回到登录卡 | 浏览器还留着 HTTPS 端口的 Secure cookie，http:// 上的新 cookie 替换不了它 | 选登录卡上的 清掉旧会话，或打开一次 https:// 地址，它把浏览器送回来并删掉旧 cookie |
浏览器提示证书有问题
这几行针对 HTTPS 端口。它的证书由中枢自己的证书颁发机构签发，浏览器装上这个颁发机构并重启后才信任它。
| 症状 | 原因 | 处理 |
|---|---|---|
| 浏览器说证书颁发机构不受信任 | 这台设备没装颁发机构 | 打开 http://<hub>:8080，在 设置 > HTTPS 下选 安装证书，照这台设备的步骤做，再重启浏览器 |
| 开启 HTTPS 是灰的，旁边写着 先安装证书并重启浏览器 | 这个浏览器不认 HTTPS 端口的证书 | 装上这个系统对应的颁发机构，重启浏览器，再用 http:// 地址打开 |
| 导入颁发机构之后 Chrome 仍显示“不安全” | 导入之前在证书警告页上选过“继续访问” | 重启 Chrome |
| 同一台机器上 Firefox 报警，Chrome 不报 | Firefox 有自己的一份颁发机构列表 | 照 安装证书 下 Linux：Firefox 的步骤做 |
| 设置页改动之后，每个浏览器又开始报警 | 重新生成证书 换了一个新的颁发机构 | 在每台设备上装新的颁发机构并重启浏览器；HTTPS 开着时，http://<hub>:8080/api/hub/setting/https/authority 照样能下载 |
| 浏览器说证书属于别的名字 | 地址栏里的地址不在 证书上的名字 里；公网地址从不在其中 | 改用那里列出的名字或地址打开面板，局域网里能用 hub.neutrino.internal |
锁定
| 症状 | 原因 | 处理 |
|---|---|---|
| 多次失败后已锁定。 | 连续输错密码 | 在中枢上运行 sudo nhub unlock，它同时解除 fail2ban 的全部 SSH 封禁 |
| 密码不对。，而且忘了密码 | 面板密码丢了 | 在中枢上运行 sudo nhub reset password，所有会话随之登出 |
| 忘了保险库口令 | 运行中的机器仍用自己的工作密钥读保险库，旧口令做的备份打不开 | 在中枢上运行 sudo nhub vault rekey 设新口令，再下载一份新备份 |
vault_locked | 中枢所在机器上没有保险库数据密钥的工作副本，凭据都读不出来 | 在 设置 页恢复一份备份，填做备份时的保险库口令 |
凭据存不进去
| 症状 | 原因 | 处理 |
|---|---|---|
key_is_public | 粘贴的是公钥 | 粘贴配对的私钥，即不带 .pub 的那个文件，含 BEGIN 和 END 两行 |
key_passphrase_needed | 私钥有口令保护，口令没填 | 把私钥的口令一起填上 |
向导和恢复备份
恢复时出现这几个码，中枢什么都不恢复。
| 症状 | 原因 | 处理 |
|---|---|---|
backup_wrong_extension | 文件不是面板导出的备份 | 选面板 备份配置 下载的那个文件 |
backup_corrupt | 存档已损坏 | 换一份备份 |
vault_passphrase_wrong | 口令打不开这份备份 | 填做这份备份时的保险库口令 |
backup_mode_unavailable | 备份里的模式这台中枢不提供，例如国内版没有旁路网关 | 恢复到提供这个模式的中枢上，比如完整版 |
| 文件已恢复，对话框写着应用没完成 | 应用配置的某一步失败，原因写在对话框里 | 处理好原因，在中枢上运行 sudo nhub apply |
设备离线
| 症状 | 原因 | 处理 |
|---|---|---|
面板上的操作或客户端里的条目返回 agent_offline | 那台机器的被控端没连着中枢 | 在那台机器上以 root 或管理员运行 nagent status；服务停着时运行 nagent start，等设备行变成在线 |
| 机器在列表里，模块却改不了 | 离线的机器拒绝一切改动，中枢也不排队 | 让机器重新上线，再应用一次 |
选 网络唤醒 时返回 wol_no_mac | 这台机器从没上报过 MAC 地址 | 让机器上线一次，被控端上报 MAC 地址之后再唤醒它 |
SSH 安装返回 unsupported_remote_install | 对方的系统不是 Linux，SSH 安装只装 Linux | 在那台机器上装被控端，用 用链接添加 的链接加入 |
中枢拒绝被控端或客户端
被控端在 nagent status 里显示这些错误码，客户端显示在对应中枢的那一行。
| 症状 | 原因 | 处理 |
|---|---|---|
protocol_too_old | 程序的协议号低于中枢接受的下限，例如 0.3 或 0.4 的程序连 0.5.2 的中枢 | 在那台机器上装 0.5.2 的包，再用中枢上的新链接加入 |
protocol_too_new | 程序的协议号高于中枢的，例如 0.5.2 的程序连 0.4 的中枢 | 中枢是 0.5 时，在 设置 页升级它。0.4 的中枢不能升级到 0.5.2：删掉它，全新安装 0.5.2，被控端和客户端都用新链接重新加入 |
hub_untrusted | 中枢重装过，证书换了 | 用新链接重新加入：被控端的链接在 设备 页的 用链接添加 里，客户端的链接在 客户端 页 |
加入中枢失败
这些码写在客户端的加入框下面，或写在 加入被拒 · 后面。
| 症状 | 原因 | 处理 |
|---|---|---|
link_not_for_client | 粘的是 设备 页发的被控端链接 | 在 客户端 页生成一条 |
link_unreadable | 链接没粘全 | 从面板复制整条链接 |
ticket_spent | 链接用过，已过了 30 分钟，或面板后来又生成了一条同一种链接，这一条随之作废 | 在中枢那一行选 离开，用 客户端 页的新链接重新加入 |
admission_paused | 中枢上失败的加入太多，暂停了新的加入 | 等码里给的秒数过去，客户端自己再加入 |
中枢一行的状态字
这些字写在桌面客户端和 Android 应用中枢那一行的名字下面，两边相同。带倒计时的行到 0 时自动重拨，按刷新按钮也马上重拨。
| 状态行 | 原因 | 处理 |
|---|---|---|
| 刚加入的一行一直在 连接中… 和 中枢未响应 之间来回 | 链接里的地址这台设备一个都连不上，比如手机在外面 | 在虚拟网一行选 连接，或回到中枢所在的网络；链接的票据留着，连上时才用掉 |
| 中枢未响应 · 5 秒后重试 | 这一轮的地址都没连上 | 确认中枢在运行；在外面时，确认这台设备连着一种外部访问 |
| 中枢未上虚拟网 · 5 秒后重试 | 本机已在中枢的虚拟网里，经这个网仍连不到中枢 | 在面板 外部访问 页看这个虚拟网的徽章，再查外部访问一节 |
| 无网络 | 本机没有任何网络 | 接上网络，客户端马上再拨 |
| 证书不符 · 60 秒后重试 | 中枢的证书和链接里钉住的不同 | 中枢重装过的话，选 离开，再用新链接加入 |
| 中枢暂停接纳 · 60 秒后重试 | 中枢暂停了新的加入，秒数由中枢给 | 等倒计时到 0，客户端自己再加入 |
| 中枢不认识本机 | 中枢的 客户端 页上已没有这个客户端 | 选 离开，这一行只剩这个按钮，再用新链接加入 |
| 版本太旧 | 客户端和中枢的协议号对不上 | 装新版客户端或升级中枢，再刷新；见中枢拒绝被控端或客户端 |
| 加入被拒 · 加原因 | 中枢拒收链接里的票据 | 选 离开，再用新链接加入；原因见加入中枢失败 |
| 已被替换 · 重新连接 | 另一个客户端用同一个绑定连上了这台中枢 | 选 重新连接，把中枢要回来 |
| 已停用 | 中枢在 客户端 页上停用了这个客户端 | 在面板 客户端 页的这一行选 启用 |
| 灰色圆点，一直没连上过 | 这台中枢本机从没连上过 | 照 中枢未响应 那一行做 |
客户端连不上
| 症状 | 原因 | 处理 |
|---|---|---|
hub_unreachable | 这台电脑连不上中枢的 8443 端口 | 检查网络，或 外部访问 页上用的那条路，以及中枢的开放范围 |
client_disabled | 这个客户端在 客户端 页上停用了 | 在它那一行选 启用 |
permission_denied | 客户端的权限不包括这类条目，或不包括那台机器 | 在 客户端 页放宽这个客户端的权限 |
client_held | 这台电脑上另一个账户的客户端在运行 | 让那个账户退出客户端（托盘菜单的 退出），再启动你自己的 |
gui_webkitgtk_missing | Linux 上缺 WebKitGTK | 装上提示里列出的包，再启动客户端 |
gui_webview2_missing | Windows 上缺 WebView2 | 装上提示里列出的运行时，再启动客户端 |
root_refused | 用 sudo 启动了客户端 | 用你自己的账户启动 |
虚拟网连不上
这些码写在客户端虚拟网那一行的下面，桌面客户端和手机相同。失败后客户端不自动再试，处理好再选 连接。
| 症状 | 原因 | 处理 |
|---|---|---|
overlay_join_failed | 引擎没让本机加入，码后面是引擎自己的原话 | NetBird 上常见的原因是中枢存的 setup key 只能用一次，已经用掉：在 NetBird 控制台建一把可重复使用、不限次数的 key，在 NetBird 卡片上选 替换 存进去，见 NetBird |
overlay_other_network | 本机已在另一个 NetBird 网络里，或连着别的中枢的控制台；手机上是另一台中枢的虚拟网还连着 | 先断开那个网络，再连这一个 |
overlay_no_address | 90 秒内引擎没给本机分地址 | 确认本机能上网，再选 连接 |
overlay_daemon_down | 虚拟网的守护进程没在运行 | 重装客户端 |
bundle_missing | 这份安装里没有 NetBird 或 EasyTier | 重装客户端 |
overlay_console_invalid | 中枢给的 EasyTier 控制台地址，本机的 EasyTier 用不了 | 在中枢的 EasyTier 卡片上核对控制台地址 |
overlay_withdrawn | 中枢不再提供这个网络 | 在中枢的 外部访问 页重新打开它，或改用别的外部访问 |
| 一直写 连接中…，下面说本机已登记到控制台 | EasyTier 控制台模式下，新设备要由控制台的主人挂到网络上 | 在 EasyTier 控制台里把这台设备挂到中枢所在的网络，那一行随即变成 已连接 |
外部访问
| 症状 | 原因 | 处理 |
|---|---|---|
打开一个引擎，或保存 EasyTier 设置时，返回 overlay_subnet_overlap | 这个引擎的网段和另一个引擎的网段重叠，或和这台机器所在的某个网络重叠 | 改 EasyTier 的 本机地址，或在 网络 页改局域网的地址；NetBird 的网段固定是 100.64.0.0/10 |
页上出现红色的 overlay_default_route_refused | 某个对端或控制台给了这台机器一条走虚拟网的默认路由，中枢删掉了它 | 在 NetBird 或 EasyTier 的控制台里删掉给中枢的出口路由；这台机器始终从自己的上行出网 |
overlay_route_overlap，下面写着 请在管理这个虚拟网的地方撤掉它。 | 一条虚拟网路由和这台机器的某个网络重叠，中枢撤不掉它 | 到管理这个虚拟网的控制台里修改或删除这条路由 |
保存 直连 设置时返回 direct_host_invalid | 公网地址既不是 IP 地址也不是主机名 | 改成 IP 地址或主机名，再应用 |
保存 EasyTier 设置时返回 easytier_config_server_invalid | 控制台地址 既不是带令牌的地址，也不是单独一个令牌 | 从 EasyTier 控制台重新复制地址或令牌，再应用 |
保存 EasyTier 设置时返回 easytier_invalid | 手动模式下一个碰头点都没填 | 至少填一个碰头点；网里还没有别的机器时，先在一台公网机器上自建碰头点 |
| NetBird 的徽章写着 未加入 | 中枢没有 NetBird 身份，或上次登录已失效 | 用一把新 key 再加入 |
| NetBird 的徽章写着 管理面不可达 | 中枢连不上 NetBird 的管理面 | 查这台机器的上行和 DNS，确认它能打开管理面的地址；NetBird 卡片上的管理面地址留空时，用的是 netbird.io 的 |
| NetBird 的徽章写着 未运行 | NetBird 守护进程没有运行 | 在 外部访问 页关掉再打开 NetBird，选择 应用外部访问 |
| NetBird 的 节点 是空的 | 还没有别的设备登录这个网络 | 在另一台设备上用 NetBird 应用登录，或让一个客户端连上虚拟网 |
| 经 NetBird 连得上中枢，局域网里的设备却打不开 | 控制台里这个网段的资源没有访问策略 | 在 NetBird 控制台给这个资源加一条 Access Control Policy，见经 NetBird 访问没装被控端的设备 |
| 经 EasyTier 连得上中枢，局域网里的设备却打不开 | 中枢没有导出这个网段 | 手动模式下在 导出的局域网 里加上它再应用；控制台模式下在控制台给中枢加子网代理，见经 EasyTier 访问没装被控端的设备 |
| EasyTier 写着 还没有机器加入。 | 另一台机器的网络名或密码和中枢的不一致 | 用 复制（含密码） 重新复制命令，在那台机器上再运行 |
| 虚拟网上连不到中枢，两种引擎都一样 | 虚拟网不在中枢的开放范围里 | 在 网络 页的 开放范围 里勾上它，再应用 |
| SSH 中继的 状态 一直是 连接中 | 转发已启动，第一次检查还没做完 | 过一分钟再看 |
| SSH 中继的 状态 是 未配置 | 服务器、账户、密钥或登录信息没填，或者已从凭据里删掉 | 填好设置，选择 应用 SSH 中继 |
| SSH 中继的 状态 是 保险库已锁定 | 这台机器上缺少保险库数据密钥的工作副本 | 照锁定一节 vault_locked 那一行做 |
| SSH 中继的 状态 是 认证失败 | 服务器不接受这把密钥或这个密码 | 检查 authorized_keys 里的公钥行，或者密码和这个账户的 PasswordAuthentication |
| SSH 中继的 状态 是 服务器不让对外监听 | 服务器拒绝监听，或者别的程序占着这个端口 | 确认 permitlisten 里的端口就是对外端口，并在服务器上腾出这个端口 |
| SSH 中继的 状态 是 对外端口不通 | 转发在运行，公网地址却没有应答，或应答的是别的证书 | 检查 GatewayPorts clientspecified、服务商的防火墙和服务器自己的防火墙 |
| SSH 中继的 状态 是 主机密钥已变 | 服务器出示的密钥和记下的不一样 | 同一地址上重装过服务器时，先按用自己的 VPS 中继连回家重新设置服务器，再选择 忘记主机密钥 |
| SSH 中继的 状态 是 连不上服务器 | SSH 连不到服务器，或者连接断了 | 检查服务器和 SSH 端口，确认服务器在运行 |
中枢拒绝网络设置
| 症状 | 原因 | 处理 |
|---|---|---|
应用 网络 页时返回 network_invalid，说某个网口的角色是停用 | 开放范围 里勾着的一个网口，角色是 停用 | 把这个网口的角色改成 WAN 或 LAN，或在 开放范围 里取消勾选它 |
| 国家代码 下面写着 两个字母，例如 CN。5 GHz 需要国家代码。 | 热点用 5 GHz，国家代码空着或不是两个字母 | 填上所在国家的两个字母代码，例如 CN，再应用 |
保存一个端口时返回 port_out_of_range | 端口不在 1 到 65535 之间；面板端口、代理端口、直连和 SSH 中继的端口都一样 | 改成这个范围内的端口，再应用 |
保存一个端口时返回 port_already_in_use | 这台机器上已经有别的程序在这个端口上监听 | 换一个端口，或先停掉占着它的程序 |
应用 代理 页时返回 resolver_required | 远程解析器（走代理的域名） 一个都没有 | 至少加一个远程解析器，再应用 |
模块页上的错误
这些码写在面板 模块 页的标签下面，或写在一行实例、一个账户的下面。处理好原因后，再按一次原来的按钮就重试。
| 症状 | 原因 | 处理 |
|---|---|---|
module_fetch_failed | 中枢取不到这个模块的安装文件 | 确认中枢能上网，再在模块上选 安装 |
no_platform_build，或模块是灰的，写着 这台机器的系统不支持 | 这个模块没有适合这台机器系统的构建 | 换一台机器；支持的平台列出每个模块能用的系统 |
gitea_git_missing | Mac 或 Windows 上没有能用的 git | Mac 上装开发者工具或 Homebrew 的 git，Windows 上装 Git for Windows，再安装 Gitea |
几个模块共用的码
VS Code、code-server、CloudCLI、Codeg 的实例，终端模块，以及 AI 工具的账户行，都可能出现这些码。
| 症状 | 原因 | 处理 |
|---|---|---|
account_unknown | 机器上没有这个账户 | 改成机器上已有的账户，或先在机器上建好它 |
account_invalid | 这个名字在那台机器上不能做账户名 | 换一个账户名 |
account_duplicate | 两个实例用了同一个账户 | 每个账户只留一个实例 |
port_invalid | 端口不在 1024～65535 之内 | 填这个范围里的端口 |
port_duplicate | 两个实例用了同一个端口 | 给其中一个换端口 |
credential_missing | Windows 上，这个账户的实例没选登录信息 | 在实例上选一条登录信息；登录信息存在 凭据 页 |
credential_invalid | Windows 已经不接受这个账户的登录信息 | 账户改过密码时，到 凭据 页更新这条登录信息，再应用一次 |
token_missing | 中枢没有给 VS Code 或 CloudCLI 的实例发令牌 | 再应用一次；保险库锁着时先照锁定一节处理；还不行，删掉这个实例再添加一次 |
CloudCLI
| 症状 | 原因 | 处理 |
|---|---|---|
cloudcli_node_download_failed | CloudCLI 用的 Node.js 没能下载或解包 | 确认机器能访问 nodejs.org，再应用一次 |
cloudcli_npm_install_failed | npm 为这个账户安装 CloudCLI 失败，后面带 npm 输出的最后几行 | 按 npm 的输出处理，确认机器能访问 npm，再应用一次 |
cloudcli_native_module_failed | better-sqlite3、node-pty 或 bcrypt 的预编译文件没能下载 | 确认机器能访问 GitHub，再应用一次 |
cloudcli_install_out_of_memory | npm 安装时机器的内存用完了 | 腾出内存后再应用一次 |
cloudcli_port_taken | 机器上另一个程序占着这个实例的端口 | 给实例换一个端口 |
cloudcli_register_failed | 这个 CloudCLI 已有一个密码不同的管理员，中枢多半重置或重装过 | 被控端自动给这个实例换一个新的数据库文件；旧文件留在机器上 |
Codeg
| 症状 | 原因 | 处理 |
|---|---|---|
codeg_download_failed | 服务端包或 Node.js 包没从中枢传到机器上，或没能解包 | 先确认中枢自己下载好了这两个包，再在机器上选一次 安装 或 应用 Codeg |
codeg_port_taken | 机器上另一个程序占着这个实例的端口 | 给实例换一个端口，再选 应用 Codeg |
VS Code
| 症状 | 原因 | 处理 |
|---|---|---|
terms_not_accepted | 这台机器上还没接受微软的条款 | 在 VS Code 标签上选 打开并接受条款 |
code-server
| 症状 | 原因 | 处理 |
|---|---|---|
secret_missing | 中枢没有给这个实例发令牌密钥 | 再应用一次；保险库锁着时先照锁定一节处理 |
code_server_download_failed | 发布包没能下载或解包 | 确认机器能访问发布包的地址，再应用一次 |
code_server_port_taken | 机器上另一个程序占着这个实例的端口 | 给实例换一个端口 |
远程桌面
模块标签上写着失败的那一步。共享开着、客户端却连不上的码，见远程桌面打不开。
| 症状 | 原因 | 处理 |
|---|---|---|
rdp_takeover_failed | 启动被控端 RustDesk 的某一步失败 | 按码后面的细节处理，再选 应用远程桌面 |
rdp_restore_failed | 还原机器原来的 RustDesk 的某一步失败 | 按码后面的细节处理，再选 应用远程桌面 |
终端
| 症状 | 原因 | 处理 |
|---|---|---|
path_invalid | shell 程序不是完整路径 | 填完整路径，或用 浏览… 选中程序 |
shell_program_unusable | 机器上没有这个程序，或者它不能运行；nclient terminal exec 时指命令的程序 | 换一个程序，或把 Shell 程序 留空；exec 时检查命令的名字或路径 |
AI 工具
这些写在 全局配置 里账户行的下面。cc_switch_download_failed 见AI 工具没走网关。
| 症状 | 原因 | 处理 |
|---|---|---|
gateway_not_serving，开关打不开 | 中枢的 AI 网关还没有可用的模型 | 先在面板 AI 页加好提供方或登录订阅 |
switch_failed | cc-switch 没能把工具指向网关，后面带细节 | 按细节处理，再把开关关掉、打开 |
| cc-switch 没能把工具改回原来的设置： | 切回失败；原来的文件留着 | 再按一次开关，下次切回时写回原来的文件 |
客户端的某一页连不到服务
这些码写在客户端条目的那一行上。agent_offline 见设备离线，permission_denied 见客户端连不上。
| 症状 | 原因 | 处理 |
|---|---|---|
connect_failed，原因 refused | 那台机器上服务的端口没有程序在监听 | 在那台机器上启动这个服务或模块 |
connect_failed，原因 timeout | 服务 10 秒内没有应答 | 确认机器和服务都在运行 |
connect_failed，原因 unreachable | 中枢连不到 服务 页上手动声明的那个地址 | 核对声明的地址，确认中枢连得到它 |
port_not_published | 那台机器不再发布这个端口：容器、实例或共享停了 | 在 模块 页上把它重新启动 |
service_unknown | 中枢已不再发布这个条目 | 刷新客户端，用列表里还在的条目 |
connect_limit | 这个客户端经中枢开着的连接到了 256 条 | 关掉用不着的转发或程序 |
port_taken | 本机别的程序占着 指定 的本地端口 | 在条目上选 配置，换一个端口 |
web_token_missing | 中枢没给这个网页条目令牌 | 再选一次 打开 |
电脑上挂不上共享
这些码写在桌面客户端 文件 页那一行上。share_unreachable 在电脑和手机上相同，见手机上连不上共享。
| 症状 | 原因 | 处理 |
|---|---|---|
mountpoint_invalid | 路径不在你的家目录下 | 填家目录下的文件夹，例如 ~/nas/media |
mountpoint_not_drive_letter | Windows 上选的不是空闲盘符 | 选一个空闲盘符，例如 N: |
mountpoint_not_empty | 文件夹里有文件 | 换一个空文件夹 |
mountpoint_in_use | 另一个共享已设成挂在这个位置，不论它来自哪台中枢 | 换一个位置，或先改那个共享的位置 |
mount_not_authorized | macOS 的登录框关掉了；或者 Linux 上的客户端是从 ssh 登录这类非桌面会话里启动的，polkit 不弹窗口，直接拒绝挂载 | macOS 上再选一次 挂载，在登录框里填对密码；Linux 上从桌面启动客户端，或在 ssh 里经 systemd-run --user 启动它，再选 挂载 |
mount_timed_out | macOS 十分钟内没挂好 | 再选一次 挂载 |
mount_tooling_missing | 缺 root 辅助程序或 mount.cifs | 重装客户端的包，它依赖 cifs-utils |
pkexec_missing | Linux 上没有 pkexec，挂载要经过它 | 用发行版的包管理器装上 pkexec，再选 挂载 |
credentials_missing | 保存登录信息的文件没了 | 选 配置，重新输入密码 |
share_login_rejected | 共享不接受这个用户名或密码 | 配置 自动打开，重新输入两者 |
share_access_denied | 密码不对，或这个账号不能用这个共享 | 核对密码；在面板 文件共享 标签的 谁可以用 里勾上这个用户 |
share_not_found | 主机上没有这个共享名 | 在面板上核对共享还在 |
share_session_conflict | Windows 已用另一个账号连着这台服务器 | 先断开那个连接，再挂载 |
files_adapter_unavailable | Windows 上 NeutrinoClientFiles 服务缺失、停止或出错 | 看码后面的原话，运行 sc query NeutrinoClientFiles；服务缺失时重装客户端 |
files_adapter_in_use | Windows 上文件适配器正归这台电脑上另一个账户的客户端使用 | 让那个账户退出客户端，你的客户端随后自己再挂一次 |
| 条目变灰，写着 当前无法访问 | 提供共享的机器关着，或没有连到中枢 | 让那台机器重新上线 |
手机上连不上共享
Android 应用的共享出现在系统的“文件”应用里，出错时显示错误码对应的那句话。
| 症状 | 原因 | 处理 |
|---|---|---|
share_unreachable | 连不上中枢的 8443 端口，或提供共享的机器关着、没连着中枢 | 先看中枢那一行：不是 已连接 就经 外部访问 页上的一条路连上中枢；已连接就让那台机器上线。电脑上恢复后客户端自己再挂 |
| “文件”里显示 请先在文件页输入这个共享的密码。 | 这部手机还没有这个共享的登录信息 | 在应用的文件屏打开这个共享，输入用户名和密码，选 连接 |
终端关闭
这些码写在终端标签的下面。agent_offline 见设备离线，permission_denied 见客户端连不上。
| 症状 | 原因 | 处理 |
|---|---|---|
session_not_owned | 客户端只能进自己开的会话或共享的会话，这个会话两者都不是；或者 persist、share 不是由打开它的客户端拨的 | 让打开它的一方打开 共享，或自己新开一个终端 |
session_unknown | 会话已结束，或被控端重启、升级过，那台机器上的会话全部结束；或者给 attach、persist、share、stop 的 id 对不上任何会话 | 在那台机器上新开一个终端 |
shell_unknown | 中枢上已经没有客户端要调整大小的那个 shell | 在客户端里关掉这个终端，再打开 |
unknown_terminal | 中枢没有提供那台机器的终端 | 换成客户端 终端 页里列出的机器 |
远程桌面打不开
这些码写在客户端 远程桌面 页那一行上，或面板 设备 页的机器抽屉里。
| 症状 | 原因 | 处理 |
|---|---|---|
| 页面写着 还没有共享的远程桌面 | 没有机器在共享，或共享的机器离线 | 在面板 模块 页那台机器的 远程桌面 标签上打开共享 |
rdp_viewer_open | 这个桌面已经开着一个查看器 | 关掉那个查看器窗口，再选 连接 |
rdp_not_shared | 那台机器停止了共享 | 在那台机器的 远程桌面 标签上重新打开共享 |
rdp_nobody_seated | 那台机器的屏幕前没有人登录 | 在那台机器上登录一个桌面会话 |
rdp_screen_not_allowed | 那台机器的 Wayland 会话还没允许过屏幕共享 | 在那台机器的屏幕前允许一次屏幕共享 |
rdp_permissions_needed | 那台 Mac 还没给 RustDesk 屏幕录制和辅助功能权限 | 在那台 Mac 的系统设置里给 RustDesk 打开 屏幕录制 和 辅助功能 |
rdp_no_desktop | 本机这个会话没有屏幕给查看器用 | 在有桌面的会话里打开客户端 |
rdp_launch_failed | 查看器没能启动，码后面是原因 | 按原因处理；仍不行就重装客户端 |
AI 工具没走网关
| 症状 | 原因 | 处理 |
|---|---|---|
no_exit_hub | 打开开关时，那台中枢没连着 | 等中枢那一行写 已连接，再打开开关 |
no_endpoint | 中枢还没给这个客户端发密钥 | 在中枢的 AI 页吊销这个客户端的密钥，让中枢重新发一个，或重新加入 |
| 选了 保存 之后，工具仍用原来的配置 | 配置 里的 保存 只记下选择，不改工具的指向 | 打开条目上的 AI 工具使用此网关；nclient service ai show 打印工具现在指向哪里 |
面板上写着 gateway_unreachable | 网关进程没在运行 | Linux 上运行 systemctl status neutrino_hub_cliproxyapi；其他系统上看 AI 页的 日志 |
| 某个工具什么都连不上 | 工具指向客户端在 127.0.0.1 上的转发，客户端开着时这个转发才在 | 启动客户端，让它在托盘里一直开着 |
login_expired | 订阅登录拖得太久，这次登录过期了 | 关掉对话框，在 AI 页重新选 登录，尽快走完 |
某个账户写着 cc_switch_download_failed | 那台机器的被控端没能从中枢取到 cc-switch | 确认中枢能上网，再在 全局配置 里把开关关掉再打开 |
ai_tools_managed | 这台电脑装了被控端，AI 工具由中枢设置 | 在面板的 模块 页选这台电脑，在 全局配置 里设它的 AI 工具 |
日志在哪
| 想看什么 | 在哪 |
|---|---|
| 初始化的过程 | 中枢上的 /var/log/neutrino/hub/setup.log |
| Linux 上的中枢 | 各单元的 journal：journalctl -u neutrino_hub_web -n 200，其他单元同理，例如 neutrino_hub_xray、neutrino_hub_dnsmasq、neutrino_hub_cliproxyapi、neutrino_hub_netbird、neutrino_hub_easytier、neutrino_hub_relay |
| macOS 上的中枢 | /Library/Logs/Neutrino/hub/，每个进程一个 <name>.log |
| Windows 上的中枢 | C:\ProgramData\Neutrino\hub\log\，每个进程一个 <name>.log |
| 一次中枢升级 | Linux 上 journalctl -u neutrino_hub_update；macOS 和 Windows 上中枢日志目录里的 hub_update.log |
| Linux 上的被控端 | 在那台机器上运行 journalctl -u neutrino_agent -n 200 |
| Windows 上的被控端 | C:\ProgramData\Neutrino\agent\log\agent.log |
| macOS 上的被控端 | /Library/Logs/Neutrino/agent/agent.log |
| Linux 上的桌面客户端 | ~/.config/neutrino/client/client.log |
| macOS 上的桌面客户端 | ~/Library/Logs/Neutrino/client/client.log |
| Windows 上的桌面客户端 | %LOCALAPPDATA%\Neutrino\client\client.log |
| 面板里看 AI 网关 | AI 页的 日志 |
| 一次渲染会生成什么 | 中枢上的 sudo nhub apply --dry-run |