1. 环境准备与基础配置在开始搭建RK3588 Android OTA升级服务器之前我们需要准备一台运行Ubuntu系统的设备作为服务器主机。这里推荐使用Ubuntu 18.04或20.04 LTS版本这两个版本在长期支持周期内稳定性有保障。我实测过多个版本发现这两个版本与Tomcat的兼容性最好基本不会出现奇怪的依赖问题。首先确保你的Ubuntu系统已经更新到最新状态。打开终端执行以下命令sudo apt update sudo apt upgrade -y这个步骤可能会花费一些时间取决于你的网络速度。完成后建议重启一次系统确保所有更新生效。我在实际项目中遇到过因为系统未完全更新导致JDK安装失败的情况所以这个步骤千万别偷懒。接下来需要配置静态IP地址。因为OTA服务器需要长期稳定的网络访问使用DHCP动态获取IP可能会导致客户端无法连接。编辑网络配置文件sudo nano /etc/netplan/01-netcfg.yaml根据你的网络环境添加类似这样的配置注意缩进格式network: version: 2 renderer: networkd ethernets: eth0: dhcp4: no addresses: [192.168.1.100/24] gateway4: 192.168.1.1 nameservers: addresses: [8.8.8.8, 8.8.4.4]保存后应用配置sudo netplan apply2. JDK安装与配置Tomcat运行需要Java环境支持这里我们选择安装OpenJDK 11。相比Oracle JDKOpenJDK的开源属性更适合我们的场景而且安装也更简单。执行以下命令安装sudo apt install openjdk-11-jdk -y安装完成后验证Java版本java -version如果看到类似OpenJDK 11.0.x的输出说明安装成功。接下来配置JAVA_HOME环境变量这个步骤很多新手容易忽略导致后面Tomcat启动失败。首先查找Java安装路径sudo update-alternatives --config java记下路径如/usr/lib/jvm/java-11-openjdk-amd64然后编辑环境变量sudo nano /etc/environment在文件末尾添加JAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64保存后使配置生效source /etc/environment验证JAVA_HOME是否设置正确echo $JAVA_HOME3. Tomcat服务器部署现在我们来安装Tomcat服务器。虽然Ubuntu软件源中有Tomcat包但我建议直接从Apache官网下载最新稳定版这样可以获得更好的控制权和更新支持。以Tomcat 9为例wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.68/bin/apache-tomcat-9.0.68.tar.gz下载完成后解压并移动到/opt目录tar -xzf apache-tomcat-9.0.68.tar.gz sudo mv apache-tomcat-9.0.68 /opt/tomcat设置目录权限sudo chown -R $USER:$USER /opt/tomcat sudo chmod -R 755 /opt/tomcat创建systemd服务文件以便管理Tomcat服务sudo nano /etc/systemd/system/tomcat.service添加以下内容[Unit] DescriptionApache Tomcat Web Application Container Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 EnvironmentCATALINA_PID/opt/tomcat/temp/tomcat.pid EnvironmentCATALINA_HOME/opt/tomcat EnvironmentCATALINA_BASE/opt/tomcat ExecStart/opt/tomcat/bin/startup.sh ExecStop/opt/tomcat/bin/shutdown.sh User$USER Group$USER RestartSec10 Restartalways [Install] WantedBymulti-user.target启用并启动Tomcat服务sudo systemctl daemon-reload sudo systemctl enable tomcat sudo systemctl start tomcat验证Tomcat是否正常运行sudo systemctl status tomcat如果看到active (running)状态说明Tomcat已经成功启动。此时可以在浏览器访问http://服务器IP:8080 看到Tomcat默认页面。4. OTA服务器专用配置现在我们需要为OTA升级功能配置Tomcat。首先创建OTA升级专用目录结构mkdir -p /opt/tomcat/webapps/OtaUpdater/WEB-INF/{classes,lib} mkdir -p /opt/tomcat/webapps/OtaUpdater/WEB-INF/packages创建manifest.xml配置文件nano /opt/tomcat/webapps/OtaUpdater/WEB-INF/manifest.xml添加以下内容根据你的RK3588设备型号调整?xml version1.0 encodingUTF-8? manifest product nameRK3588-DevBoard full_package_pathnull rkimage_pathnull version name1.0.0 package_pathpackages/RK3588-DevBoard/v1.0.0.zip / version name1.0.1 package_pathpackages/RK3588-DevBoard/v1.0.1.zip / /product /manifest这里有几个关键点需要注意product name必须与Android设备中的ro.product.model属性完全一致version name是版本号标识需要与固件编译时设置的版本号对应package_path是升级包在服务器上的相对路径配置Tomcat的server.xml以优化OTA服务性能nano /opt/tomcat/conf/server.xml找到Connector配置部分修改为Connector port8080 protocolHTTP/1.1 connectionTimeout20000 maxThreads200 minSpareThreads20 enableLookupsfalse acceptCount100 disableUploadTimeouttrue compressionon compressionMinSize2048 compressableMimeTypeapplication/zip/这些参数优化了Tomcat处理OTA升级请求的性能特别是针对大文件传输做了优化。5. 安全配置与权限管理OTA服务器需要特别注意安全性避免未授权访问。首先配置Tomcat用户权限nano /opt/tomcat/conf/tomcat-users.xml在标签内添加role rolenameotaadmin/ user usernameotauser passwordStrongPassword123 rolesotaadmin/然后配置web.xml启用BASIC认证nano /opt/tomcat/webapps/OtaUpdater/WEB-INF/web.xml添加以下内容security-constraint web-resource-collection web-resource-nameOTA Updater/web-resource-name url-pattern/*/url-pattern /web-resource-collection auth-constraint role-nameotaadmin/role-name /auth-constraint /security-constraint login-config auth-methodBASIC/auth-method realm-nameOTA Update Server/realm-name /login-config配置防火墙允许OTA端口sudo ufw allow 8080/tcp sudo ufw enable为了提高安全性建议定期轮换Tomcat管理密码并考虑配置SSL加密。可以使用Lets Encrypt免费证书sudo apt install certbot python3-certbot-nginx -y sudo certbot certonly --standalone -d yourdomain.com然后配置Tomcat使用SSLnano /opt/tomcat/conf/server.xml找到并取消注释SSL Connector部分修改为Connector port8443 protocolorg.apache.coyote.http11.Http11NioProtocol maxThreads150 SSLEnabledtrue SSLHostConfig Certificate certificateKeyFile/etc/letsencrypt/live/yourdomain.com/privkey.pem certificateFile/etc/letsencrypt/live/yourdomain.com/cert.pem certificateChainFile/etc/letsencrypt/live/yourdomain.com/chain.pem typeRSA / /SSLHostConfig /Connector6. OTA升级包管理与测试将编译好的OTA升级包上传到服务器指定目录。例如对于版本1.0.0mkdir -p /opt/tomcat/webapps/OtaUpdater/WEB-INF/packages/RK3588-DevBoard cp update.zip /opt/tomcat/webapps/OtaUpdater/WEB-INF/packages/RK3588-DevBoard/v1.0.0.zip确保文件权限正确chmod 644 /opt/tomcat/webapps/OtaUpdater/WEB-INF/packages/RK3588-DevBoard/*.zip重启Tomcat使配置生效sudo systemctl restart tomcat在RK3588设备端测试OTA升级功能。首先确保设备可以访问服务器地址然后执行adb shell am start -n com.android.updater/.MainActivity或者在设备设置中手动检查更新。如果一切配置正确设备应该能检测到新版本并提示升级。7. 常见问题排查在实际部署过程中可能会遇到各种问题。这里分享几个我踩过的坑和解决方法问题1Tomcat启动失败提示JAVA_HOME未设置解决方法确保/etc/environment中JAVA_HOME设置正确并且执行了source命令。有时候需要完全退出终端重新登录。问题2OTA包下载中断解决方法检查Tomcat的server.xml配置确保connectionTimeout和disableUploadTimeout设置正确。同时检查网络防火墙设置。问题3设备无法检测到更新解决方法确认manifest.xml中product name与设备ro.product.model完全一致检查服务器日志/opt/tomcat/logs/catalina.out使用curl测试服务器接口是否正常响应curl -I http://服务器IP:8080/OtaUpdater/WEB-INF/manifest.xml问题4升级包验证失败解决方法确认升级包签名证书与设备匹配检查升级包是否完整可以手动下载验证检查设备/system/etc/security/otacerts.zip中的证书对于更详细的日志分析可以查看设备logcat输出adb logcat | grep SystemUpdate8. 自动化部署与维护建议为了简化后续维护工作我建议将整个配置过程脚本化。创建一个部署脚本deploy_ota_server.sh#!/bin/bash # 自动部署OTA服务器脚本 # 安装依赖 sudo apt update sudo apt upgrade -y sudo apt install openjdk-11-jdk wget unzip -y # 配置Java环境 echo JAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 | sudo tee -a /etc/environment source /etc/environment # 下载安装Tomcat wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.68/bin/apache-tomcat-9.0.68.tar.gz tar -xzf apache-tomcat-9.0.68.tar.gz sudo mv apache-tomcat-9.0.68 /opt/tomcat sudo chown -R $USER:$USER /opt/tomcat sudo chmod -R 755 /opt/tomcat # 创建OTA目录结构 mkdir -p /opt/tomcat/webapps/OtaUpdater/WEB-INF/{classes,lib,packages} # 配置systemd服务 cat EOF | sudo tee /etc/systemd/system/tomcat.service [Unit] DescriptionApache Tomcat Web Application Container Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64 EnvironmentCATALINA_PID/opt/tomcat/temp/tomcat.pid EnvironmentCATALINA_HOME/opt/tomcat EnvironmentCATALINA_BASE/opt/tomcat ExecStart/opt/tomcat/bin/startup.sh ExecStop/opt/tomcat/bin/shutdown.sh User$USER Group$USER RestartSec10 Restartalways [Install] WantedBymulti-user.target EOF # 启用服务 sudo systemctl daemon-reload sudo systemctl enable tomcat sudo systemctl start tomcat echo OTA服务器部署完成访问地址http://$(hostname -I | awk {print $1}):8080对于日常维护建议定期备份/opt/tomcat/webapps/OtaUpdater目录设置日志轮转防止日志文件过大监控服务器资源使用情况保持Tomcat和Java环境更新到安全版本可以通过crontab设置自动备份任务# 每天凌晨3点备份OTA配置 0 3 * * * tar -czf /backup/ota_backup_$(date \%Y\%m\%d).tar.gz /opt/tomcat/webapps/OtaUpdater