Windows

目前已支持的架构: x86(386)/amd64/arm/arm64

桌面客户端需要 Windows10+ 才能运行.

由于安全和兼容问题,我们已经放弃对 Windows 7/8, Server 2008/2012 系统的支持.

安装桌面客户端

安装要求

• Windows 10/11, Windows Server 2016/2019/2022
• x86_64(amd64) 架构
• Powershell 5.0+ (Windows10,2015 年以后发布的版本均已支持)
• 安装和运行均需要管理员权限
• 网页登录时需要浏览器支持: Microsoft Edge 79(2019)+, GoogleChrome/Firefox/Safari
• 不支持 IE 浏览器, 如果浏览器无法登录请改用密钥登录

在 Windows Server 上安装时如果提示缺少 wlanapi.dll, 解决办法是安装 Wireless LAN Service 服务即可.

通过下载安装

安装 Cloudnet 客户端: 点此下载

桌面客户端已内置 cnet 命令行工具.

通过在线脚本安装

在线安装适用于 Windows 10/11 x64、Windows PowerShell 5.1 及以上版本，从 CloudNet 1.36.2.23 起提供。脚本会下载并校验官方桌面安装包，再打开安装向导。它安装的是完整桌面客户端；仅需核心命令行客户端时，请查看本页下方的对应说明。

以管理员身份打开 Windows PowerShell；如果使用 Windows Terminal，请选择其中的 PowerShell 配置文件。执行：

# 首次安装或覆盖升级，使用同一条命令
irm https://pkgs.cloudnet.world/stable/installer.ps1 | iex

按安装向导完成安装。首次安装后，在客户端托盘菜单中选择“安装服务(管理员)”并完成授权，再选择“登录网络”。已有设备覆盖升级会保留身份和配置，无需重新入网。

脚本只接受 1.36.2.23 及之后的安装包，拒绝自动降级；发现已验证的相同安装包时会跳过安装。下载中断后可再次执行命令，脚本会尝试继续下载并重新校验。安装程序不会自动重启电脑。

安装操作会尝试将 CloudNet 核心数据目录（%ProgramData%\Cloudnet）、下载缓存（%LOCALAPPDATA%\CloudNet\InstallerCache）和安装目录加入 Windows Defender 排除列表，减少误报干扰。已有安装使用注册表中记录的实际目录；首次安装先添加默认目录，安装成功后补充向导选择的自定义目录。排除设置会保留，取消安装也不会自动移除。此操作不关闭实时保护；restart 和帮助命令不会更改 Defender 设置。

查看脚本帮助：

& ([scriptblock]::Create((irm https://pkgs.cloudnet.world/stable/installer.ps1))) -h

通过命令行安装

请使用管理员权限打开 Windows PowerShell 或 Windows Terminal, 然后执行以下步骤:

# 注意: 由于需要微软官方审核, 因此通过此命令安装的客户端可能不是最新版本
winget install cloudnet.cloudnet

注册设备

通过客户端注册(推荐)

在注册设备前,您需要先登录用户中心创建子网,然后才能在客户端上进行登录网络.

• 启动程序
• 如提示安装或升级服务，请完成管理员授权；也可从托盘菜单选择“安装服务(管理员)”
• 点击托盘图标, 在弹出菜单中点击 登录网络
• 选择 网页登录 或 授权码登录
• 如果选择 网页登录, 会自动打开浏览器, 请在浏览器中完成登录
• 如果选择 授权码登录, 请在弹出的对话框中输入授权密钥即可

通过命令行注册

命令行工具在您安装目录下的 core 文件夹中,您需要将该文件夹添加到环境变量中才能使用

# 默认安装路径为 C:\Program Files\CloudNet
$env:Path += ";C:\Program Files\CloudNet\core"
# 查看环境变量
echo $env:Path
# 查看命令帮助
cnet

网页注册

cnet start - --accept-dns=false --accept-routes=false
# 请将输出的 URL 复制到浏览器中打开完成注册

密钥注册

cnet start - --accept-dns=false --accept-routes=false --auth-key=<PreAuthKey>

更新客户端

可以再次运行在线安装命令，按向导覆盖升级：

irm https://pkgs.cloudnet.world/stable/installer.ps1 | iex

也可以继续使用 WinGet。由于软件源审核和同步需要时间，WinGet 提供的版本可能晚于官方安装包：

winget upgrade cloudnet.cloudnet

重新打开桌面客户端

在管理员 PowerShell 中执行：

& ([scriptblock]::Create((irm https://pkgs.cloudnet.world/stable/installer.ps1))) restart

restart 只退出并重新打开当前会话中的 CloudNet 桌面程序，不会重启网络服务或电脑，也不会重新下载或安装客户端。它与托盘菜单中的“重启服务(管理员)”是不同的操作。

脚本也支持通过环境变量指定操作；显式参数优先。执行后清除变量，避免影响下一次安装命令：

$env:CLOUDNET_ACTION='restart'
irm https://pkgs.cloudnet.world/stable/installer.ps1 | iex
Remove-Item Env:CLOUDNET_ACTION

在线安装常见问题

• 提示需要管理员权限：关闭当前普通终端，以管理员身份打开 PowerShell 后重新执行。仅查看帮助不需要管理员权限。
• 提示无法添加 Defender 排除项：系统未提供 Defender 命令或策略拒绝修改时，脚本会提示并继续安装；若安装包仍被拦截，请保留检测信息交由管理员核实。
• 提示在线安装尚未就绪：更新源还没有提供 1.36.2.23 或更高版本，请等待该版本发布；脚本不会运行旧安装器。
• 下载中断或超时：恢复网络后重新执行安装命令。下载进度缓存会保留，脚本会尝试断点续传。
• 长度或 SHA-256 校验失败：脚本会刷新下载信息并重新下载；连续失败时会停止安装。请稍后重试，不要手动运行校验失败的缓存文件。
• 取消安装或安装器报错：脚本不会写入成功安装记录。保留终端中的错误信息，处理原因后重新执行命令。
• 返回 3010：安装器报告需要手动重启 Windows，脚本不会代为重启，也不会将此次安装标记为完成。请自行选择合适时间手动重启，之后重新运行脚本完成检查。
• 提示已安装版本更高：脚本已阻止降级，请继续使用现有版本，或等待官方更新源提供更新版本。

卸载客户端

winget uninstall cloudnet.cloudnet

安装命令行客户端

注意: 您需要对操作系统有一定的技术基础. 如无技术背景请勿尝试, 我们仅对企业用户提供技术支持.

此版本适用于: 面向 Windows Core 系统和 arm/arm64/386 架构而适配, 无需图形界面, 仅支持命令行操作.

下载 zip 格式的压缩包后, 请将其解压到任意目录(目录名不能是中文), 然后在该目录下打开命令行窗口即可使用.

下载地址: https://pkgs.cloudnet.world/stable/windows/

cd "C:\Program Files"
mkdir CloudNet
# 将压缩包的文件解压到目录: "C:\Program Files\CloudNet"

# 安装并启动服务,注意:"= "后面的空格不能省略
sc create Cloudnet binPath= "C:\Program Files\CloudNet\Cloudnetd.exe"
sc config Cloudnet start= auto
sc start Cloudnet

# 启动服务并注册设备,网页注册
cloudnet.exe up --accept-dns=false --accept-routes=false
# 将此命令生成的 URL 地址复制并在任意浏览器打开,然后登录您的账户并完成注册.

# 密钥注册,需要在用户中心提前生成授权密钥,然后将密钥替换 <PreAuthKey> 即可.
cloudnet.exe up --accept-dns=false --accept-routes=false --auth-key=<PreAuthKey>

cloudnet.exe status
# 查看当前设备状态,或者登录用户中心查看设备是否已注册成功.