TrueNAS 安装 Nginx Proxy Manager 教程
本文介绍了在TrueNAS上部署Nginx Proxy Manager的详细步骤。主要内容包括:创建data和certs两个数据集;设置runas用户ID和群组ID;配置应用名称、时区、网络和存储选项;强调必须确保数据集ACL权限正确。针对HDD硬盘安装耗时问题,提供了不同版本的解决方案:2.10.0-2.12.3版本需添加S6_STAGE2_HOOK环境变量,2.12.5+版本则使用SKIP_C
本文根据官方教程进行补充完善,希望对有需要的用户有用!
Nginx Proxy Manager Deployment
https://apps.truenas.com/resources/deploy-nginx-proxy-manager/
Nginx Proxy Manager Guide
https://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 环境变量。
火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。
更多推荐

所有评论(0)