Unraid XML 生成器

核心模式

Unraid Docker 模板的关键要点：

  mycontainer
  image:tag
  bridge

  
  --entrypoint /bin/sh

  
  -ec 'real startup command here'

  
  default_value
  8080
  /mnt/user/appdata/mycontainer

模板字段参考

Config 类型

Config 显示选项

掩码变量（密钥）

对 Type="Variable" 类型的 条目设置 Mask="true" 可实现：

• 在 UI 中隐藏其值（显示为 ••••••）
• 将其标记为敏感信息（如 API Key、Token、密码等）

PostArgs Shell 模式

# 正确的 PostArgs XML 写法：
-ec 'export VAR1="value1" && export VAR2="value2" && exec real_command --flag arg'

# 各部分说明：
# -e  : 出错时退出
# -c  : 从字符串中读取命令（而非 stdin）
# '...' : 单引号包裹的命令字符串

建议包含的标准 Config 变量

适用于任意容器：

http://192.168.8.30:7893
http://192.168.8.30:7893
localhost,127.0.0.1,192.168.0.0/16
Asia/Shanghai

脚本使用方式

python3 scripts/generate_template.py 
  --name opencode 
  --image ghcr.io/anomalyco/opencode:latest 
  --port 4096 
  --web-port 4097 
  --output /tmp/opencode.xml

# 同时生成所有标准环境变量：
python3 scripts/generate_template.py 
  --name opencode 
  --image ghcr.io/anomalyco/opencode:latest 
  --port 4096 
  --web-port 4097 
  --proxy 192.168.8.30:7893 
  --tz Asia/Shanghai 
  --output /tmp/opencode.xml

常见陷阱

1. PostArgs 中的双引号 → 在 XML 中需转义为 "
2. 绕过 ENTRYPOINT → 必须始终使用 --entrypoint /bin/sh
3. Shell 变量替换 → PostArgs 应使用单引号包裹，防止 XML 解析器提前展开 $VAR
4. 模板文件名 → 必须以 my- 开头、以 .xml 结尾
5. 路径权限 → Unraid 默认以 PUID/PGID = 99/100 运行容器

输出路径

生成的 XML 文件将被放置在：

/boot/config/plugins/dockerMan/templates-user/my-.xml

用户必须确认后，方可将该文件部署（写入）到上述路径。