在统信uos系统部署apollo需适配国产环境:确认uos v20 1050d+版本及x86_64/arm64架构,启用ssh并切换java 11为默认,mysql 8.0安装后须执行secure_installation并创建apollo专用用户,通过docker或源码构建方式启动服务,开放8070端口并配置portal数据库连接后访问http://localhost:8070登录。

在统信UOS系统上部署Apollo配置中心,需适配国产化环境的Java、MySQL与Docker依赖,避免直接套用Ubuntu通用脚本导致服务启动失败或端口冲突。
确认UOS系统版本与基础环境
执行 cat /etc/os-release 查看当前UOS版本,确保为V20 1050d或更高版本;低于此版本可能缺少systemd服务管理能力或apt源兼容性支持。
运行 uname -m 确认CPU架构,x86_64可直接使用官方Docker包,ARM64(如鲲鹏、飞腾平台)必须使用Apollo官方提供的arm64镜像或源码编译部署。
【关键前提】 UOS默认禁用root远程登录且关闭SSH密码认证,若通过远程终端操作,请先执行 sudo passwd root 并启用SSH: sudo systemctl enable ssh && sudo systemctl start ssh。
安装Java 11与MySQL 8.0
UOS自带openjdk-11-jdk,但默认未设为系统默认Java,需手动切换:
执行 sudo apt update && sudo apt install -y openjdk-11-jdk;
运行 sudo update-alternatives --config java,选择openjdk-11路径并回车确认;
验证: java -version 输出应含 11.0.x 且无 OpenJDK Runtime Environment (build 11.0.x+...) 报错。
MySQL需从UOS应用商店安装「MySQL Server 8.0」或手动导入官方deb包——【不可跳过】 安装后立即执行 sudo mysql_secure_installation 设置root密码并禁用匿名用户,否则Apollo初始化脚本会因权限拒绝而中断。
配置Apollo专用数据库
登录MySQL:mysql -u root -p,输入刚设的密码;
执行:CREATE DATABASE apolloconfigdb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;;
创建专用用户:CREATE USER 'apollo'@'localhost' IDENTIFIED BY 'StrongPass@2026';;
授权:GRANT INSERT,UPDATE,DELETE,SELECT ON apolloconfigdb.* TO 'apollo'@'localhost'; FLUSH PRIVILEGES;;
退出MySQL,该用户将用于后续Apollo服务连接,不可复用root账号——否则Portal界面登录后无法加载部门/应用列表。
获取并启动Apollo服务容器
方法一:使用UOS兼容Docker镜像(推荐)
执行:wget https://apollo-bj.bcebos.com/apollo-uos-v2.10.0.tar.gz && tar -xzf apollo-uos-v2.10.0.tar.gz;
进入解压目录:cd apollo-uos;
修改 docker-compose.yml 中 apollo-configservice 和 apollo-adminservice 的 environment 区块,将 APOLLO_DB_URL 改为 jdbc:mysql://host.docker.internal:3306/apolloconfigdb?useSSL=false&serverTimezone=Asia/Shanghai;
运行:sudo docker-compose up -d,等待约90秒后检查容器状态:sudo docker ps -a | grep apollo,三个服务(admin、config、portal)状态必须为 Up 才算成功。
方法二:手动构建镜像(仅限ARM64平台)
克隆官方源码:git clone https://github.com/apolloconfig/apollo.git && cd apollo;
检出适配分支:git checkout uos-arm64-support-2026;
执行:mvn clean package -DskipTests -Pgithub-profile,生成 apollo-configservice/target/apollo-configservice.jar 等三份jar包;
按 scripts/docker-build.sh 脚本逐个构建镜像,注意替换Dockerfile中FROM行改为 openjdk:11-jre-slim-arm64v8。
配置Portal访问与初始登录
第一步:开放UOS防火墙端口
执行:sudo ufw allow 8070(Portal默认端口),若UOS未启用ufw则改用:sudo iptables -I INPUT -p tcp --dport 8070 -j ACCEPT;
第二步:修改Portal数据库连接
进入容器:sudo docker exec -it apollo-portal bash;
编辑配置文件:vi /opt/apollo-portal/conf/application-github.properties;
找到 spring.datasource.url 行,将 localhost 替换为 host.docker.internal,保存退出;
第三步:重启Portal服务
执行:sudo docker restart apollo-portal;
等待30秒后,在UOS浏览器中访问 http://localhost:8070,输入默认账号 apollo / admin 即可进入管理界面。











