ugreen-icon-replacer 是一款专为绿联 NAS UGOS PRO 系统设计的开源美化脚本。它允许用户通过简单的命令行操作，快速将系统默认图标替换为多种高颜值主题，在提升视觉美感的同时，增强常用应用的识别度。
核心功能与技术优势
针对 UGOS PRO 默认图标风格单一的问题，该脚本提供了高度自动化的替换方案，无需用户手动匹配尺寸或逐个上传图片。
- 丰富的主题库 ：内置五套风格迥异的主题，涵盖从极简主义到拟物玻璃质感等多种审美倾向。
- 自动化部署 ：脚本可自动检测并安装
unzip依赖，完成从下载 ZIP 包到解压覆盖的全流程操作。 - 灵活的下载链路 ：原生支持 GitHub 主站，并集成 FastGit 镜像及自定义代理配置，有效解决国内网络环境下下载超时的问题。
- 高效的缓存机制 ：支持本地离线替换，一旦图标包下载完成，后续切换无需重复联网。
- 可靠的追踪机制 ：所有操作记录均保存在
/var/log/iconreplace*.log中，方便用户在出现异常时快速排查。
快速部署指南
方案一：一键安装（推荐）
适用于追求效率的用户，直接在终端执行以下命令：
sudo -i # 切换至 root 权限，确保具备写入权限
bash <(curl -s https://raw.githubusercontent.com/zeyu8023/ugreen-icon-replacer/main/replace_icons.sh)
方案二：手动克隆
适用于需要对脚本进行修改或在特定环境下部署的用户：
git clone https://github.com/zeyu8023/ugreen-icon-replacer.git
cd ugreen-icon-replacer && chmod +x replace_icons.sh
sudo ./replace_icons.sh
提示： 若 GitHub 连接缓慢，可将克隆地址替换为 FastGit 镜像：https://hub.fastgit.xyz/zeyu8023/ugreen-icon-replacer.git
主题风格对照表
运行脚本后，通过图形化菜单输入对应数字即可即时切换主题：
| 编号 | 主题名称 | 视觉特点 |
|---|---|---|
| 1 | iOS 26 液态玻璃 | 高光透亮，现代感强（乐小宇出品） |
| 2 | 锤子 OS | 纯净极简，视觉干扰低（Sunny 整理） |
| 3 | 拟物毛玻璃 | 冰感质感，立体度高（Sunny 制作） |
| 4 | 绿联毛玻璃 | 通透绿色调，契合品牌色（Sunny 制作） |
| 5 | 官方默认 | 快速还原系统初始状态 |
常见问题与注意事项
关于系统更新
由于固件升级会重置 /ugreen/static/icons 目录，升级后自定义图标会丢失。此时只需再次运行脚本即可快速恢复美化效果。
网络连接故障
若无法连接 GitHub，可通过以下两种方式解决：
- 配置代理 ：在脚本提示时输入
socks5h://127.0.0.1:1080或http://127.0.0.1:7890，配置将自动保存供下次使用。 - 替代方案 ：优先选用 FastGit 镜像或使用离线 ZIP 包进行替换。
扩展玩法
对于深度用户，可以将此脚本与 Kubespider、Strm 链接生成等社区工具配合使用。由于这些工具同样依赖 root 权限且目录结构相似，用户可以沿用相同的操作逻辑，构建一套完整的个性化 NAS 生态。
项目资源
正文完
