安装客户端

客户端装在一个人的电脑上，以这个人的普通账户运行，Linux、Windows 和 macOS 都有包。装好并粘贴链接后，窗口显示 已连接（Connected）和五个面板。

开始之前

• 一台有桌面会话的电脑。支持的系统在支持的平台里。
• 一个普通账户。nclient 拒绝以 root 运行。
• 这台电脑能访问 hub 的 8443 端口。

在客户端页新建链接

1. 在面板的 客户端（Clients）页点 新建客户端链接（New client link）。

   

2. 在名称里填这台电脑的名字，例如 laptop，点 创建链接（Create link）。

3. 点 复制（Copy）。链接五分钟内有效。

设备页发的链接给被控端；把那种链接粘进客户端时，客户端返回 link_not_for_client。

安装包

从 Releases 下载对应的包。

Debian 系

sudo apt install ./neutrino-client_0.2.0_amd64.deb
nclient gui

RHEL 系

sudo dnf install ./neutrino-client-0.2.0-1.x86_64.rpm
nclient gui

Windows

msiexec /i neutrino-client-0.2.0-windows-amd64.msi

macOS

sudo installer -pkg neutrino-client-0.2.0-macos-arm64.pkg -target /

Linux 上的包声明了对 WebKitGTK、托盘指示器、cifs-utils 和 polkitd 的依赖，包管理器一并装上。窗口从应用菜单的 Neutrino Client 打开，或者运行 nclient gui。

Windows 上也能双击 msi。安装程序显示一个把 nclient 命令加进 PATH 的选项；不加也能从开始菜单打开窗口。机器上没有 WebView2 运行时的话，安装程序顺带装上。卸载程序显示一个保留这个人配置的选项。

macOS 上的包只有 Apple 芯片版本，应用装在 /Applications，nclient 链到 /usr/local/bin。Gatekeeper 第一次会拦：右键 pkg 选“打开”。点应用图标即打开窗口。

三个系统上，关闭窗口只是隐藏它，客户端仍在运行。托盘菜单里有 打开（Open）和 退出（Quit）。托盘图标的位置：Windows 在任务栏角落，Linux 在顶栏的指示器区，macOS 在菜单栏。

粘贴链接

1. 打开窗口。状态卡写着 未连接（Not connected），下面一行提示粘贴 hub 客户端页面上的链接。

   

2. 把链接粘进输入框，点 连接（Connect）。

状态卡变成 已连接，写着 hub 的版本；服务（Services）区画出五个面板。

同一件事在终端里是一条命令：

nclient connect 'neutrino://enroll/PLACEHOLDER_LINK'

五类服务的用法

面板	条目从哪来	按钮
网页	Gitea 模块，手动声明的网址	打开
端口	容器发布的端口，手动声明的 TCP 端口	连接、断开
AI	hub 的 AI 网关	配置、应用
文件	Samba 模块，手动声明的共享	配置、挂载
远程桌面	机器自己共享的桌面	连接