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

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 环境变量。

Logo

火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。

更多推荐