镜像标签与环境变量 PUID UMASK 怎么填
Docker 部署的核心决策就是选哪个标签、设哪些环境变量。
镜像标签怎么选
| 标签 | 内容 |
|---|---|
| latest | 稳定版，不确定就选它 |
| beta | 开发版，功能新但可能不稳 |
| 指定版本号（如 v3.41.0） | 锁版本，升级可控 |
| latest-aio / beta-aio | 一次带齐下面所有预装环境 |
| ffmpeg 后缀 | 预装 ffmpeg，用于本地存储视频缩略图 |
| aria2 后缀 | 预装 aria2，用于离线下载 |
写法是在任意标签后用短横线接后缀，比如稳定版加 aria2 就是「latest 减号 aria2」。
环境变量
| 变量 | 默认 | 作用 |
|---|---|---|
| PUID / PGID | 0 | 容器内进程运行身份，非 root 场景对齐宿主目录权限 |
| UMASK | 022 | 新建文件权限掩码，一般不动 |
| TZ | UTC | 想让日志时间对上本地就设成 Asia/Shanghai |
| RUN_ARIA2 | 视镜像 | 是否随容器起 aria2，含 aria2 的镜像默认开启 |
预装镜像的两个坑
- ffmpeg 缩略图不生效：确认用的是本机存储、前端切到网格视图、该存储的缩略图开关已打开、缩略图缓存目录配置正确（如 data/thumbnail）。
- aria2 报 unaligned 64-bit atomic operation：32 位 CPU 上无解，64 位设备换 64 位镜像。
离线下载的目录映射
打算用容器内 aria2 或 qBittorrent 做离线下载，记得把两个临时目录映射到宿主机：容器内 /opt/alist/data/temp/aria2 与 /opt/alist/data/temp/qBittorrent，两边指向同一宿主目录，详见离线下载。