增加 硬件驱动映射说明

Signed-off-by: 萌森 <qyg2297248353@163.com>

apps/emby-lovechen/4.8.0.21/docker-compose.yml

@@ -16,6 +16,13 @@ services:
       - ${PANEL_APP_PORT_HTTP}:8096
     devices:
       - /dev/dri:/dev/dri
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     volumes:
       - /etc/timezone:/etc/timezone
       - /etc/localtime:/etc/localtime

apps/emby-lovechen/README.md

@@ -22,10 +22,32 @@ Emby原本是大部分源代码是开源的，带有部分闭源工具，但是
 
 ## 安装说明
 
-+ 开启 `投屏服务(DLNA)` 与 `网络唤醒服务(WOL)` 功能
+### 开启 `投屏服务(DLNA)` 与 `网络唤醒服务(WOL)` 功能
 
 开启后，可以在局域网内的设备上投屏观看视频。 需要选择主机网络(host)模式。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ## 特别版说明
 
 额外修改：

apps/emby/4.8.8.0/docker-compose.yml

@@ -16,6 +16,13 @@ services:
       - ${PANEL_APP_PORT_HTTP}:8096
     devices:
       - /dev/dri:/dev/dri
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     volumes:
       - /etc/timezone:/etc/timezone
       - /etc/localtime:/etc/localtime

apps/emby/README.md

@@ -18,10 +18,32 @@ Emby原本是大部分源代码是开源的，带有部分闭源工具，但是
 
 ## 安装说明
 
-+ 开启 `投屏服务(DLNA)` 与 `网络唤醒服务(WOL)` 功能
+### 开启 `投屏服务(DLNA)` 与 `网络唤醒服务(WOL)` 功能
 
 开启后，可以在局域网内的设备上投屏观看视频。 需要选择主机网络(host)模式。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ---
 
 ![Ms Studio](https://file.lifebus.top/imgs/ms_blank_001.png)

apps/gitea-runner/README.md

@@ -70,6 +70,10 @@ location / {
 
 ## 安装说明
 
+> ⚠️ 警告
+>
+> 该应用申请使用 `特权模式`， 将允许应用在容器内部执行特权操作，如挂载宿主机目录、访问宿主机设备等。
+
 这是Gitea Actions的Runner，用于在Gitea Actions中执行任务。
 
 ---

apps/immich-machine-learning/1.112.1/docker-compose.yml

@@ -17,6 +17,13 @@ services:
       - 1panel-network
     devices:
       - /dev/dri:/dev/dri
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     ports:
       - ${PANEL_APP_PORT_HTTP}:3003
     env_file:

apps/immich-machine-learning/README.md

@@ -31,6 +31,28 @@ Immich - 高性能自托管照片和视频备份解决方案
 
 Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ## 升级说明
 
 + **大版本** `v1.106.2`
@@ -42,7 +64,7 @@ Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
 3. 底层API发生了变化
     4. 移动端需要同步更新
 
-## 安装参数
+## 安装说明
 
 ### 机器学习 预加载模型(CLIP)
 

apps/immich-server/1.112.1/data.yml

@@ -43,13 +43,6 @@ additionalProperties:
       required: true
       rule: paramPort
       type: number
-    - default: "/dev/dri"
-      edit: true
-      envKey: IMMICH_DRIVE_PATH
-      labelZh: 硬件驱动路径
-      labelEn: Drive path
-      required: true
-      type: text
     - default: "Asia/Shanghai"
       edit: true
       envKey: TZ

apps/immich-server/1.112.1/docker-compose.yml

@@ -16,7 +16,14 @@ services:
     networks:
       - 1panel-network
     devices:
-      - ${IMMICH_DRIVE_PATH:-/dev/dri}:/dev/dri
+      - /dev/dri:/dev/dri
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     ports:
       - ${PANEL_APP_PORT_HTTP}:3001
     env_file:

apps/immich-server/README.md

@@ -31,6 +31,28 @@ Immich - 高性能自托管照片和视频备份解决方案
 
 Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ## 升级说明
 
 + **大版本** `v1.106.2`
@@ -42,7 +64,7 @@ Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
 3. 底层API发生了变化
     4. 移动端需要同步更新
 
-## 安装参数
+## 安装说明
 
 ### 机器学习 预加载模型(CLIP)
 

apps/immich/1.112.1/docker-compose.yml

@@ -41,6 +41,13 @@ services:
       - 1panel-network
     devices:
       - /dev/dri:/dev/dri
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     ports:
       - ${PANEL_APP_PORT_MACHINE_LEARNING}:3003
     env_file:
@@ -61,6 +68,13 @@ services:
       - 1panel-network
     devices:
       - /dev/dri:/dev/dri
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     ports:
       - ${PANEL_APP_PORT_HTTP}:3001
     env_file:

apps/immich/README.md

@@ -31,6 +31,28 @@ Immich - 高性能自托管照片和视频备份解决方案
 
 Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ## 升级说明
 
 + **大版本** `v1.106.2`
@@ -42,7 +64,7 @@ Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
 3. 底层API发生了变化
     4. 移动端需要同步更新
 
-## 安装参数
+## 安装说明
 
 ### 机器学习 预加载模型(CLIP)
 

apps/jellyfin/10.9.9/docker-compose.yml

@@ -26,7 +26,13 @@ services:
       - ${CUSTOM_MOUNT_DIRECTORY_3:-./default_mount_3}:${CUSTOM_MOUNT_DIRECTORY_3:-/default_mount_3}
     devices:
       - /dev/dri:/dev/dri
-      - /dev/kfd:/dev/kfd
+      # - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/video11:/dev/video11
     environment:
       - ROC_ENABLE_PRE_VEGA=1
       - HTTP_PROXY=${HTTP_PROXY:-}

apps/jellyfin/README.md

@@ -8,10 +8,32 @@
 
 ## 安装说明
 
-+ 开启 `投屏服务(DLNA)` 与 `网络唤醒服务(WOL)` 功能
+### 开启 `投屏服务(DLNA)` 与 `网络唤醒服务(WOL)` 功能
 
 开启后，可以在局域网内的设备上投屏观看视频。 需要选择主机网络(host)模式。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ## 中文字幕支持 (启用备用字体)
 
 请在设置中添加备用字体路径

apps/photoprism/240711/docker-compose.yml

@@ -23,13 +23,13 @@ services:
     working_dir: /photoprism
     devices:
       - /dev/dri:/dev/dri
-      - /dev/nvidia0:/dev/nvidia0
+      # - /dev/nvidia0:/dev/nvidia0
-      - /dev/nvidiactl:/dev/nvidiactl
+      # - /dev/nvidiactl:/dev/nvidiactl
-      - /dev/nvidia-modeset:/dev/nvidia-modeset
+      # - /dev/nvidia-modeset:/dev/nvidia-modeset
-      - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+      # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
-      - /dev/nvidia-uvm:/dev/nvidia-uvm
+      # - /dev/nvidia-uvm:/dev/nvidia-uvm
-      - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+      # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
-      - /dev/video11:/dev/video11
+      # - /dev/video11:/dev/video11
     env_file:
       - /etc/1panel/envs/global.env
       - /etc/1panel/envs/photoprism/photoprism.env

apps/photoprism/README.md

@@ -58,6 +58,28 @@ PhotoPrism® 是一款适用于去中心化网络的人工智能照片应用程
 
 那么任何人都将允许访问程序。
 
+### 硬件驱动挂载
+
+默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
+
+可以通过 `ls /dev/` 查看存在的设备驱动。
+
+```yml
+devices:
+  - /dev/dri:/dev/dri
+  # - /dev/nvidia0:/dev/nvidia0
+  # - /dev/nvidiactl:/dev/nvidiactl
+  # - /dev/nvidia-modeset:/dev/nvidia-modeset
+  # - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
+  # - /dev/nvidia-uvm:/dev/nvidia-uvm
+  # - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
+  # - /dev/video11:/dev/video11
+```
+
+如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
+
+格式请与 `- /dev/dri:/dev/dri` 保持一致。
+
 ### `视频编码器` 配置
 
 `PhotoPrism` 支持 `FFmpeg` 视频编码器，需要安装 `FFmpeg`。