TrueNAS Scale 部署

TrueNAS Scale 24.10+(Electric Eel)起 SCALE-Apps 已从 k3s 切换到 Docker,云瞰通过 Custom App YAML 即可部署。仅 24.10+ 适用,旧版 k3s 路线请先升级 TrueNAS。

1. 适用机型 & 推荐变体

硬件	推荐变体	备注
Intel CPU + 核显	openvino	TrueNAS 内核默认带 i915 驱动
NVIDIA GPU(GTX/RTX)	cuda 或 trt	Apps → Settings → GPU 可看 host GPU 列表
纯 CPU	cpu	推理速度降一档但功能不变

TrueNAS Scale 24.10 起才支持 Docker

24.04 及之前是 k3s/Kubernetes,本文档的 Custom App YAML 走 Docker backend,仅 24.10+ 适用。升级前请按 iX-systems 官方迁移指南做备份。

2. 准备工作

1
升级 TrueNAS 到 24.10+
系统设置 → 更新 → 选 24.10-Electric-Eel train,等迁移完成
2
建 ZFS dataset
Datasets → 选个池 → 新建 yunkan-data dataset,路径形如 /mnt/pool0/apps/yunkan/data;后面 compose 把这里挂到 /app/data
3
查 GPU
Apps → Settings → GPU 看 host 上检测到的 iGPU / NVIDIA,确认要走的变体

3. 获取 compose 文件

TrueNAS 推荐用 Custom App YAML 部署(走 UI),也可直接 SSH 跑 docker compose。三种获取方式任选其一:

浏览器下载 compose.yml

TrueNAS Scale 24.10+ 专用 · openvino 变体 · 注意改 dataset 路径

compose.yml

或 SSH 用 wget(记得修改 dataset 路径):

bash

ssh root@<TrueNAS IP>
cd /mnt/pool0/apps/yunkan
wget https://yun-kan.com/compose/truenas.yml -O compose.yml
# ★ 文件里 /mnt/pool0/apps/yunkan/data 改成你的真实 dataset 路径 ★

Custom App YAML 方式(推荐)

TrueNAS UI → Apps → Discover Apps → 右上角 Custom App → App Name 填 yunkan → 在 Workloads/YAML 编辑器粘贴下面最小版(注意把 /mnt/pool0/apps/yunkan/data 换成你的 dataset 路径)。

yaml

name: yunkan

services:
  yunkan:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-openvino:latest
    container_name: yunkan
    restart: always
    network_mode: host
    devices:
      - /dev/dri:/dev/dri
    volumes:
      - /mnt/pool0/apps/yunkan/data:/app/data
      - /mnt/pool0/apps/yunkan/recordings:/app/data/recordings
      - /etc/machine-id:/etc/machine-id:ro
      - /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan
  updater:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-updater:latest
    container_name: yunkan-updater
    restart: always
    network_mode: none
    volumes:
      - /mnt/pool0/apps/yunkan/data:/app/data
      - /mnt/pool0/apps/yunkan/compose.yml:/app/compose.yml:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - COMPOSE_PROJECT_NAME=yunkan
      - STATE_FILE=/app/data/.upgrade-state
      - SKYVIEW_COMPOSE_FILE=/app/compose.yml
      - SKYVIEW_COMPOSE_SERVICE=yunkan

compose.yml (最小版,粘贴前替换 dataset 路径)

4. 启动云瞰

方式 A · Custom App:Apps UI 里点 Save → Install,等状态变 Running。

方式 B · SSH:

bash

cd /mnt/pool0/apps/yunkan
docker compose up -d
docker logs -f yunkan

启动后浏览器 http://<TrueNAS IP>:23406/(注意 TrueNAS UI 在 80/443,不冲突)进入 Setup 向导。

5. 端口和防火墙

TrueNAS Scale Web UI 占用 80/443,云瞰 23406 系列无冲突。Scale 默认无额外防火墙,SCALE-Apps 走 host network 直接绑端口。

6. 常见问题

升级 24.04 → 24.10 后 App 不在了

k3s → Docker 迁移可能让旧 Custom App 不见,需要按本文档重新部署(数据卷仍在 ZFS dataset 里,重建容器即可恢复)。

/dev/dri 在 TrueNAS Custom App YAML 里报错

确认 TrueNAS UI → Apps → Settings → GPU 已勾选 Allow Containers to Access。

升级:推荐通过 Apps UI 升级(Edit → 改 image tag → Save);或 SSH docker compose pull && docker compose up -d。