Windows

Windows 客户端安装指南

支持: Windows 10/11, Windows Server 2016/2019/2022

目前已支持的架构: 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 PowerShellWindows 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>

更新客户端


winget upgrade cloudnet.cloudnet

卸载客户端


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
# 查看当前设备状态,或者登录用户中心查看设备是否已注册成功.
最后修改 2024.02.19: dev (3a3adeb)