适用于使用 zip 文件直接部署安装的 shell 管理脚本（Shell management scripts for direct deployment installations using zip files）

[poplar-at-twilight]

基于 systemd --user，适用于 PeerBanHelper 的管理脚本：
Based on systemd --user, the administrative scripts for PeerBanHelper are shown below:

• 另见 Systemd/User。
• See alse Systemd/User
• 原文：https://whiteboard-ui8.pages.dev/docs/qbittorrent-conf
• source: https://whiteboard-ui8.pages.dev/docs/qbittorrent-conf

当前的文件布局 - Current file layout

poplar@Greysia:~> tree ~/bin/pbh -L 1
/home/poplar/bin/pbh
├── data
├── key.txt
├── libraries
└── PeerBanHelper.jar

3 directories, 2 files

操作 - Procedures

将下载好的 PeerBanHelper*.zip 放置到 pbh 脚本设定的 $PBH_UP 文件夹中。
Place the downloaded PeerBanHelper*.zip in the $PBH_UP folder of the pbh script settings.

使用下文的 pbh 安装并启动服务，然后修改 ~/bin/pbh/data/config/config.yml：
Install and start the service using pbh below, then modify ~/bin/pbh/data/config/config.yml:

• server: 将 address 的值设置为 127.0.0.1
• server: set the value of address to 127.0.0.1

然后在 http://127.0.0.1:8080。生成 token 并添加 qBittorrent 下载器，并修改 ~/bin/pbh/data/config/config.yml：
Then at http://127.0.0.1:8080. Generate token and add qBittorrent downloader and modify ~/bin/pbh/data/config/config.yml:

• language：改为 zh_CN
• language: change to zh_CN.
• btn：改为 true，并填入 app-id 和 app-secret
• btn: change to true and put in app-id and app-secret.
  • 将 config-url 改为 https://btn-prod.ghostchu-services.top/ping/config
  • Change the config-url to https://btn-prod.ghostchu-services.top/ping/config
• proxy：将 setting: 0 改为 setting: 2，并检查服务器地址和端口是否正确。
• proxy: change setting: 0 to setting: 2 and check that the server address and port are correct.
• logger：将 hide-finish-log 改为 true
• logger: change hide-finish-log to true.

管理脚本 - Management Scripts

注意，解压文件时使用的外部命令是 7z，它由 ark 归档管理器依赖的 7zip 所提供。
Note that the external command used to decompress the file is 7z, which is provided by 7zip, which the ark archive manager depends on.

#!/bin/sh
# 本脚本用于 Peerbanhelper 的日常维护
# 注意，本脚本只适用于直接使用 PeerBanHelper_*.zip 文件进行部署的方式

export PBH_DIR=$HOME/bin/pbh
# PeerBanHelper 主目录
export PBH_UP=$HOME/Downloads
# PeerBanHelper 更新包文件路径
export BIN_DIR=$HOME/bin
# PeerBanHelper 的父级目录

SER_FILE=$HOME/.config/systemd/user/pbh.service

while true; do
    printf -- '-%0.s' {1..100} && echo
    printf 'You can use the PeerBanHelper maintenance script for:\n\n'
    printf '1 - Install PeerBanHelper\n'
    printf '2 - Activate systemd service\n'
    printf '3 - Stop systemd service\n'
    printf '4 - Delete systemd service\n\n'
    printf 'U - Upgrade PeerBanHelper\n'
    printf 'D - Degrade PeerBanHelper\n'
    printf 'F - Delete unused old files\n'
    printf 'L - Read logs of PeerBanHelper\n\n'
    printf 'C - Clear terminal output\n'
    printf 'Q - Quit\n\n'
    printf '==> '
    read answer

    if [ $answer = 1 ]; then
    # 安装 PeerBanHelper
        printf 'After installing the app, you need to manually edit the configuration file at: /data/config/config.yml \n'
        if [ -f $SER_FILE ]; then
        # 检查 systemd 服务文件是否存在
            printf 'INFO: Found the systemd service file.\n'
        else
            printf 'INFO: NO found the systemd service file.\n'
            mkdir -p ~/.config/systemd/user
            echo "[Unit]" > $SER_FILE
            echo "Description=Start PeerBanHelper Service" >> $SER_FILE
            echo >> $SER_FILE
            echo "[Service]" >> $SER_FILE
            echo "ExecStart=/usr/bin/java -jar -Xmx512M -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+ShrinkHeapInSteps PeerBanHelper.jar nogui" >> $SER_FILE
            echo "Type=simple" >> $SER_FILE
            echo "WorkingDirectory=$PBH_DIR" >> $SER_FILE
            echo >> $SER_FILE
            echo "[Install]" >> $SER_FILE
            echo "WantedBy=default.target" >> $SER_FILE
            printf 'INFO: Systemd service file created.\n'
        fi
        if [ -f $PBH_DIR/PeerBanHelper.jar ]; then
        # 检查主程序是否存在
            printf 'INFO: Main program found.\n'
            systemctl daemon-reload --user
            systemctl enable --user pbh
            systemctl status --user pbh | grep "Loaded"
        else
            if [ -f $PBH_UP/PeerBanHelper*.zip ]; then
                printf 'INFO: Found zip file to install.\n'
                cd $PBH_UP
                7z x PeerBanHelper*.zip
                mv $PBH_UP/PeerBanHelper $BIN_DIR
                mv $BIN_DIR/PeerBanHelper $BIN_DIR/pbh
                printf 'INFO: PeerBanHelper installed.\n'
                systemctl daemon-reload --user
                systemctl enable --user pbh
                systemctl status --user pbh | grep "Loaded"
            else
                printf 'ERROR: No found zip file to install!\n'
            fi
        fi

    elif [ $answer = 2 ]; then
    # 启动服务
        systemctl start --user pbh
        systemctl status --user pbh | grep "Active"

    elif [ $answer = 3 ]; then
    # 关闭服务
        systemctl stop --user pbh
        systemctl status --user pbh | grep "Active"
    
    elif [ $answer = 4 ]; then
    # 删除服务
        systemctl disable --user pbh --now
        systemctl status --user pbh | grep "Active"
        rm $SER_FILE
        systemctl daemon-reload --user
        printf 'INFO: systemd service deleted.\n'

    elif [ "$answer" = "U" ] || [ "$answer" = "u" ]; then
    # 更新 PeerBanHelper
        systemctl stop --user pbh
        systemctl status --user pbh | grep "Active"
        if [ -f $PBH_UP/PeerBanHelper*.zip ]; then
            printf 'INFO: Found zip file to upgrade.\n'
            cd $PBH_UP
            7z x PeerBanHelper*.zip
            rm -r $PBH_DIR/libraries
            printf 'INFO: Delete old libraries.\n'
            mv $PBH_UP/PeerBanHelper/libraries $PBH_DIR
            printf 'INFO: Update libraries.\n'
            mv -f $PBH_DIR/PeerBanHelper.jar $PBH_DIR/PeerBanHelper.jar.old
            printf 'INFO: Jar files back up.\n'
            mv $PBH_UP/PeerBanHelper/PeerBanHelper.jar $PBH_DIR
            printf 'INFO: Update jar files.\n'
            systemctl restart --user pbh
            systemctl status --user pbh | grep "Active"
            rm -r $PBH_UP/PeerBanHelper
            rm -r $PBH_UP/PeerBanHelper*.zip
            printf 'INFO: Deleted the update tarball.\n'
        else
            printf 'ERROR: PeerBanHelper*.zip not found!\n'
        fi

    elif [ "$answer" = "E" ] || [ "$answer" = "e" ]; then
    # 降级更新 Peerbanhelper
        if [ -f $PBH_DIR/PeerBanHelper.jar.old ]; then
            printf 'INFO: Found the backup files.\n'
            systemctl stop --user pbh
            systemctl status --user pbh | grep "Active"
            mv -f $PBH_DIR/PeerBanHelper.jar $PBH_DIR/PeerBanHelper.jar.error
            mv -f $PBH_DIR/PeerBanHelper.jar.old $PBH_DIR/PeerBanHelper.jar
            printf 'INFO: Downgrade completed.\n'
            systemctl restart --user pbh
            systemctl status --user pbh | grep "Active"
        else
            printf 'ERROR: PeerBanHelper.jar.old not found!\n'
        fi

    elif [ "$answer" = "F" ] || [ "$answer" = "f" ]; then
        printf 'INFO: Start deleting files...\n'
        if [ -d $PBH_DIR/data/logs ]; then
            rm $PBH_DIR/data/logs/*.gz
            printf 'Removed archive logs: OK!\n'
        else
            printf 'ERROR: No found log files.\n'
        fi
        if [ -f $PBH_DIR/PeerBanHelper.jar.error ]; then
            rm $PBH_DIR/PeerBanHelper.jar.error
            printf 'INFO: Removed PeerBanHelper.jar.error.\n'
        else
            printf 'ERROR: PeerBanHelper.jar.error not found!\n'
        fi

    elif [ "$answer" = "L" ] || [ "$answer" = "l" ]; then
    # 读取 Peerbanhelper 日志
        tail -n 30 $PBH_DIR/data/logs/latest.log
        # 读取最新的 30 条日志
        # 也可以使用：
        #journalctl --user -u pbh

    elif [ "$answer" = "C" ] || [ "$answer" = "c" ]; then
        clear

    elif [ "$answer" = "Q" ] || [ "$answer" = "q" ]; then
        exit

    else
        echo "ERROR: Invalid input!"
        continue

    fi
done

[TomoeMami]

本来想试试deb包，结果发现完全找不到data文件路径的说明。

[poplar-at-twilight]

本来想试试deb包，结果发现完全找不到data文件路径的说明。

你可以通过查看 deb 软件包内的文件确定 data 目录位置（-Dpbh.datadir=/etc/peerbanhelper）：

[poplar-at-twilight]

最近翻新了一下，感兴趣的可以拷贝到本地试试：

• https://whiteboard-ui8.pages.dev/docs/qbittorrent-conf#%E9%9B%86%E6%88%90%E7%AE%A1%E7%90%86%E8%84%9A%E6%9C%AC

#!/bin/bash
# 本脚本用于 Peerbanhelper 的日常维护
# 注意，本脚本只适用于直接使用 PeerBanHelper_*.zip 文件进行手动部署的方式

PBH_DIR=$HOME/bin/PeerBanHelper
# PeerBanHelper 主目录
ZIP_DIR=$HOME/Downloads
# PeerBanHelper 更新包文件路径
CACHE_TMP=/tmp/pbh_update
SER_FILE=$HOME/.config/systemd/user/pbh.service
# systemd 服务文件

start_pbh () {
    systemctl start --user pbh
    systemctl status --user pbh | grep "Loaded"
}

stop_pbh () {
    systemctl stop --user pbh
    systemctl status --user pbh | grep "Loaded"
}

enable_pbh () {
    systemctl daemon-reload --user
    systemctl enable --user pbh
    systemctl status --user pbh | grep "Loaded"
}

disable_pbh () {
    systemctl disable --user pbh --now
    systemctl status --user pbh | grep "Active"
    rm $SER_FILE
    systemctl daemon-reload --user
}

update_pbh () {
    mkdir -p $CACHE_TMP
    printf "WARNING:\nThis will delete the files in the $PBH_DIR folder, do you want to continue? (y/n) "
    read -r rm_duble_check
    rm_duble_check_caps="${rm_duble_check^^}"
    if [[ $rm_duble_check_caps = Y ]]; then
        if [[ -n "$(find "$ZIP_DIR" -maxdepth 1 -name "PeerBanHelper*.zip" -print -quit)" ]]; then
            printf "INFO: found_tarball_to_unzip\n"
            mkdir -p $PBH_DIR
            if [[ -d $PBH_DIR/data ]]; then
                printf "INFO: found_data_dir_to_backup\n"
                mv $PBH_DIR/data $CACHE_TMP
                printf "OK: backup_data_dir\n"
                rm -rf $PBH_DIR/*
                unzip $ZIP_DIR/PeerBanHelper*.zip -d $CACHE_TMP
                cp -r $CACHE_TMP/PeerBanHelper/* $PBH_DIR
                printf "OK: update_jar_and_libs\n"
                mv $CACHE_TMP/data $PBH_DIR
                printf "OK: restore_data_dir\n"
            else
                printf "INFO: no_found_data_dir_to_backup\n"
                unzip "$ZIP_DIR"/PeerBanHelper*.zip -d $CACHE_TMP
                rm -rf $PBH_DIR/*
                cp -r $CACHE_TMP/PeerBanHelper/* $PBH_DIR
                printf "OK: update_jar_and_libs\n"
            fi
            rm -rf $ZIP_DIR/PeerBanHelper*.zip
            printf "OK: delete_used_tarball\n"
        else
            printf "ERROR: no_found_tarball\n"
        fi
        enable_pbh
    else
        printf "ERROR: update_canceled\n"
    fi
    rm -r $CACHE_TMP
}

####

while true; do
    printf -- '-%0.s' {1..100} && echo
    printf 'You can use the PeerBanHelper maintenance script for:\n\n'
    printf '1 - Install PeerBanHelper\n'
    printf '2 - Start systemd service\n'
    printf '3 - Stop systemd service\n'
    printf '4 - Enable systemd service\n'
    printf '5 - Delete systemd service\n\n'
    printf 'U - Upgrade PeerBanHelper\n'
    printf 'L - Read logs of PeerBanHelper\n\n'
    printf 'C - Clear terminal output\n'
    printf 'Q - Quit\n\n'
    printf '==> '
    
    read answer
    answer_caps_1="${answer^^}"

    # 安装 PeerBanHelper
    if [[ $answer = 1 ]]; then
        # 注册 systemd 文件
        if [[ -f $SER_FILE ]]; then
            printf "INFO: found_systemd_ser_files\n"
        else
            printf "INFO: no_found_systemd_ser_files\n"
            mkdir -p ~/.config/systemd/user
            echo "[Unit]" > $SER_FILE
            echo "Description=Start PeerBanHelper Service" >> $SER_FILE
            echo >> $SER_FILE
            echo "[Service]" >> $SER_FILE
            echo "ExecStart=$(which java) -jar -Xmx512M -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+ShrinkHeapInSteps PeerBanHelper.jar nogui" >> $SER_FILE
            echo "Type=simple" >> $SER_FILE
            echo "WorkingDirectory=$PBH_DIR" >> $SER_FILE
            echo >> $SER_FILE
            echo "[Install]" >> $SER_FILE
            echo "WantedBy=default.target" >> $SER_FILE
            printf "OK: systemd_ser_files_created\n"
        fi
        # 解压 jar 和库
        if [[ -f $PBH_DIR/PeerBanHelper.jar ]] && [[ -d $PBH_DIR/libraries ]]; then
            printf "INFO: found_main_bin\n"
            enable_pbh
        else
            update_pbh
        fi

    elif [[ $answer = 2 ]]; then
        start_pbh
    elif [[ $answer = 3 ]]; then
        stop_pbh
    elif [[ $answer = 4 ]]; then
        enable_pbh
    elif [[ $answer = 5 ]]; then
        disable_pbh
        printf "OK: uninstall_systemd_ser\n"
    
    elif [[ $answer_caps_1 = U ]]; then
        stop_pbh
        update_pbh
        start_pbh

    elif [[ $answer_caps_1 = L ]]; then
    # 读取 Peerbanhelper 日志
        tail -n 30 $PBH_DIR/data/logs/latest.log
        # 读取最新的 30 条日志
        # 也可以使用：
        #journalctl --user -u pbh

    elif [[ $answer_caps_1 = C ]]; then
        clear

    elif [[ $answer_caps_1 = Q ]]; then
        exit

    else
        echo "ERROR: Invalid input!"
        continue

    fi
done