此文档将为用户提供 Cloudnet 各平台客户端的安装指南。
如果您的设备不在以下支持的系统或平台列表中,您可以登录用户中心 创建支持单, 并提供您的设备信息,我们将尽可能为您提供适配和支持。
此文档将为用户提供 Cloudnet 各平台客户端的安装指南。
如果您的设备不在以下支持的系统或平台列表中,您可以登录用户中心 创建支持单, 并提供您的设备信息,我们将尽可能为您提供适配和支持。
支持: Windows 10/11, Windows Server 2016/2019/2022
目前已支持的架构: x86(386)/amd64/arm/arm64
桌面客户端需要 Windows10+ 才能运行.
由于安全和兼容问题,我们已经放弃对 Windows 7/8, Server 2008/2012 系统的支持.
管理员权限网页登录时需要浏览器支持: Microsoft Edge 79(2019)+, GoogleChrome/Firefox/Safari在 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
# 查看当前设备状态,或者登录用户中心查看设备是否已注册成功.
支持的 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
面向多种 Linux 发行版的客户端安装指南。
支持的系统和版本: 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
支持的 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
支持的 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
支持的 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
tar x -vC / -f cloudnet_<version>_<arch>.tar
opkg update
opkg install libustream-openssl ca-bundle kmod-tun
# 启动服务
/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
/etc/init.d/cloudnet enable
# 通过查找以下条目来验证:
ls /etc/rc.d/S*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
支持的 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
提要:openEuler 使用 DNF(兼容 YUM)的 RPM 包管理。现已支持通用一键安装脚本(
install.sh)。若希望最少步骤,建议优先使用“一键安装”;同样支持“手动添加并使用 Cloudnet RHEL 风格仓库(https://pkgs.cloudnet.world/stable/rhel/)”。覆盖
.repo配置、GPG 导入、缓存刷新、安装/卸载、问题诊断与安全建议。关键词:openEuler、RPM、DNF、YUM、Cloudnet、RHEL 仓库、repo、GPG、公钥、软件源。
root 或 sudo 权限openEuler 是 RPM 系,使用 DNF/YUM 管理
.rpm与.src.rpm包;仓库配置文件位于/etc/yum.repos.d/。
打开终端,执行以下命令自动完成仓库配置、GPG 导入与软件安装:
curl -fsSL https://pkgs.cloudnet.world/stable/install.sh | sh
systemctl status cloudnetd
说明:
脚本会自动识别 openEuler 环境并配置 Cloudnet RHEL 风格仓库、导入 GPG、公钥校验并安装 cloudnet。
支持自动启用并启动 cloudnetd 服务。若未自动启动,可手动执行:
sudo systemctl enable --now cloudnetd
如需更细粒度控制或离线/受限环境,请参考下方“手动配置仓库”方式。
sudo curl -fsSL -o /etc/yum.repos.d/cloudnet.repo \
https://pkgs.cloudnet.world/stable/rhel/cloudnet.repo
sudo rpm --import https://pkgs.cloudnet.world/stable/rhel/repo.gpg
sudo dnf clean all
sudo dnf makecache
sudo dnf repolist
看到名为 Cloudnet stable(或相近名称)的条目,即表示仓库加载成功。
sudo dnf install cloudnet
# 或者
sudo yum install cloudnet
.repo 文件要点(核查清单)/etc/yum.repos.d/cloudnet.repo 中核心字段通常包括:
name:仓库名称(展示用)baseurl=https://pkgs.cloudnet.world/stable/rhel/enabled=1:启用仓库repo_gpgcheck=1:校验仓库元数据签名(建议开启)gpgcheck=0:是否校验单个包签名(可按需改为 1)gpgkey=https://pkgs.cloudnet.world/stable/rhel/repo.gpg安全建议:
- 保持
repo_gpgcheck=1,并导入对应repo.gpg。- 如仓库提供包级签名,建议把
gpgcheck改为1,并确保gpgkey指向正确公钥。
dnf search <关键词>
dnf info <包名>
sudo dnf install <包名>
sudo dnf upgrade -y
sudo dnf --enablerepo=cloudnet-stable install <包名>
sudo dnf --disablerepo=cloudnet-stable install <包名>
提示:仓库 ID 以
.repo中的节名为准(如[cloudnet-stable]),可能与name字段不同。
# 查看命令行帮助
cnet start --help
cnet start --accept-dns=false --accept-routes=false
cnet start --accept-dns=false --accept-routes=false --auth-key=<PreAuthKey>
1)repomd.xml/签名校验失败
重新导入公钥:
sudo rpm --import https://pkgs.cloudnet.world/stable/rhel/repo.gpg
检查网络与代理、确认 baseurl 可访问。
临时排查可设 repo_gpgcheck=0(排障后请恢复为 1)。
2)找不到包 / 依赖冲突
sudo dnf clean all && sudo dnf makecachednf --enablerepo=<id> info <包名>module/compat 包或启用 EPEL 风格兼容源(若适配)。3)被其它仓库“覆盖”
在 cloudnet.repo 中调高优先级(若系统启用 priority 插件):
priority=1
数字越小优先级越高。请谨慎使用,避免系统包被不必要替换。
sudo。repo_gpgcheck=1;尽量开启 gpgcheck=1 并正确配置 gpgkey。.repo 改动纳入配置管理(如 Ansible / Git)。# /etc/yum.repos.d/cloudnet.repo
enabled=0
sudo rm -f /etc/yum.repos.d/cloudnet.repo
sudo dnf clean all
Q:openEuler 是 deb 还是 rpm? A:openEuler 属于 RPM 系,使用 DNF(兼容 YUM)。
Q:仓库只支持 RHEL/CentOS 吗? A:Cloudnet 提供的是 RHEL 系风格的 RPM 仓库。openEuler 同为 RPM + DNF 生态,通常可直接使用,但仍需按包、依赖与 ABI 实测验证。
Q:必须导入 GPG 公钥吗?
A:强烈建议。启用 repo_gpgcheck=1 需要导入公钥以校验仓库元数据签名;若你开启 gpgcheck=1,也需要公钥校验包签名。
| 关键词 | 用途 |
|---|---|
| openEuler RPM | 指明发行版与包格式 |
| DNF / YUM | 包管理器生态 |
| Cloudnet RHEL 仓库 | 第三方软件源 |
.repo 配置 |
软件源启用方法 |
| GPG / repo.gpg | 元数据与包签名校验 |
sudo dnf update cloudnet
# 或者
sudo yum update cloudnet
# 或者
cnet upgrade
sudo dnf remove cloudnet
# 或者
sudo yum remove cloudnet
# 或者
cnet uninstall
#!/usr/bin/env bash
set -euo pipefail
REPO_DIR="/etc/yum.repos.d"
REPO_URL="https://pkgs.cloudnet.world/stable/rhel"
REPO_FILE="${REPO_DIR}/cloudnet.repo"
sudo curl -fsSL -o "${REPO_FILE}" "${REPO_URL}/cloudnet.repo"
sudo rpm --import "${REPO_URL}/repo.gpg"
sudo dnf clean all
sudo dnf makecache
sudo dnf repolist
echo "Cloudnet repo installed. Try: sudo dnf search <pkg> or sudo dnf install <pkg>"
# 安装 Cloudnet 客户端示例
sudo dnf install cloudnet || sudo yum install cloudnet
# 注册设备示例
cnet start --accept-dns=false --accept-routes=false
在生产环境执行前,请先打开
cloudnet.repo核对baseurl、repo_gpgcheck、gpgcheck、gpgkey等配置。
到这里,你已经在 openEuler 上添加、校验并启用了 Cloudnet 仓库,并掌握了日常使用、诊断与回滚方法。接下来可以选一个目标包做小范围部署验证,再决定是否纳入系统基线。需要我根据你的 openEuler 版本与 CPU 架构,给出兼容性与依赖评估清单,也可以继续。
支持的 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
支持的 Android 安卓版本: Android 8 or later.
Android 版本已就绪, 根据国家监管政策, 移动端还在申请管局做合规审查中, 合规通过才能上线.
支持的 iOS 版本: iOS 15.0 or later.
iOS 版本已就绪, 根据国家监管政策, 移动端还在申请管局做合规审查中, 合规通过才能上线.
随着容器化技术的发展, 以及容器化环境的普及, 我们也为容器化环境提供了客户端部署方案.
支持的 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
由于容器自身的限制性, 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