Hub 安装

Beszel 支持通过 Docker/ Podman 或单个二进制文件进行安装。

提示

如果您是首次设置 Beszel，请查看 开始使用 指南。

Docker 或 Podman

所有方法都将在端口 8090 上启动 Beszel 服务，并挂载 ./beszel_data 目录用于持久存储。

docker-compose.yml

services:
  beszel:
    image: henrygd/beszel
    container_name: beszel
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data

docker run

mkdir -p ./beszel_data && \
docker run -d \
  --name beszel \
  --restart=unless-stopped \
  -v ./beszel_data:/beszel_data \
  -p 8090:8090 \
  henrygd/beszel

podman run

mkdir -p ./beszel_data && \
podman run -d \
  --name beszel \
  --restart=unless-stopped \
  -v ./beszel_data:/beszel_data \
  -p 8090:8090 \
  docker.io/henrygd/beszel

单击查看完整的 docker-compose.yml 配置，包括本地代理

重要

此配置通常可以直接使用，但在 Web 界面添加系统时需要执行以下步骤：

1. 使用您的公钥更新 KEY 值，然后再次运行 docker compose up -d 以重新启动代理

2. 将 host.docker.internal 用作 主机/IP。 请勿使用 localhost 或 127.0.0.1

docker-compose.yml

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    extra_hosts:
      - host.docker.internal:host-gateway
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data

  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      PORT: 45876
      # 请勿删除密钥周围的引号
      KEY: '使用“添加系统”对话框复制的公钥进行更新'

单击查看运行 docker compose 的说明

注意

如果您更喜欢以不同的方式设置容器，请随意

1. 如果尚未安装，请安装 Docker 和 Docker Compose.

2. 复制 docker-compose.yml 内容

3. 创建一个目录用于存储 docker-compose.yml 文件

mkdir beszel
cd beszel

4. 创建一个 docker-compose.yml 文件，粘贴内容并保存

nano

nano docker-compose.yml

vim

vim docker-compose.yml

emacs

emacs docker-compose.yml

vscode

code docker-compose.yml

5. 启动服务

docker compose up -d

二进制文件

安装二进制文件有多种方法。 请选择您喜欢的方式。

1. 快速脚本 (Linux)

此命令下载并运行我们的 install-hub.sh 脚本。该脚本将安装最新二进制文件并创建 systemd 服务，使其在重新启动后继续运行。

• -u : 卸载
• -p <port> : 指定端口号（默认: 8090）

curl -sL https://raw.githubusercontent.com/henrygd/beszel/main/supplemental/scripts/install-hub.sh -o install-hub.sh && chmod +x install-hub.sh && ./install-hub.sh

2. 手动下载和启动

点击展开/收起

下载

从 releases 下载匹配您服务器 CPU 架构的最新二进制文件，并手动运行它。您需要手动创建一个服务才能使其在重新启动后继续运行。

curl -sL "https://github.com/henrygd/beszel/releases/latest/download/beszel_$(uname -s)_$(uname -m | sed 's/x86_64/amd64/' | sed 's/armv7l/arm/' | sed 's/aarch64/arm64/').tar.gz" | tar -xz -O beszel | tee ./beszel >/dev/null && chmod +x beszel

启动中心

./beszel serve --http "0.0.0.0:8090"

更新中心

./beszel update

创建服务（可选）

如果您的系统使用 systemd，则可以创建一个服务来使中心在重新启动后继续运行。

1. 在 /etc/systemd/system/beszel.service 中创建一个服务文件。

[Unit]
Description=Beszel Hub
After=network.target

[Service]
Type=simple
Restart=always
RestartSec=3
User=root
WorkingDirectory={/path/to/working/directory}
ExecStart={/path/to/working/directory}/beszel serve --http "0.0.0.0:8090"

[Install]
WantedBy=multi-user.target

2. 启用并启动服务。

sudo systemctl daemon-reload
sudo systemctl enable beszel.service
sudo systemctl start beszel.service

3. 手动编译和启动

点击展开/收起

编译

请参阅 编译 了解有关如何自己编译中心的更多信息。

启动中心

./beszel serve --http "0.0.0.0:8090"

更新中心

./beszel update

创建服务（可选）

如果您的系统使用 systemd，则可以创建一个服务来使中心在重新启动后继续运行。

1. 在 /etc/systemd/system/beszel.service 中创建一个服务文件。

[Unit]
Description=Beszel Hub
After=network.target

[Service]
Type=simple
Restart=always
RestartSec=5
User=root
WorkingDirectory={/path/to/working/directory}
ExecStart={/path/to/working/directory}/beszel serve --http "0.0.0.0:8090"

[Install]
WantedBy=multi-user.target

2. 启用并启动服务。

sudo systemctl daemon-reload
sudo systemctl enable beszel.service
sudo systemctl start beszel.service