Docker

Docker 是 PeerBanHelper（简称 PBH）推荐的部署方式。借助 PBH 提供的示例配置文件和命令行指令，PBH 能够随系统自动启动并在后台稳定运行（除非手动停止）。

使用 Docker Compose 部署

选择一个合适的位置，创建一个目录用于存放 PBH 的数据，并将工作目录切换至此位置。然后，将以下内容保存为 docker-compose.yml 文件：

version: "3.9"
services:
  peerbanhelper:
    image: "registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:latest"
    restart: unless-stopped
    container_name: "peerbanhelper"
    volumes:
      - ./:/app/data
    network_mode: host
    stop_grace_period: 30s

保存并退出编辑器，执行命令 sudo docker compose up -d --pull always 以启动服务。Web 界面将在 9898 端口开放。

版本升级

若需要升级版本，在创建的 docker-compose.yml 同目录下运行命令 sudo docker compose pull 更新镜像并重新运行 sudo docker compose up -d --pull always 即可更新。

推荐您同时部署 watchtower，只需运行的下面命令，它就可以自动更新容器而无需人工管理:

sudo docker run --detach --name watchtower --volume /var/run/docker.sock:/var/run/docker.sock --restart=unless-stopped nickfedor/watchtower

仍然建议您定期检查 PBH 版本发布页查看变更日志。

使用 Podman Quadlet

在 /etc/containers/systemd 中创建一个 peerbanhelper.container 文件，内容如下，根据需要更新 Volume 路径：

[Unit]
Description=PeerBanHelper Container
[Container]
ContainerName=peerbanhelper
Image=ghostchu/peerbanhelper:latest
Volume=<数据目录路径>:/app/data
PublishPort=9898:9898
Network=host
Environment=PUID=0
Environment=PGID=0
Environment=TZ=UTC
AutoUpdate=registry
[Install]
WantedBy=multi-user.target default.target

使用 sudo systemctl daemon-reload 重新加载 systemd，并通过 sudo systemctl enable --now peerbanhelper 命令启动容器并设置为开机自启。如果你使用的是 :latest，可以通过 sudo systemctl enable podman-auto-update.{service,timer} 启用自动更新。

使用 Docker Compose 部署​

版本升级​

使用 Podman Quadlet​

使用 Docker Compose 部署

版本升级

使用 Podman Quadlet