TrueNAS 安装 Nginx Proxy Manager 教程

本文根据官方教程进行补充完善，希望对有需要的用户有用！

Nginx Proxy Manager Deploymenthttps://apps.truenas.com/resources/deploy-nginx-proxy-manager/

Nginx Proxy Manager Guidehttps://nginxproxymanager.com/guide/0 测试环境

• TrueNAS 应用目录版本 1.2.6
• Nginx Proxy Manager 应用程序版本 2.12.6 
• 良好的国际网络环境

1 前期准备

1.1 创建数据集

Nginx Proxy Manager 需要2个数据集，分别是：data 用于存储应用数据；certs 用于存储证书数据。如果要将 data、certs 二个数据集嵌套在名为 nginx-proxy-manager 的父数据集下，则需要在创建 nginx-proxy-manager  数据集时，将 数据集预设 设置为 通用 或 应用 。

1.2 找到 run as 用户ID和群组ID

注意：

Nginx Proxy Manager 的运行用户、群组以 run as 用户ID、群组ID为准，无论安装向导里面默认使用什么用户ID、群组ID，均需要进行修改。本文中的 run as 用户 ID为 0 ，群组ID为 0 。

2 安装过程

2.1 应用名称

根据需要修改，一般默认即可。

2.2 Nginx Proxy Manager 配置

根据需要配置时区、环境变量，一般默认即可。

2.3 用户和群组 配置

无论默认值是什么，均需要修改为 run as 的用户ID和群组ID，本文均为 0 。

2.4 网络配置

根据需要修改，一般默认即可。

2.5 存储配置

类型 选择 Host Path ，并选择 前面建立的 data 、cert 数据集。

注意：请务必核实前面建立的数据集的ACL权限，是否包括 run as 用户ID和群组ID的 完全控制 权限。若无，选择 启用ACL 并配置 ACL 条目。

2.6 标签配置

根据需要修改，一般默认即可。

2.7 资源配置

根据需要修改，一般默认即可。

最后，点击 安装 即可。

2.8 登录 Admin UI

默认管理账户如下。

Email:    admin@example.com
Password: changeme

3 常见问题

若存储 Nginx Proxy Manager 应用数据的数据集位于HDD硬盘，安装部署花费大量时间，但仍然无法安装部署成功的，有以下解决方案可供参考。

3.1 前期版本 2.10.0 - 2.12.3

从 2.10.0+ 版本开始，位于/etc/s6-overlay/s6-rc.d/prepare/30-ownership.sh文件更新，添加了如下代码，导致在HDD硬盘安装部署，会花费大量时间。

chown -R "$PUID:$PGID" /opt/certbot

解决方案是在安装部署前，添加 S6_STAGE2_HOOK 环境变量，跳过权限更改环节。

Name: S6_STAGE2_HOOK
Value: sed -i $d /etc/s6-overlay/s6-rc.d/prepare/30-ownership.sh

注意：2.12.4 为 BUG版本，请勿使用。

3.2 最新版本 2.12.5 +

从 2.12.5+ 版本开始，位于/etc/s6-overlay/s6-rc.d/prepare/30-ownership.sh文件更新，添加 SKIP_CERTBOT_OWNERSHIP 环境变量，用于跳过权限更改环节。

Name: SKIP_CERTBOT_OWNERSHIP
Value: true

注意：从 2.12.5+ 版本后，请勿使用 S6_STAGE2_HOOK 环境变量。如果正在使用前期版本，并计划更新至新版本，请务必先移除 S6_STAGE2_HOOK 环境变量后，再使用 SKIP_CERTBOT_OWNERSHIP 环境变量。