compose_install_qbittorrent
Docker Compose 部署 qBittorrent 下载工具
一键脚本
bash <(curl -sL gitee.com/meimolihan/linux-command_sh/raw/master/compose_install_qbittorrent.sh) 8081 /vol1/1000/compose/qbittorrent
| 传参方式 | 命令示例 | 说明 |
|---|---|---|
| 不传参(交互式) | 脚本.sh | 正常进入交互式流程 |
| 先目录,后端口 | 脚本.sh /vol1/1000/compose/qbittorrent 8081 | 同时传入目录和端口 |
| 先端口,后目录 | 脚本.sh 9090 /vol1/1000/compose/qbittorrent | 同时传入端口和目录 |
| 只传目录 | 脚本.sh /vol1/1000/compose/qbittorrent | 仅传入目录参数 |
| 只传端口 | 脚本.sh 8081 | 仅传入端口参数 |
项目简介
qBittorrent 是一个开源免费的 BitTorrent 客户端,提供简洁的界面和强大的功能,是替代 μTorrent 的优秀选择。通过 Docker 部署可以轻松管理并保持系统整洁。
- 🌐
qBittorrent官网地址:https://www.qbittorrent.org/ - 🐱
GitHub项目地址:https://github.com/linuxserver/docker-qbittorrent - 🐋
Docker镜像地址:https://hub.docker.com/r/linuxserver/qbittorrent
效果预览
补充说明
该脚本用于一键部署 qBittorrent BitTorrent 下载客户端,基于 Docker Compose 实现,适合在 NAS 或服务器上搭建远程 BT 下载服务。
功能特点
- 支持交互式和传参两种部署模式(可指定目录和端口)
- 自动检查并安装 Docker 和 Docker Compose 环境
- 智能端口管理:检查端口是否放行,自动开放并持久化 iptables 规则
- 清理旧容器:部署前自动清理 qbittorrent 容器和相关镜像
- 自动生成 docker-compose.yml 配置文件
- 使用 bridge 网络模式:容器独立网络栈
- Web 管理界面:通过浏览器远程管理下载任务
- 双端口映射:Web 端口 8081 和 BT 端口 6881(TCP+UDP)
- 配置持久化:./config 目录存储所有配置
- 下载目录独立:./downloads 存储下载文件
- 自定义 UID/GID/UMASK:保障文件权限一致性
- 时区设置:默认 Asia/Shanghai
- 部署后显示容器状态和访问地址
获取默认登录凭据
首次部署完成后,默认用户名和密码为自动生成,请执行以下命令查看:
docker logs qbittorrent | grep -i password
输出说明
脚本输出包含以下字段:
| 字段 | 说明 |
|---|---|
| 项目标题 | 显示部署的项目名称 |
| Docker 环境检查 | 检查并自动安装 Docker/Docker Compose |
| 部署目录 | 显示 Compose 文件存放路径(默认 /vol1/1000/compose/qbittorrent) |
| 映射端口 | 显示 Web 端口(默认 8081) |
| 端口状态 | 检查并开放防火墙端口 |
| 容器清理 | 显示旧容器(qbittorrent)和镜像的清理结果 |
| 配置文件 | 显示 docker-compose.yml 创建状态 |
| 容器启动 | 显示容器启动结果 |
| 容器状态 | 显示容器 ID、名称、状态、端口等信息 |
| 访问地址 | 显示 qBittorrent 的 HTTP 访问 URL |
注意事项
- 脚本需要 root 权限或 sudo 权限来安装依赖和配置防火墙
- 默认使用 lscr.io/linuxserver/qbittorrent:latest 镜像
- 部署目录默认为 /vol1/1000/compose/qbittorrent,可通过参数修改
- Web 端口默认为 8081(映射容器 8081 端口),BT 端口默认为 6881(TCP+UDP)
- 默认用户名
admin,密码为首次启动时自动生成,通过docker logs qbittorrent \| grep -i password查看 - 登录后可在 Web 界面设置中修改密码
- 配置目录(./config)存储所有 qBittorrent 配置,删除需谨慎
- 下载目录(./downloads)存储所有下载文件
- PUID/PGID 默认 1000,建议与文件所有者保持一致
- BT 端口 6881 需同时开放 TCP 和 UDP 协议
- 脚本会自动检测并开放防火墙端口(优先使用 iptables-save 保存规则,支持 netfilter-persistent 超时保护,避免卡死)
- 如需完全卸载,可使用文档末尾的一键卸载命令
脚本源码
#!/bin/bash
set -uo pipefail
# ====================== 【可自定义配置区】 ======================
DEFAULT_TITLE="qBittorrent 下载工具 一键部署"
DEFAULT_COMPOSE_DIR="/vol1/1000/compose/qbittorrent"
DEFAULT_PORT="8081"
DEFAULT_CONTAINER_NAME="qbittorrent"
# =================================================================
list_color_init() {
export gl_hui=$'\033[38;5;59m'
export gl_hong=$'\033[38;5;9m'
export gl_lv=$'\033[38;5;10m'
export gl_huang=$'\033[38;5;11m'
export gl_lan=$'\033[38;5;32m'
export gl_bai=$'\033[38;5;15m'
export gl_zi=$'\033[38;5;13m'
export gl_bufan=$'\033[38;5;14m'
export reset=$'\033[0m'
}
list_color_init
log_info() { echo -e "${gl_lan}[信息]${gl_bai} $*"; }
log_ok() { echo -e "${gl_lv}[成功]${gl_bai} $*"; }
log_warn() { echo -e "${gl_huang}[警告]${gl_bai} $*"; }
log_error() { echo -e "${gl_hong}[错误]${gl_bai} $*" >&2; }
break_end() {
echo -e "${gl_lv}操作完成${gl_bai}"
echo -e "${gl_bai}按任意键继续 ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai} \c"
read -r -n 1 -s -p ""
echo ""
clear
}
sleep_fractional() {
local seconds=$1
if sleep "$seconds" 2>/dev/null; then return 0; fi
if command -v perl >/dev/null 2>&1; then perl -e "select(undef, undef, undef, $seconds)"; return 0; fi
if command -v python3 >/dev/null 2>&1; then python3 -c "import time; time.sleep($seconds)"; return 0; fi
if command -v python >/dev/null 2>&1; then python -c "import time; time.sleep($seconds)"; return 0; fi
local int_seconds=$(echo "$seconds" | awk '{print int($1+0.999)}')
sleep "$int_seconds"
}
exit_script() {
echo ""
echo -ne "${gl_hong}感谢使用,再见! ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}\c"
sleep_fractional 0.5
echo -ne "${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}\c"
sleep_fractional 0.6
clear
exit 0
}
column_if_available() {
if command -v column &> /dev/null; then
column -t -s $'\t'
else
cat
fi
}
root_use() {
clear
if [ "$EUID" -ne 0 ]; then
echo -e "\n${gl_zi}>>> ROOT登录检查 ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
echo -e "${gl_huang}提示: ${gl_bai}该功能需要root用户才能运行!"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
break_end
return 1
fi
return 0
}
check_and_open_port() {
local PORT="$1"
if [[ -z "$PORT" ]]; then
log_error "未指定端口"
return 1
fi
log_info "检查端口 ${gl_huang}${PORT}${gl_bai} 是否放行"
local opened=false
if command -v firewall-cmd &>/dev/null && firewall-cmd --state &>/dev/null; then
if firewall-cmd --list-ports | grep -qw "${PORT}/tcp"; then
opened=true
fi
elif iptables -L INPUT -n 2>/dev/null | grep -qE "dpt:${PORT}.*ACCEPT"; then
opened=true
fi
if $opened; then
log_ok "端口 ${PORT} 已放行"
return 0
fi
log_warn "端口 ${gl_hong}${PORT}${gl_bai} 未放行,正在开放"
if command -v firewall-cmd &>/dev/null && firewall-cmd --state &>/dev/null; then
firewall-cmd --permanent --add-port=${PORT}/tcp >/dev/null 2>&1
firewall-cmd --permanent --add-port=${PORT}/udp >/dev/null 2>&1
firewall-cmd --reload >/dev/null 2>&1
log_ok "端口 ${PORT} 已通过 firewalld 开放"
else
iptables -I INPUT -p tcp --dport "${PORT}" -j ACCEPT 2>/dev/null
iptables -I INPUT -p udp --dport "${PORT}" -j ACCEPT 2>/dev/null
if command -v iptables-save >/dev/null 2>&1; then
if command -v netfilter-persistent >/dev/null 2>&1; then
netfilter-persistent save >/dev/null 2>&1
elif [ -d /etc/iptables ]; then
iptables-save > /etc/iptables/rules.v4
fi
fi
log_ok "端口 ${PORT} 已通过 iptables 开放"
fi
}
check_port_available() {
local PORT="$1"
if ss -tuln | grep -q ":${PORT} "; then
return 1
elif netstat -tuln 2>/dev/null | grep -q ":${PORT} "; then
return 1
else
return 0
fi
}
get_free_port() {
local start_port=$1
local port=$start_port
while ! check_port_available $port; do
port=$((port + 1))
if [ $port -gt $((start_port + 100)) ]; then
echo ""
return 1
fi
done
echo $port
}
docker-ps-cn() {
{
local filter_name="$1"
local docker_filter=""
[ -n "$filter_name" ] && docker_filter="--filter name=${filter_name}"
printf "%s%s\t%s\t%s\t%s\t%s\t%s%s\n" "$gl_hui" "容器ID" "名称" "状态" "端口" "创建时间" "镜像" "$reset"
printf "%s%s\t%s\t%s\t%s\t%s\t%s%s\n" "$gl_hui" "----------" "----------" "----------" "----------" "----------" "----------" "$reset"
docker ps ${docker_filter} --format "{{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}\t{{.RunningFor}}\t{{.Image}}" | \
awk -v green="$gl_lv" -v yellow="$gl_huang" -v cyan="$gl_bufan" -v blue="$gl_lan" -v white="$gl_bai" -v reset="$reset" -v gl_bai="$gl_bai" '
BEGIN {FS="\t"; OFS="\t"}
{
id = substr($1, 1, 12)
name = $2
status = $3
ports = $4
time = $5
image = $6
gsub(/ years? ago/, "年前", time)
gsub(/ months? ago/, "个月前", time)
gsub(/ weeks? ago/, "周前", time)
gsub(/ days? ago/, "天前", time)
gsub(/ hours? ago/, "小时前", time)
gsub(/ minutes? ago/, "分钟前", time)
gsub(/ seconds? ago/, "秒前", time)
gsub(/About /, "", time)
print cyan id reset, green name reset, yellow status reset, blue ports reset, white time reset, gl_bai image reset
}'
} | column_if_available
}
docker_check_env() {
if ! command -v docker &>/dev/null; then
log_info "Docker 未安装,开始自动安装 ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}"
bash <(curl -sL gitee.com/meimolihan/linux-command_sh/raw/master/linux_install_docker.sh)
if ! command -v docker &>/dev/null; then
log_error "Docker 安装失败!"
exit 1
fi
log_ok "Docker 安装成功"
fi
if ! command -v docker-compose &>/dev/null && ! docker compose version &>/dev/null; then
log_info "Docker Compose 未安装,开始自动安装 ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}"
bash <(curl -sL gitee.com/meimolihan/linux-command_sh/raw/master/linux_install_compose.sh)
if ! command -v docker-compose &>/dev/null && ! docker compose version &>/dev/null; then
log_error "Docker Compose 安装失败!"
exit 1
fi
log_ok "Docker Compose 安装成功"
fi
}
clean_old_container() {
local targets=("$@")
[ ${#targets[@]} -eq 0 ] && return
echo -e "\n${gl_huang}>>> 清理旧容器${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
for container_name in "${targets[@]}"; do
if docker ps -a --format "{{.Names}}" | grep -q "^${container_name}$"; then
log_info "删除容器: ${container_name}"
docker rm -f "${container_name}" >/dev/null 2>&1
fi
done
log_ok "清理完成"
}
wait_and_get_password() {
local container_name=$1
local port=$2
local max_wait=60
local waited=0
log_info "等待 Web 服务启动 (最多 ${max_wait} 秒) ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}"
while [ $waited -lt $max_wait ]; do
local status_code=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:${port} 2>/dev/null)
if [ "$status_code" = "200" ] || [ "$status_code" = "401" ] || [ "$status_code" = "403" ]; then
log_ok "Web 服务已就绪 (HTTP ${status_code})"
break
fi
sleep_fractional 1
waited=$((waited + 1))
echo -n "."
done
echo ""
local password=""
local logs=$(docker logs "$container_name" 2>&1)
password=$(echo "$logs" | grep -oP 'temporary password is provided for this session: \K[A-Za-z0-9]+' | head -1)
if [ -z "$password" ]; then
password=$(echo "$logs" | grep -oP 'Password: \K[A-Za-z0-9]+' | head -1)
fi
echo "$password"
}
deploy_app() {
local COMPOSE_DIR=""
local HOST_PORT=""
root_use || return 1
clear
echo -e "${gl_zi}>>> ${DEFAULT_TITLE}${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
docker_check_env
for arg in "$@"; do
if [[ "$arg" =~ ^[0-9]+$ ]]; then
HOST_PORT="$arg"
else
COMPOSE_DIR="$arg"
fi
done
if [ -z "${COMPOSE_DIR}" ]; then
read -r -e -p "${gl_bai}部署目录(回车默认:${gl_huang}${DEFAULT_COMPOSE_DIR}${gl_bai})(0退出): " input_dir
COMPOSE_DIR=${input_dir:-$DEFAULT_COMPOSE_DIR}
fi
if [ "$COMPOSE_DIR" = "0" ]; then
exit_script
return 1
fi
log_info "部署目录:${gl_huang}${COMPOSE_DIR}${gl_bai}"
mkdir -p "${COMPOSE_DIR}" || { log_error "目录创建失败"; break_end; return 1; }
cd "${COMPOSE_DIR}" || { log_error "目录切换失败"; break_end; return 1; }
if [ -z "${HOST_PORT}" ]; then
read -r -e -p "${gl_bai}Web端口(回车默认:${gl_huang}${DEFAULT_PORT}${gl_bai})(0退出): " input_port
HOST_PORT=${input_port:-$DEFAULT_PORT}
fi
if [ "$HOST_PORT" = "0" ]; then
exit_script
rm -rf "${COMPOSE_DIR}"
return 1
fi
log_info "Web端口:${gl_lv}${HOST_PORT}${gl_bai},BT端口:6881"
if ! check_port_available $HOST_PORT; then
log_warn "端口 ${gl_hong}${HOST_PORT}${gl_bai} 已被占用"
NEW_PORT=$(get_free_port $((HOST_PORT + 1)))
if [ -n "$NEW_PORT" ]; then
log_info "自动分配新端口:${gl_lv}${NEW_PORT}${gl_bai}"
HOST_PORT=$NEW_PORT
else
log_error "无法找到可用端口,请手动指定"
break_end
return 1
fi
fi
check_and_open_port "${HOST_PORT}"
check_and_open_port "6881"
clean_old_container "${DEFAULT_CONTAINER_NAME}"
echo -e "\n${gl_huang}>>> 生成配置文件${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
mkdir -p config downloads
chown -R 1000:1000 config downloads
cat > docker-compose.yml << EOF
services:
${DEFAULT_CONTAINER_NAME}:
container_name: ${DEFAULT_CONTAINER_NAME}
image: lscr.io/linuxserver/qbittorrent:latest
restart: unless-stopped
network_mode: bridge
ports:
- 6881:6881
- 6881:6881/udp
- ${HOST_PORT}:8081
volumes:
- ./config:/config
- ./downloads:/downloads
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
- UMASK_SET=022
- WEBUI_PORT=8081
EOF
log_ok "配置文件已创建"
echo -e "\n${gl_huang}>>> 启动容器${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
if docker-compose up -d 2>/dev/null || docker compose up -d 2>/dev/null; then
log_ok "容器启动成功"
else
log_error "容器启动失败"
break_end
return 1
fi
log_info "等待容器完全启动 (约 15 秒) ${gl_hong}.${gl_huang}.${gl_lv}.${gl_bai}"
sleep_fractional 15
local QB_PASSWORD=$(wait_and_get_password "${DEFAULT_CONTAINER_NAME}" "${HOST_PORT}")
echo -e "\n${gl_huang}>>> 容器状态${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
docker-ps-cn ${DEFAULT_CONTAINER_NAME}
LOCAL_IP=$(hostname -I | awk '{print $1}')
echo -e "\n${gl_zi}========================================${gl_bai}"
echo -e "${gl_lv}✅ 部署完成!${gl_bai}"
echo -e "${gl_zi}========================================${gl_bai}"
echo -e "${gl_bufan}📁 部署目录:${gl_huang}${COMPOSE_DIR}${gl_bai}"
echo -e "${gl_bufan}🌐 访问地址:${gl_lv}http://${LOCAL_IP}:${HOST_PORT}${gl_bai}"
echo -e "${gl_bufan}👤 用户名:${gl_lv}admin${gl_bai}"
if [ -n "$QB_PASSWORD" ]; then
echo -e "${gl_bufan}🔑 登录密码:${gl_lv}${QB_PASSWORD}${gl_bai}"
echo -e "${gl_huang}⚠️ 首次登录后会提示修改密码,请及时修改!${gl_bai}"
else
echo -e "${gl_huang}⚠️ 未能自动提取密码,请手动执行:${gl_bai}"
echo -e " ${gl_bufan}docker logs ${DEFAULT_CONTAINER_NAME} | grep -i password${gl_bai}"
echo -e "${gl_huang} 通常密码为随机字符串,或使用默认密码 adminadmin${gl_bai}"
fi
echo -e "${gl_zi}========================================${gl_bai}"
echo -e "${gl_bufan}💡 查看实时日志:docker logs -f ${DEFAULT_CONTAINER_NAME}${gl_bai}"
echo -e "${gl_bufan}💡 重启容器:docker restart ${DEFAULT_CONTAINER_NAME}${gl_bai}"
echo -e "${gl_bufan}💡 停止容器:docker stop ${DEFAULT_CONTAINER_NAME}${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
break_end
}
deploy_app "$@"
一键完全卸载命令
# 停止并删除容器 + 删除镜像 + 删除部署目录(按需修改)
docker rm -f qbittorrent && docker rmi -f lscr.io/linuxserver/qbittorrent:latest && rm -rf /vol1/1000/compose/qbittorrent
创建本地脚本
new_script="new_test.sh"
cat > "$new_script" << 'EOF'
#!/bin/bash
# 粘贴脚本源码
EOF
# 保留本地脚本,去掉 rm -f "$new_script"
chmod +x "$new_script" && ./"$new_script" && rm -f "$new_script"