spaceinvaderone/vm_custom_icons

unraid_vm_icons Docker镜像文档

一、镜像概述和主要用途

unraid_vm_icons 是一个专为 Unraid 系统设计的 Docker 容器，用于为 Unraid VM Manager 下载和安装额外的自定义虚拟机 (VM) 图标。通过该容器，用户可方便地扩展 VM Manager 中的图标库，支持多种操作系统类型的图标分类管理，并提供灵活的图标同步控制选项。推荐通过 Unraid 社区应用插件进行安装。

二、核心功能和特性

1. 多类别自定义图标支持

• 提供多种操作系统类型的图标分类，包括：Windows、Linux、macOS、FreeBSD 系列（如 pfSense、FreeNAS 等）及“其他”操作系统。

2. 图标管理灵活性

• 支持保留或移除 Unraid 默认 VM 图标（推荐保留）。
• 可配置是否在容器启动时重新下载所有选定类别的图标，便于更新图标库或移除不再需要的图标类别。

3. 同步提示功能

• 若服务器配备蜂鸣器，可启用同步完成提示音（趣味性功能）。

4. 容器运行控制

• 支持设置同步完成后容器等待退出的时间，便于调试（默认 30 秒）。

三、使用场景和适用范围

适用场景

• Unraid 服务器用户希望自定义 VM Manager 中的虚拟机图标，以区分不同操作系统类型的虚拟机（如 Windows 和 Linux 虚拟机）。
• 需要定期更新自定义图标库或调整图标类别的场景。
• 对系统界面美化有需求的个人或家庭用户。

适用范围

• 运行 Unraid 系统的服务器。
• 已安装 Unraid 社区应用插件的环境。

四、使用方法和配置说明

4.1 安装方式

推荐通过 Unraid 社区应用插件安装：在 Unraid 界面中打开“应用”标签，搜索“unraid_vm_icons”，按提示完成安装。

4.2 基本配置（安装后模板设置）

1. 选择图标类别

从下拉菜单中选择需要安装的自定义图标类别，包括：

• Windows
• Linux
• macOS
• FreeBSD 系列（如 pfSense、FreeNAS 等）
• “其他”操作系统

2. 保留默认图标设置

• 是（推荐）：保留 Unraid 原生 VM 图标。
• 否：从 VM Manager 中移除 Unraid 默认图标。

3. 启动时重新下载图标

控制容器启动时是否重新下载所有选定类别的图标：

• 是：清除现有图标并重新下载所有选定类别；适用于更新图标库或移除不再需要的类别。
• 否（默认）：仅同步新增或变更的图标。

4. 启用同步提示音

若服务器配备蜂鸣器，可启用该选项，图标同步完成后将播放提示音（趣味性功能）。

4.3 高级配置（“显示更多设置”中）

1. 同步后退出延迟时间

设置容器在图标同步完成后等待退出的时间（默认 30 秒）。仅在需要通过命令行进入容器调试时调整，用于延长容器运行时间。

4.4 其他设置

除上述配置外，其他选项保持默认，不建议修改。

五、注意事项

1. 容器默认配置为“自动启动”，确保服务器或阵列启动时自动同步图标。
2. 若需调试，可通过高级配置延长容器运行时间，随后通过命令行工具进入容器。
3. 提示音功能依赖服务器硬件蜂鸣器支持，无蜂鸣器时该选项无效。
4. 重新下载图标（设置 3 选为“是”）会清除现有图标，适用于调整图标类别或强制更新。