Server
Nginx UI 配置的服务端部分涉及控制 Nginx UI 服务器的各种设置。在页面中,我们将讨论可用的选项、它们的默认值以及它们的目的。
Host
- 类型:
string - 版本:
>= v2.0.0-beta.37 - Default:
0.0.0.0
Nginx UI 服务器监听的主机名。此选项用于配置 Nginx UI 服务器监听传入 HTTP 请求的主机名。 更改默认主机名可能有助于提升安全性。
Port
- Type:
uint - 版本:
>= v2.0.0-beta.37 - 默认值:
9000
此选项用于配置 Nginx UI 服务器监听传入 HTTP 请求的端口。更改默认端口对于避免端口冲突或增强安全性可能很有用。
RunMode
- 类型:
string - 支持的值:
release,debug - 默认值:
debug
此选项用于配置 Nginx UI 服务器的运行模式,主要影响日志打印的级别。
Nginx UI 的日志分为 6 个级别,分别为 Debug、Info、Warn、Error、Panic 和 Fatal,这些日志级别按照严重程度递增,
当使用 debug 模式时,Nginx UI 将在控制台打印 SQL 及其执行的时间和调用者,Debug 级别或更高等级的日志也会被打印。
当使用 release 模式时,Nginx UI 将不会在控制台打印 SQL 的执行时间和调用者, 只有 Info 级别或更高等级的日志才会被打印。
EnableHTTPS
- 类型:
bool - 默认值:
false
此选项用于启用 Nginx UI 服务器的 HTTPS 支持。启用后,服务器将同时监听 HTTPS 和 HTTP 请求。
EnableH2
- 类型:
bool - 默认值:
false
此选项用于启用 Nginx UI 服务器的 HTTP/2 支持。
警告
HTTP/2 需要启用 HTTPS。如果在未启用 HTTPS 的情况下启用 HTTP/2,服务器将在启动时返回错误。
EnableH3
- 类型:
bool - 默认值:
false
此选项用于启用 Nginx UI 服务器的 HTTP/3 支持。
警告
HTTP/3 需要启用 HTTPS。如果在未启用 HTTPS 的情况下启用 HTTP/3,服务器将在启动时返回错误。
HttpHost
- 类型:
string - Default:
0.0.0.0
警告
已在 v2.0.0-beta.37 中废弃,请使用 Host 替代。
Nginx UI 服务器监听的主机名。此选项用于配置 Nginx UI 服务器监听传入 HTTP 请求的主机名。 更改默认主机名可能有助于提升安全性。
HttpPort
- Type:
int - 默认值:
9000
警告
已在 v2.0.0-beta.37 中废弃,请使用 Port 替代。
此选项用于配置 Nginx UI 服务器监听传入 HTTP 请求的端口。更改默认端口对于避免端口冲突或增强安全性可能很有用。
JwtSecret
- 类型:
string
警告
已在 v2.0.0-beta.37 中废弃,请使用 App.JwtSecret 替代。
此选项用于配置 Nginx UI 服务器用于生成 JWT 的密钥。
JWT 是一种用于验证用户身份的标准,它可以在用户登录后生成一个 token,然后在后续的请求中使用该 token 来验证用户身份。
如果您使用一键安装脚本来部署 Nginx UI,脚本将会生成一个 UUID 值并将它设置为此选项的值。
NodeSecret
- 类型:
string - 版本:
>= v2.0.0-beta.24, <= 2.0.0-beta.36
警告
已在 v2.0.0-beta.37 中废弃,请使用 Node.Secret 替代。
此密钥用于验证 Nginx UI 服务器之间的通信。 此外,您可以使用此密钥在不使用密码的情况下访问 Nginx UI API。
HTTPChallengePort
- 类型:
int - 默认值:
9180
警告
已在 v2.0.0-beta.37 中废弃,请使用 Cert.HTTPChallengePort 替代。
在获取 Let's Encrypt 证书时,此选项用于在 HTTP01 挑战模式中设置后端监听端口。HTTP01 挑战是 Let's Encrypt 用于验证您控制请求证书的域的域验证方法。
Email
- 类型:
string
警告
已在 v2.0.0-beta.37 中废弃,请使用 Cert.Email 替代。
在获取 Let's Encrypt 证书时,此选项用于设置您的电子邮件地址。Let's Encrypt 会将您的电子邮件地址用于通知您证书的到期时间。
Database
- 类型:
string - 默认值:
database
警告
已在 v2.0.0-beta.37 中废弃,请使用 Database.Name 替代。
此选项用于设置 Nginx UI 用于存储其数据的 sqlite 数据库的名称。
StartCmd
- 类型:
string - 默认值:
login
警告
已在 v2.0.0-beta.37 中废弃,请使用 Terminal.StartCmd 替代。
此选项用于设置 Web 终端的启动命令。
警告
出于安全原因,我们将启动命令设置为 login,因此您必须通过 Linux 的默认身份验证方法登录。如果您不想每次访问 Web 终端时都输入用户名和密码进行验证,请将其设置为 bash 或 zsh(如果已安装)。
PageSize
- 类型:
int - 默认值:
10
警告
已在 v2.0.0-beta.37 中废弃,请使用 App.PageSize 替代。
此选项用于设置 Nginx UI 中列表分页的页面大小。调整页面大小有助于更有效地管理大量数据,但是过大的数量可能会增加服务器的压力。
CADir
- 类型:
string
警告
已在 v2.0.0-beta.37 中废弃,请使用 Cert.CADir 替代。
在申请 Let's Encrypt 证书时,我们使用 Let's Encrypt 的默认 CA 地址。如果您需要调试或从其他提供商获取证书,您可以将 CADir 设置为他们的地址。
提示
请注意,CADir 提供的地址需要符合 RFC 8555 标准。
GithubProxy
- 类型:
string - 建议:
https://cloud.nginxui.com/
警告
已在 v2.0.0-beta.37 中废弃,请使用 Http.GithubProxy 替代。
对于可能在从 Github 下载资源时遇到困难的用户(如在中国大陆),此选项允许他们为 github.com 设置代理,以提高可访问性。
CertRenewalInterval
- 版本:
>= v2.0.0-beta.22, <= 2.0.0-beta.36 - 类型:
int - 默认值:
7
警告
已在 v2.0.0-beta.37 中废弃,请使用 Cert.CertRenewalInterval 替代。
此选项用于设置 Let's Encrypt 证书的自动续签间隔。默认情况下,Nginx UI 每隔 7 天会自动续签证书。
RecursiveNameservers
- 版本:
>= v2.0.0-beta.22, <= 2.0.0-beta.36 - 类型:
[]string - 示例:
8.8.8.8:53,1.1.1.1:53
警告
已在 v2.0.0-beta.37 中废弃,请使用 Cert.RecursiveNameservers 替代。
此选项用于设置 Nginx UI 在申请证书的 DNS 挑战步骤所使用的递归域名服务器。在不配置此项目的情况下,Nginx UI 使用操作系统的域名服务器设置。
SkipInstallation
- 版本:
>= v2.0.0-beta.23, <= 2.0.0-beta.36 - 类型:
bool - 默认值:
false
警告
已在 v2.0.0-beta.37 中废弃,请使用 Node.SkipInstallation 替代。
通过将此选项设置为 true,您可以跳过 Nginx UI 服务器的安装。 当您希望使用相同的配置文件或环境变量将 Nginx UI 部署到多个服务器时,这非常有用。
默认情况下,如果您启用了跳过安装模式,而没有在服务器部分设置 JWTSecret 和 NodeSecret 选项, Nginx UI 将为这两个选项生成一个随机的 UUID 值。
此外,如果您也没有在服务器部分设置 Email 选项, Nginx UI 将不会创建系统初始的 acme 用户,这意味着您无法在此服务器上申请 SSL 证书。
Name
- 版本:
>= v2.0.0-beta.23, <= 2.0.0-beta.36 - 类型:
string
警告
已在 v2.0.0-beta.37 中废弃,请使用 Http.InsecureSkipVerify 替代。
使用此选项自定义本地服务器的名称,以在环境指示器中显示。
InsecureSkipVerify
- 版本:
>= v2.0.0-beta.30, <= 2.0.0-beta.36 - 类型:
bool
警告
已在 v2.0.0-beta.37 中废弃,请使用 Http.InsecureSkipVerify 替代。
此选项用于配置 Nginx UI 服务器在与其他服务器建立 TLS 连接时是否跳过证书验证。