这是本节的多页打印视图。点击此处打印.

安装客户端

Cloudnet 全平台客户端安装指南

1: Windows
2: macOS
3: Linux

3.1: RedHat 系统家族
3.2: Debian 系统家族
3.3: SUSE 系统家族
3.4: OpenWRT 系统家族
3.5: 树莓派 Raspberry Pi OS
3.6: 群晖 Synology DSM/SRM

4: FreeBSD
5: Android
6: iOS
7: Container

7.1: Docker
7.2: Kubernetes

此文档将为用户提供 Cloudnet 各平台客户端的安装指南。

如果您的设备不在以下支持的系统或平台列表中，您可以登录用户中心 创建支持单, 并提供您的设备信息，我们将尽可能为您提供适配和支持。

1 - 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 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>

更新客户端

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
# 查看当前设备状态,或者登录用户中心查看设备是否已注册成功.

2 - macOS

macOS 客户端安装指南

支持的 macOS 版本: macOS10.15+, x64/ARM 架构均已支持

桌面版客户端支持: macOS12+

命令行客户端支持: macOS10.15+

安装桌面版客户端

适用于 macOS12+ 的系统, 您可以通过以下方式安装:

通过下载安装

安装 Cloudnet 客户端: 点此下载

桌面客户端已内置命令行工具,无需再安装命令行客户端.

通过命令行安装

打开 终端 或 iTerm, 然后执行以下步骤:

# 注意: 由于需要 brew 官方审核, 因此通过此命令安装的客户端可能不是最新版本
brew install --cask cloudnet
# 或者
curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh

注册设备

通过客户端注册(推荐)

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

启动程序
首次安装或升级后, 会自动弹出授权窗口, 需要您授予管理员权限才能安装或升级
点击托盘图标, 在弹出菜单中点击 登录网络
选择 网页登录 或 授权码登录
如果选择 网页登录, 会自动打开浏览器, 请在浏览器中完成登录
如果选择 授权码登录, 请在弹出的对话框中输入授权密钥即可

通过命令行注册

命令行工具在 /usr/local/cloudnet/bin, 您需要将该目录添加到环境变量中才能使用

网页注册

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

密钥注册

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

更新客户端

brew upgrade --cask cloudnet

卸载客户端

brew uninstall --cask cloudnet

安装命令行客户端

适用于 macOS10.15+ 的旧版本系统, 您可以通过以下方式安装:

brew install dayunet2009/tap/cloudnet
sudo brew services restart cloudnet

更新客户端

brew upgrade dayunet2009/tap/cloudnet
sudo brew services restart cloudnet

卸载客户端

brew uninstall dayunet2009/tap/cloudnet

3 - Linux

Linux 客户端安装指南, 支持 Debian, Ubuntu, CentOS, Fedora, RHEL, Rocky Linux, Oracle Linux, etc.

面向多种 Linux 发行版的客户端安装指南。

3.1 - RedHat 系统家族

适用于 RedHat 系统家族的安装指南, 支持 CentOS, Fedora, RHEL, Rocky Linux, Oracle Linux, etc.

支持的系统和版本: CentOS 7+, Fedora 19+, RedHat Enterprise Linux 8+, Oracle Linux 7+, Rocky Linux 8+

安装客户端

目前没有为该系统提供桌面版客户端.

打开 终端 或 Terminal, 然后执行以下步骤.

yum install -y epel-release libmodulemd curl ca-certificates tree
yum install -y htop iftop nano bash-completion bash curl sudo lsof

curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh
systemctl status cloudnetd

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

sudo dnf update cloudnet
# 或者
sudo yum update cloudnet
# 或者
cnet upgrade

卸载客户端

sudo dnf remove cloudnet
# 或者
sudo yum remove cloudnet
# 或者
cnet uninstall

3.2 - Debian 系统家族

Debian 系统家族安装 Cloudnet 客户端, 支持 Ubuntu, Debian, Deepin, Kali, Linux Mint, etc.

支持的 Debian 系统家族: Ubuntu 16.04+, Debian 9+, Deepin, Kali, Linux Mint, MX Linux, Pop!_OS, Zorin OS, elementary OS, Parrot OS, PureOS, SteamOS, Tails, Trisquel, etc.

由于基于 Debian 衍生的系统非常多, 但只要内核版本满足要求(kernel≥4.4), 一般都可以兼容.

安装客户端

目前没有为该系统提供桌面版客户端.

打开 终端 或 Terminal, 然后执行以下步骤.

apt update
apt install -y htop iftop nano bash-completion ca-certificates openssl tree apt-transport-https bash curl sudo lsof
timedatectl set-timezone Asia/Shanghai

# fix at debian9 certificate issue
sed -i '/^mozilla\/DST_Root_CA_X3/s/^/!/' /etc/ca-certificates.conf && update-ca-certificates -f

curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh
systemctl status cloudnetd

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

sudo apt update && sudo apt upgrade cloudnet
# 或者
cnet upgrade

卸载客户端

sudo apt remove cloudnet
# 或者
cnet uninstall

3.3 - SUSE 系统家族

SUSE 系统家族安装 Cloudnet 客户端

支持的 SUSE 系统家族: OpenSUSE 15.0+, SUSE Linux Enterprise Server (SLES) 12+, SUSE Linux Enterprise Desktop (SLED) 12+, SUSE Linux Enterprise Workstation Extension (SLEWE) 12+

安装客户端

目前没有为该系统提供桌面版客户端.

打开 终端 或 Terminal, 然后执行以下步骤.

curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

sudo zypper update cloudnet
# 或者
cnet upgrade

卸载客户端

sudo zypper remove cloudnet
# 或者
cnet uninstall

3.4 - OpenWRT 系统家族

OpenWRT 系统家族安装 Cloudnet 客户端

支持的 OpenWRT 系统及版本: OpenWRT 17/18/19/21/22, x86_64/armv7/aarch64/mips

OpenWRT 设备至少需要 128MB 的存储空间, 因为 Cloudnet 需要占用 45MB 左右的存储空间.

自动安装客户端

通过 SSH 进入 命令行界面, 然后执行以下步骤.

OpenWRT 默认的 shell 是 ash

# 安装依赖
opkg update
opkg install libustream-openssl ca-bundle kmod-tun bash curl
# 安装客户端
curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

cnet upgrade

卸载客户端

cnet uninstall

在 OpenWRT 上手动安装 Cloudnet

安装包下载: OpenWRT

将 root 目录的内容提取到您的文件系统根目录：

tar x -vC / -f  cloudnet_<version>_<arch>.tar

安装依赖包：

opkg update
opkg install libustream-openssl ca-bundle kmod-tun

首次运行 cloudnet：

# 启动服务
/etc/init.d/cloudnet start
# 注册设备
cloudnet up --accept-dns=false --accept-routes=false
# 示例: 注册设备并声明本地需要路由的网段(内网互通)
cloudnet up --accept-dns=false --advertise-routes=10.0.0.0/24

设置开机时启用 cloudnet：

/etc/init.d/cloudnet enable
# 通过查找以下条目来验证：
ls /etc/rc.d/S*cloudnet*

重启路由器，并确认它在 Cloudnet 用户中心上显示为在线。

3.5 - 树莓派 Raspberry Pi OS

树莓派系统家族安装 Cloudnet 客户端

支持的 Raspberry Pi OS 系统及版本: Raspberry Pi 2/3/4, armv7l

安装客户端

目前没有为该系统提供桌面版客户端.

打开 终端 或 Terminal, 然后执行以下步骤.

apt update
apt install -y htop iftop nano bash-completion ca-certificates openssl tree apt-transport-https bash curl sudo lsof
timedatectl set-timezone Asia/Shanghai

curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

sudo apt update && sudo apt upgrade cloudnet
# 或者
cnet upgrade

卸载客户端

sudo apt remove cloudnet
# 或者
cnet uninstall

3.6 - 群晖 Synology DSM/SRM

本文介绍如何在群晖 NAS/SRM 上安装 Cloudnet 客户端。

支持的 Synology 系统及版本: Disk Station Manager(DSM) 7/8, Synology Router Manager (SRM) 1.3+

安装客户端

通过应用市场安装

Cloudnet 客户端正在计划上线 Synology 应用市场, 请耐心等待.

通过命令行安装

通过 SSH 进入 命令行界面, 然后执行以下步骤.

# 安装客户端,您可能需要 root 权限才能安装成功
curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

cnet upgrade

卸载客户端

cnet uninstall

4 - FreeBSD

FreeBSD 客户端安装指南

支持的 FreeBSD 版本: FreeBSD 12/13

暂不支持 OpenBSD 和 NetBSD, 如果你需要安装到该系统,您可能需要手动安装 tar/zip 版本.

安装客户端

该系统没有提供桌面版客户端, 只有命令行版客户端.

进入 命令行 界面, 然后执行以下步骤.

curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh
# 或者
sudo pkg install cloudnet

注册设备

# 查看命令行帮助
cnet start --help

通过网页注册

cnet start --accept-dns=false --accept-routes=false

通过密钥注册

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

更新客户端

sudo pkg upgrade cloudnet

卸载客户端

sudo pkg delete cloudnet

5 - Android

Android 客户端安装指南

支持的 Android 安卓版本: Android 6+

Android 版本已就绪, 根据国家监管政策, 移动端还在申请管局做合规审查中, 合规通过才能上线.

6 - iOS

iOS 客户端安装指南

支持的 iOS 版本: iOS 15+

iOS 版本已就绪, 根据国家监管政策, 移动端还在申请管局做合规审查中, 合规通过才能上线.

7 - Container

面向容器化环境的客户端部署方案

随着容器化技术的发展, 以及容器化环境的普及, 我们也为容器化环境提供了客户端部署方案.

7.1 - Docker

Docker 安装 Cloudnet 客户端

支持的 Docker 版本: Docker 17+, Docker Compose 1.24+, amd64/arm64

仅支持基于 Linux 环境的 docker 版本, 不支持 macOS/Windows 下的 docker-for-desktop 版本.

安装客户端

# 可设置使用的版本号, 默认为最新版本: latest
export version=1.36.2.10
# amd64
curl -o docker-compose.yml https://pkgs.cloudnet.world/stable/docker-compose.yml && docker-compose up -d --no-build --pull always amd64
# arm64
curl -o docker-compose.yml https://pkgs.cloudnet.world/stable/docker-compose.yml && docker-compose up -d --no-build --pull always arm64

更新客户端

export version=latest
# amd64
curl -o docker-compose.yml https://pkgs.cloudnet.world/stable/docker-compose.yml && docker-compose up -d --wait --force-recreate --no-build --pull always amd64
# arm64
curl -o docker-compose.yml https://pkgs.cloudnet.world/stable/docker-compose.yml && docker-compose up -d --wait --force-recreate --no-build --pull always arm64

卸载客户端

# amd64
docker-compose down --remove-orphans amd64
# arm64
docker-compose down --remove-orphans arm64

FAQ

已知的问题

由于容器自身的限制性, Cloudnet 客户端在容器中运行时会有以下已知问题:

子网路由功能可能无法正常工作;
安全策略(ACL)功能可能无法正常工作;
二层网络模式可能无法正常工作;

7.2 - Kubernetes

Kubernetes 安装 Cloudnet 客户端

支持的 Kubernetes 版本: Kubernetes 1.20+, amd64/arm64

安装客户端

helm repo add cloudnet https://pkgs.cloudnet.world/charts
helm repo update
helm install cloudnet cloudnet/cloudnet -n cnet --create-namespace --set authKey=<PreAuthKey>

更新客户端

helm repo update
helm upgrade -i cloudnet cloudnet/cloudnet -n cnet --set authKey=<PreAuthKey>

卸载客户端

helm uninstall cloudnet -n cnet