Skip to content

环境变量

列表值应以逗号分隔且不带空格。例如:SENSORS=sensor_1,sensor_2

中心 (Hub)

环境变量可以选择性地以 BESZEL_HUB_ 作为前缀。

名称默认值描述
APP_URL未设置Web 界面的 URL。如果 从子路径提供服务,则必须设置。
CSP未设置添加具有此值的 Content-Security-Policy 头。
DISABLE_PASSWORD_AUTHfalse禁用密码认证。
SHARE_ALL_SYSTEMSfalse允许所有用户访问所有系统。
USER_CREATIONfalse启用 OAuth2 / OIDC 的自动用户创建。

DISABLE_PASSWORD_AUTH

这不会完全禁用身份验证。如果您想使用 OAuth 代替密码登录,它会禁用密码登录。

SHARE_ALL_SYSTEMS

如果为 true,所有用户都可以看到系统。除非用户被分配了 readonly 角色,否则他们还可以编辑或删除任何系统。

代理 (Agent)

环境变量可以选择性地以 BESZEL_AGENT_ 作为前缀。

名称默认值描述
DOCKER_HOST未设置如果使用代理,则覆盖 Docker 主机 (docker.sock)。
EXTRA_FILESYSTEMS未设置如果使用二进制文件,则监控额外的磁盘。请参阅 其他磁盘
FILESYSTEM未设置用于根磁盘统计的设备、分区或挂载点。
KEY未设置用于身份验证的公共 SSH 密钥(可多个)。在中心提供。
KEY_FILE未设置从文件中读取公钥(可多个),而不是从环境变量中读取。
LISTEN45876监听的端口或主机:端口。
LOG_LEVELinfo日志级别。有效值: "debug", "info", "warn", "error"。
MEM_CALC未设置覆盖默认内存计算。
NETWORK未设置监听器的网络类型。"tcp"、"tcp4"、"tcp6" 或 "unix"。
NICS未设置用于监控带宽的网络接口白名单。
PRIMARY_SENSOR未设置在"所有系统"表格中显示的特定温度传感器。
SENSORS未设置用于监控的温度传感器白名单。
SYS_SENSORS未设置覆盖用于传感器的系统路径。请参阅 #160

LISTEN

主机必须是一个字面量 IP 地址或 Unix 套接字的完整路径。如果是 IPv6 地址,则必须用方括号括起来,例如 [2001:db8::1]:45876

KEY / KEY_FILE

可以提供多个密钥,只需用换行符分隔。您也可以通过以 # 开头的行添加注释。

DOCKER_HOST

Beszel 只需要访问读取容器信息权限。对于 linuxserver/docker-socket-proxy 您将设置 CONTAINERS=1

NETWORK

默认值取决于地址值。如果地址以 / 开头,则视为 Unix 套接字。否则,使用 tcp

MEM_CALC

已用内存的默认值基于 gopsutil 的 Used 计算,该计算应该与 free 非常接近。将 MEM_CALC 设置为 htop 以使其与 htop 的计算保持一致。

PRIMARY_SENSOR

如果未定义特定传感器,则将使用最高温度。

SENSORS

设置为空字符串(SENSORS="")以禁用温度监控。

已弃用

这些变量已被弃用,但为了向后兼容性仍会保留。

名称默认值描述
PORT45876已重命名为 LISTEN

设置环境变量

Docker

对于 Docker Compose,请在 docker-compose.yml 中使用 environmentenv_file 属性(说明)。

对于 docker run,请使用 -e--env--env-file 标志(说明)。

二进制文件

如果直接执行二进制文件,请将环境变量作为命令行参数包含。例如:MEM_CALC=htop ./beszel-agent

如果使用 Systemd,服务配置文件通常位于 /etc/systemd/system/beszel-agent.service。在 [Service] 部分中直接编辑环境变量,使用 Environment="KEY=VALUE",或使用 EnvironmentFile=PATH 定义的环境文件。

或者,您可以使用 systemctl edit beszelsystemctl edit beszel-agent 创建一个覆盖文件来修改配置(说明)。

编辑服务后,重新加载配置并重启:

bash
sudo systemctl daemon-reload
sudo systemctl restart beszel-agent # 对于 hub 使用 beszel

基于 MIT 许可发布