一、文档说明
本教程基于 apt-cacher-ng 轻量缓存代理实现，适配统信UOS V20桌面版，适用于跳板机可联网、内网桌面端无外网、所有机器同架构同系统版本的企业内网场景，可快速搭建轻量化、可缓存的私有化软件源服务，降低外网带宽占用、提升内网安装/更新软件效率。
二、前置合规与重要说明
正版授权要求
跳板机、所有内网UOS桌面端均需完成统信官方正版授权激活，严禁使用未授权、破解、盗版系统，确保软件使用合法合规，满足单位信创与版权管理要求。
开发者模式说明
本教程涉及终端
sudo
权限、修改系统配置文件，必须开启开发者模式方可执行。
开发者模式为单向不可逆操作，开启后系统安全校验、完整性状态将永久变更，无法通过关闭开关（实则没有什么关闭开关）恢复出厂可信状态；
请由单位管理员评估安全与业务需求，审慎决定是否开启；
未激活授权的设备无法开启开发者模式。
网络前提
跳板机：可访问互联网；
内网主机：可正常网络访问跳板机，无直连外网权限。
三、服务端（跳板机）部署步骤
3.1 安装依赖服务
打开终端，执行以下命令安装缓存代理工具：
sudo apt update
sudo apt install -y apt-cacher-ng
3.2 修改配置文件（支持HTTPS、内网访问限制）
开启HTTPS透传，兼容UOS HTTPS源
sudo sed -i 's/# PassThroughPattern: ./PassThroughPattern: ./' /etc/apt-cacher-ng/acng.conf
放行内网常用网段，提升安全性
sudo sed -i 's/# AllowedNetwork: 192.168.0.0/16/AllowedNetwork: 192.168.0.0/16 10.0.0.0/8 172.16.0.0/12/' /etc/apt-cacher-ng/acng.conf
3.3 启动并设置开机自启
sudo systemctl restart apt-cacher-ng
sudo systemctl enable apt-cacher-ng
3.4 验证服务端口
执行命令检查 3142端口 是否正常监听：
ss -tlnp | grep 3142
出现监听条目即为部署成功。
3.5 防火墙配置（可选，推荐）
仅允许内网设备访问代理端口，避免外网滥用：
sudo ufw allow from 192.168.0.0/16 to any port 3142
sudo ufw reload
四、客户端（内网UOS桌面）配置步骤
4.1 配置APT代理
每台内网主机仅需执行一次，创建APT代理配置文件：
sudo cat > /etc/apt/apt.conf.d/02proxy <
请将「跳板机IP」替换为实际内网IP。
4.2 测试私有化仓库
sudo apt update
无报错、正常刷新软件源，即配置完成。
五、日常维护
清理过期缓存包
跳板机定期执行，释放磁盘空间：
sudo apt-cacher-ng --expire
服务状态检查
sudo systemctl status apt-cacher-ng
批量部署建议
内网主机较多时，可通过脚本批量下发代理配置文件，统一管理。
六、风险与注意事项
本方案为缓存型私有化仓库，跳板机需联网才能下载新软件包；缓存命中后，可离线为内网提供服务；
开发者模式开启后，将降低系统安全防护等级，请勿随意安装未签名、不明来源软件包；
严禁在未取得正版授权的设备上部署使用，由此产生的版权风险由使用单位自行承担；
若需完全离线、全量镜像的私有化仓库，可在本方案验证可用后，切换为
apt-mirror+Nginx
完整版本地源。
七、免责声明
技术适用性免责
本教程提供的部署步骤、配置方法仅基于统信UOS V20当前版本特性编写，不保证适配所有UOS衍生版本、更新版本或第三方定制系统。因系统版本差异、环境配置不同导致部署失败、系统异常、数据丢失等问题，本教程编写方不承担直接责任。
合规性责任免责
本教程明确要求部署使用统信UOS正版授权，仅提供技术指导，不负责审核使用单位的授权资质、合规性。若使用单位使用未授权、盗版系统，或违反统信软件许可协议、相关法律法规，由此产生的法律纠纷、行政处罚、经济损失等，均由使用单位自行承担全部责任。
开发者模式风险免责
开发者模式为系统不可逆操作，本教程已明确提示其安全风险与不可逆性。使用单位因开启开发者模式导致的系统安全漏洞、数据泄露、设备故障等问题，本教程编写方不承担任何赔偿或法律责任，使用单位需自行评估风险并做好数据备份。
数据与设备安全免责
部署过程中涉及的网络配置、端口开放、代理服务搭建，使用单位需自行做好安全防护（如防火墙、访问控制、权限管理）。因网络配置不当、服务暴露至外网、未授权内网访问等操作导致的设备被入侵、数据篡改、业务中断等情况，本教程编写方不承担任何责任。
第三方软件免责
本教程使用的
apt-cacher-ng
为开源软件，其使用、维护、升级均遵循对应开源协议。本教程仅提供集成使用方法，不对第三方开源软件的功能缺陷、漏洞、更新负责，因第三方软件问题引发的系统问题，由使用单位自行排查处理。
责任范围限制
本教程仅提供技术指导，不提供任何明示或暗示的担保（包括但不限于适销性、特定用途适用性的担保）。在法律允许的最大范围内，本教程编写方对因使用本教程内容产生的任何直接、间接、偶然、必然的损害（包括但不限于数据丢失、业务中断、经济损失等），不承担任何赔偿或补偿责任。
官方服务建议与免责
本教程仅为社区级、轻量化技术参考方案，非统信官方标准部署方案。若单位具备相应条件，建议直接联系统信官方服务热线400-858-8488，由官方提供企业级私有化仓库部署、技术支持与售后保障。因自行参照本教程部署而未采用官方服务所产生的部署风险、兼容性问题、运维隐患等，由使用单位自行承担，教程编写方不承担相关责任。
