统信uos部署rancher有四种方法：一、docker单节点运行；二、docker compose高可用部署；三、使用uos container engine替代docker；四、离线环境导入镜像部署。

如果您在统信UOS操作系统上部署Rancher管理平台，需适配其Debian系底层及国产化环境特性。以下是针对统信UOS的多种可行部署方法：

一、使用Docker直接运行Rancher Server容器

该方法适用于快速验证或测试场景，不依赖Kubernetes，直接以单节点Docker容器形式启动Rancher Server，兼容统信UOS v20（202103及以上）桌面版与服务器版。

1、确认系统已安装Docker并启用服务：sudo apt update && sudo apt install -y docker.io && sudo systemctl enable --now docker

2、拉取Rancher官方镜像（推荐v2.7.11或v2.8.9 LTS版本）：sudo docker pull rancher/rancher:v2.7.11

3、创建持久化目录并运行容器：sudo mkdir -p /opt/rancher && sudo docker run -d --privileged --restart=unless-stopped -p 80:80 -p 443:443 -v /opt/rancher:/var/lib/rancher -v /var/log/rancher:/var/log/rancher rancher/rancher:v2.7.11

4、检查容器状态：sudo docker ps -f name=rancher

二、通过Docker Compose部署高可用Rancher Server

该方式支持绑定自定义域名、启用TLS终止、挂载外部证书，并便于后续扩展为多节点管理集群，适用于生产环境。

1、安装docker-compose（统信UOS需手动安装v2.20+）：sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose

2、创建docker-compose.yml文件（路径：/opt/rancher/docker-compose.yml）：

version: '3.8'

services:

rancher:

image: rancher/rancher:v2.7.11

privileged: true

restart: unless-stopped

ports:

- "80:80"

- "443:443"

volumes:

- /opt/rancher:/var/lib/rancher

- /var/log/rancher:/var/log/rancher

三、基于统信UOS内置容器引擎（UOS Container Engine）部署

统信UOS v2023+版本预装了兼容OCI标准的UOS Container Engine（uce），可替代Docker运行Rancher镜像，降低对第三方运行时依赖。

1、启用UCE服务并配置镜像加速器（如清华源）：sudo uce daemon --registry-mirror=https://mirrors.tuna.tsinghua.edu.cn/docker-images/ &

2、导入Rancher镜像（需先下载tar包）：wget https://github.com/rancher/rancher/releases/download/v2.7.11/rancher-image.tar.gz && sudo uce load -i rancher-image.tar.gz

3、运行容器并指定持久化路径：sudo uce run -d --privileged --name rancher-server --restart=unless-stopped -p 80:80 -p 443:443 -v /opt/rancher:/var/lib/rancher rancher/rancher:v2.7.11

四、离线环境下部署Rancher Server

适用于无外网访问权限的涉密或专网环境，需提前准备完整离线包，包括Rancher镜像、k3s二进制、证书工具及依赖库。

1、在联网机器执行导出命令：sudo docker save rancher/rancher:v2.7.11 -o rancher-v2.7.11.tar

2、将rancher-v2.7.11.tar拷贝至统信UOS目标主机，并加载：sudo docker load -i rancher-v2.7.11.tar

3、同步时间并禁用防火墙临时策略（确保80/443端口开放）：sudo timedatectl set-ntp true && sudo ufw disable

4、运行容器并强制跳过HTTPS重定向（首次访问需用HTTP）：sudo docker run -d --privileged --restart=unless-stopped -p 80:80 -p 443:443 -e CATTLE_SERVER_URL=http://$(hostname -I | awk '{print $1}'):80 -v /opt/rancher:/var/lib/rancher rancher/rancher:v2.7.11