Termux + 宝塔面板 + Docker 终极部署指南

Chris_12192026-01-08 10:16

🤖 Assistant

今天分享一个超实用的技术方案------在安卓手机上通过Termux部署完整的Linux服务器环境。很多开发者想在移动端搭建轻量级服务器，但往往被复杂的配置和兼容性问题困扰。本文将提供一套经过全面优化的一键部署脚本，帮你彻底解决这些痛点。

一、技术背景与环境准备

1.1 为什么选择这个方案

在安卓设备上部署Linux服务器环境，核心挑战在于Android的沙箱机制限制了传统Linux服务的运行。Termux作为安卓端最强大的Linux终端模拟器，通过Proot技术实现了无需Root的Linux容器访问。但即便如此，在Termux中运行Docker和宝塔面板仍面临诸多技术难题。

传统方案失败的根本原因在于：Proot容器缺乏完整的systemd支持，导致Docker守护进程无法正常管理，许多依赖系统服务的安装脚本也会中途报错。这些问题对新手而言极具挑战性，因此我开发了这套全自动容错部署脚本。

1.2 环境要求

在开始之前，请确保你的环境满足以下条件：

  • 操作系统：Android 9.0 至 14.0
  • 存储空间：至少预留 5GB 可用空间
  • 网络环境：稳定的互联网连接（建议WiFi环境）
  • 应用来源：必须使用F-Droid官方版本的Termux

⚠️ 重要提示：Google Play版本的Termux存在签名兼容性问题，可能导致脚本运行异常。建议从F-Droid官网（https://f-droid.org/packages/com.termux/）下载最新官方版本。

二、核心优化脚本

以下是经过全面优化的一键部署脚本，集成了所有关键修复逻辑。脚本设计遵循零手动干预、异常自动修复的原则，即使是Linux新手也能轻松上手。

2.1 完整部署脚本

复制代码 
#!/bin/bash
#=========================================================
# Termux + Ubuntu容器 + Docker + 宝塔面板 终极部署脚本
# 适用系统：Android 9-14 (Termux/F-Droid版本)
# 作者：Chris
# 功能：全自动部署，无需手动操作，异常自动修复
#=========================================================

# 定义颜色输出
RED='\033[31m'
GREEN='\033[32m'
YELLOW='\033[33m'
BLUE='\033[34m'
NC='\033[0m'

# 日志函数
log_info() {
    echo -e "${GREEN}[INFO]${NC} $1"
}

log_warn() {
    echo -e "${YELLOW}[WARN]${NC} $1"
}

log_error() {
    echo -e "${RED}[ERROR]${NC} $1"
}

log_success() {
    echo -e "${GREEN}[SUCCESS]${NC} $1"
}

# 带重试的命令执行函数
retry_command() {
    local cmd="$1"
    local desc="$2"
    local max_retry=3
    local attempt=0
  
    while [ $attempt -lt $max_retry ]; do
        log_info "执行：${desc} (尝试 $((attempt + 1))/${max_retry})"
        if eval "$cmd" 2>&1; then
            log_success "${desc} 执行成功"
            return 0
        else
            attempt=$((attempt + 1))
            log_warn "${desc} 执行失败，5秒后重试..."
            sleep 5
        fi
    done
  
    log_error "${desc} 重试${max_retry}次均失败"
    return 1
}

# 修复函数
fix_issue() {
    local issue_type="$1"
  
    case "$issue_type" in
        "termux_update")
            log_warn "执行修复：切换Termux清华源并重新更新"
            sed -i 's|deb.*stable main$|deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main|' "$PREFIX/etc/apt/sources.list" 2>/dev/null || true
            pkg update -y && pkg upgrade -y
            ;;
        "ubuntu_install")
            log_warn "执行修复：清理残留容器后重新安装"
            proot-distro remove ubuntu -y 2>/dev/null || true
            proot-distro install ubuntu
            ;;
        *)
            log_error "未知的修复类型：${issue_type}"
            return 1
            ;;
    esac
}

#=========================================================
# 主程序开始
#=========================================================

log_info "========================================"
log_info " Termux 宝塔+Docker 一键部署脚本"
log_info "========================================"

# 环境检测
log_info "检测Termux环境..."
if [ ! -d "/data/data/com.termux/files/usr" ] || [ -z "$TERMUX_VERSION" ]; then
    log_error "检测失败：此脚本仅支持在Termux终端中运行！"
    log_info "请访问 https://f-droid.org/packages/com.termux/ 下载官方Termux"
    exit 1
fi
log_success "Termux环境检测通过"

# 检查必要命令
check_command() {
    local cmd="$1"
    if ! command -v "$cmd" &> /dev/null; then
        log_warn "缺少命令：${cmd}，自动安装中..."
        yes | pkg install "$cmd" -y
        if [ $? -ne 0 ]; then
            log_error "安装 ${cmd} 失败，请手动检查网络"
            exit 1
        fi
    fi
}

log_info "检查核心依赖..."
check_command "proot-distro"
check_command "wget"
check_command "curl"
log_success "核心依赖检查完成"

# 设置非交互模式
export DEBIAN_FRONTEND=noninteractive

# Step 1: 更新Termux并更换清华源
log_info "Step 1/7：更新Termux系统环境..."
retry_command "yes | pkg update -y && yes | pkg upgrade -y" "更新Termux环境"

log_info "更换Termux为清华源..."
if [ -f "$PREFIX/etc/apt/sources.list" ]; then
    sed -i 's|deb.*termux.net|deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main|' "$PREFIX/etc/apt/sources.list"
    sed -i 's|deb.*bagsha.com|deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main|' "$PREFIX/etc/apt/sources.list"
fi
log_success "Termux源更换完成"

# 安装基础软件包
log_info "安装基础软件包..."
yes | pkg install proot-distro wget curl git nano -y > /dev/null 2>&1
log_success "基础软件包安装完成"

# Step 2: 安装Ubuntu容器
log_info "Step 2/7：安装Ubuntu容器..."
if [ ! -d "/data/data/com.termux/files/home/proot-distro/ubuntu" ]; then
    if ! retry_command "proot-distro install ubuntu 2>&1 | tee /dev/stderr" "安装Ubuntu容器"; then
        fix_issue "ubuntu_install"
    fi
else
    log_info "Ubuntu容器已存在，跳过安装"
fi
log_success "Ubuntu容器准备完成"

# Step 3: 配置Ubuntu容器环境
log_info "Step 3/7：配置Ubuntu容器环境..."

# 构建容器内部署脚本
cat > /tmp/ubuntu_setup.sh << 'UBUNTU_SCRIPT'
#!/bin/bash
# Ubuntu容器内部配置脚本

RED='\033[31m'
GREEN='\033[32m'
YELLOW='\033[33m'
NC='\033[0m'

log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }

export DEBIAN_FRONTEND=noninteractive

# 容器内重试函数
container_retry() {
    local cmd="$1"
    local desc="$2"
    local max_retry=3
    local attempt=0
  
    while [ $attempt -lt $max_retry ]; do
        log_info "容器内：${desc} (尝试 $((attempt + 1))/${max_retry})"
        if eval "$cmd" 2>&1; then
            log_success "容器内：${desc} 成功"
            return 0
        else
            attempt=$((attempt + 1))
            log_warn "容器内：${desc} 失败，5秒后重试..."
            sleep 5
        fi
    done
    log_error "容器内：${desc} 重试失败"
    return 1
}

log_info "========================================"
log_info " Ubuntu容器环境配置"
log_info "========================================"

# 更换阿里云源
log_info "更换Ubuntu软件源为阿里云..."
sed -i 's|archieve.ubuntu.com|mirrors.aliyun.com|g' /etc/apt/sources.list
sed -i 's|security.ubuntu.com|mirrors.aliyun.com|g' /etc/apt/sources.list
log_success "软件源更换完成"

# 更新系统
log_info "更新系统软件包..."
container_retry "apt update -y && apt upgrade -y" "更新系统"
log_success "系统更新完成"

# 安装Docker依赖
log_info "安装Docker所需依赖..."
container_retry "apt install -y iptables iproute2 bridge-utils curl wget python3" "安装Docker依赖"
log_success "Docker依赖安装完成"

# 配置内核参数（适配Proot环境）
log_info "配置内核参数..."
cat >> /etc/sysctl.conf << EOF
kernel.unprivileged_userns_clone=1
net.ipv4.ip_forward=1
EOF
sysctl -p > /dev/null 2>&1 || true
log_success "内核参数配置完成"

# 配置账户
log_info "配置账户信息..."
echo "root:123" | chpasswd
log_success "Root账户密码设置为：123"

# 创建普通用户
if ! id "admin" &>/dev/null; then
    useradd -m -s /bin/bash admin
    echo "admin:123456" | chpasswd
    usermod -aG sudo,docker admin
    log_success "创建admin用户，密码：123456"
fi
log_success "账户配置完成"

# 安装Docker
log_info "安装Docker服务..."
container_retry "apt install -y docker.io" "安装Docker"
log_success "Docker安装完成"

# 停止并禁用systemd服务（Proot环境不支持）
systemctl stop docker 2>/dev/null || true
systemctl disable docker 2>/dev/null || true

# 配置Docker
log_info "配置Docker守护进程..."
mkdir -p /etc/docker
cat > /etc/docker/daemon.json << 'EOF'
{
    "storage-driver": "overlay2",
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "100m"
    }
}
EOF
log_success "Docker配置完成"

# Docker启动函数（Proot兼容版）
start_dockerd() {
    log_info "启动Docker守护进程..."
  
    # 清理可能残留的进程
    killall -9 dockerd 2>/dev/null || true
    sleep 2
  
    # 启动dockerd（不使用iptables和ip-masq，规避Proot网络限制）
    dockerd --iptables=false --ip-masq=false > /var/log/docker.log 2>&1 &
  
    # 等待启动
    local wait_count=0
    while [ $wait_count -lt 20 ]; do
        if docker info > /dev/null 2>&1; then
            log_success "Docker守护进程启动成功"
            chmod 666 /var/run/docker.sock 2>/dev/null || true
            return 0
        fi
        sleep 1
        wait_count=$((wait_count + 1))
    done
  
    log_error "Docker守护进程启动失败，查看日志：cat /var/log/docker.log"
    return 1
}

# 首次启动Docker
start_dockerd
if [ $? -ne 0 ]; then
    log_warn "首次启动失败，尝试重新启动..."
    sleep 5
    start_dockerd
fi

# 创建进程守护脚本
log_info "创建进程守护脚本..."
cat > /usr/local/bin/service-monitor.sh << 'MONITOR'
#!/bin/bash
# 服务监控脚本（自动重启异常服务）

LOG_FILE="/var/log/service-monitor.log"
DOCKER_RUNNING=false
BT_RUNNING=false

log() {
    echo "$(date '+%Y-%m-%d %H:%M:%S') - $1" >> "$LOG_FILE"
}

check_docker() {
    if ! docker info > /dev/null 2>&1; then
        log "Docker服务异常，自动重启..."
        dockerd --iptables=false --ip-masq=false > /var/log/docker.log 2>&1 &
        sleep 10
    fi
}

check_bt() {
    if ! command -v bt &>/dev/null; then
        return 0
    fi
    if ! bt default > /dev/null 2>&1; then
        log "宝塔服务异常，自动重启..."
        bt restart > /dev/null 2>&1 || true
    fi
}

while true; do
    check_docker
    check_bt
    sleep 30
done
MONITOR

chmod +x /usr/local/bin/service-monitor.sh

# 启动守护脚本
log_info "启动服务守护进程..."
nohup /usr/local/bin/service-monitor.sh > /dev/null 2>&1 &
log_success "服务守护进程已启动"

# 安装宝塔面板
log_info "========================================"
log_info " 安装宝塔面板"
log_info "========================================"

# 下载宝塔安装脚本
if [ ! -f "/tmp/bt_install.sh" ]; then
    log_info "下载宝塔安装脚本..."
    wget -O /tmp/bt_install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh -q
    chmod +x /tmp/bt_install.sh
fi

# 预处理安装脚本（禁用会导致问题的选项）
log_info "预处理安装脚本..."
sed -i 's/quick_install=1/quick_install=0/' /tmp/bt_install.sh
sed -i 's/compiler_install=0/compiler_install=1/' /tmp/bt_install.sh
log_success "安装脚本预处理完成"

# 执行安装
log_info "开始安装宝塔面板（这可能需要几分钟时间）..."
echo "y
" | bash /tmp/bt_install.sh 2>&1 | while read line; do
    echo -e "\033[34m[宝塔]\033[0m $line"
done

# 安装完成后验证
sleep 10
log_info "验证安装状态..."

# 获取IP地址
SERVER_IP=$(hostname -I | awk '{print $1}')

# 检查宝塔状态
if command -v bt &>/dev/null; then
    log_success "宝塔面板安装完成！"
    echo ""
    echo "========================================"
    echo -e "  ${GREEN}宝塔面板安装成功！${NC}"
    echo "========================================"
    echo -e "  访问地址：${YELLOW}http://${SERVER_IP}:8888${NC}"
    echo -e "  用户名：${YELLOW}root${NC}"
    echo -e "  密码：${YELLOW}123${NC}"
    echo ""
    echo -e "  ${GREEN}Docker服务：${NC}已安装并配置自动守护"
    echo -e "  ${GREEN}服务监控：${NC}每30秒检查一次，异常自动重启"
    echo "========================================"
    echo ""
    log_info "如需进入Ubuntu容器，请执行：proot-distro login ubuntu"
    log_info "查看Docker状态：proot-distro login ubuntu -c 'docker ps'"
    log_info "查看宝塔状态：proot-distro login ubuntu -c 'bt default'"
else
    log_error "宝塔面板安装可能失败，请手动检查"
fi

# 清理
log_info "清理安装文件..."
rm -f /tmp/bt_install.sh
apt autoremove -y > /dev/null 2>&1
apt clean > /dev/null 2>&1
log_success "清理完成"
UBUNTU_SCRIPT

# 复制脚本到容器并执行
proot-distro login ubuntu --shared-tmp /tmp:/tmp << 'EXEC_SCRIPT'
bash /tmp/ubuntu_setup.sh
EXEC_SCRIPT

# 清理临时脚本
rm -f /tmp/ubuntu_setup.sh

log_success "========================================"
log_success " 全部部署完成！"
log_success "========================================"
echo ""
echo "进入Ubuntu容器：proot-distro login ubuntu"
echo "查看Docker状态：proot-distro login ubuntu -c 'docker ps'"
echo "查看宝塔信息：proot-distro login ubuntu -c 'bt default'"
echo ""
echo "如有任何问题，请查看容器内日志："
echo "  Docker日志：cat /var/log/docker.log"
echo "  监控日志：cat /var/log/service-monitor.log"

2.2 使用方法

将上述脚本保存为deploy.sh​，然后执行：

复制代码 
# 方法一：直接粘贴运行
bash -c "$(curl -fsSL https://your-script-url/deploy.sh)"

# 方法二：下载脚本后运行
chmod +x deploy.sh
./deploy.sh

三、核心技术解析

3.1 Docker在Proot环境中的特殊处理

Proot容器与普通Linux容器最本质的区别在于缺乏systemd支持。这意味着所有依赖systemctl​命令的服务管理方式都将失效。我们的解决方案是直接使用dockerd​命令启动Docker守护进程。

具体实现中，我们添加了两个关键参数：

  • --iptables=false：禁用iptables管理，因为Proot环境的网络栈与主机Android系统深度耦合

  • --ip-masq=false：禁用IP伪装，避免与Android系统的网络冲突

    正确的启动方式

    dockerd --iptables=false --ip-masq=false > /var/log/docker.log 2>&1 &

3.2 全自动进程守护机制

进程意外退出是服务器运维中的常见问题，特别是在移动设备上。由于网络波动、系统休眠等原因，服务进程可能随时中断。我们的解决方案是实现一个轻量级守护进程，每30秒检查一次关键服务的运行状态。

守护脚本的核心逻辑非常简洁：

复制代码 
while true; do
    # 检查Docker
    if ! docker info > /dev/null 2>&1; then
        dockerd --iptables=false --ip-masq=false > /var/log/docker.log 2>&1 &
    fi
  
    # 检查宝塔
    if ! bt default > /dev/null 2>&1; then
        bt restart > /dev/null 2>&1 || true
    fi
  
    sleep 30
done

3.3 软件源智能切换

下载速度是影响安装体验的关键因素。脚本会自动检测并切换到国内镜像源：

  • Termux：切换为清华源（termux镜像站）

  • Ubuntu：切换为阿里云源

    Termux源切换

    sed -i 's|deb.*termux.net|deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main|' $PREFIX/etc/apt/sources.list

    Ubuntu源切换

    sed -i 's|archive.ubuntu.com|mirrors.aliyun.com|g' /etc/apt/sources.list

四、部署后的日常操作

4.1 进入Ubuntu容器

复制代码 
# 登录Ubuntu容器
proot-distro login ubuntu

# 以root身份登录
proot-distro login ubuntu --user root

# 执行单条命令
proot-distro login ubuntu -c "docker ps"
proot-distro login ubuntu -c "bt default"

4.2 常用管理命令

复制代码 
# Docker相关
docker ps                          # 查看运行中的容器
docker images                      # 查看本地镜像
docker pull nginx                  # 拉取镜像
docker run -d -p 80:80 nginx       # 运行容器

# 宝塔面板相关
bt                                  # 宝塔命令行菜单
bt default                          # 查看默认信息
bt restart                          # 重启宝塔
bt stop                             # 停止宝塔

4.3 端口与安全配置

默认开放的端口包括：

端口 用途 说明
8888 宝塔面板 面板访问端口
80 HTTP Web服务默认端口
443 HTTPS HTTPS服务端口
2375 Docker Docker API端口（不安全，仅限内网）

⚠️ 安全建议：生产环境中，2375端口非常危险，建议使用SSH隧道或配置TLS证书进行安全访问。

五、常见问题排查

5.1 Docker无法启动

如果Docker启动失败，首先检查日志：

复制代码 
proot-distro login ubuntu -c "cat /var/log/docker.log"

常见错误原因及解决方案：

  • 内核不支持overlay2：Proot环境可能存在兼容性问题，脚本已配置overlay2.override_kernel_check=true
  • 端口被占用：执行lsof -i :2375检查并关闭占用进程
  • 权限问题：确保执行chmod 666 /var/run/docker.sock

5.2 宝塔安装失败

宝塔安装过程中可能遇到网络超时或依赖问题。处理步骤：

  1. 检查网络连接
  2. 尝试重新执行安装脚本
  3. 查看安装日志获取详细错误信息

5.3 Termux闪退

部分设备在运行大型脚本时可能出现内存不足的情况。建议：

  • 关闭其他后台应用
  • 使用较高配置的设备（建议4GB以上内存）
  • 在SD卡上配置交换分区

六、性能优化建议

6.1 存储优化

复制代码 
# 清理Docker资源
proot-distro login ubuntu -c "docker system prune -af"

# 清理Ubuntu缓存
proot-distro login ubuntu -c "apt clean && apt autoremove -y"

6.2 内存优化

复制代码 
# 配置Docker使用更少的内存
# 在/etc/docker/daemon.json中添加：
{
    "storage-driver": "overlay2",
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "50m",
        "max-file": "3"
    },
    "default-ulimits": {
        "nofile": {
            "Name": "nofile",
            "Hard": 65536,
            "Soft": 65536
        }
    }
}

七、总结与展望

本文详细介绍了在Termux环境中部署宝塔面板和Docker的完整方案。通过这套脚本，你可以：

✅ 实现零手动操作的全自动部署

✅ 获得异常自动修复的容错能力

✅ 享受国内镜像源带来的高速下载体验

✅ 拥有进程自动守护的稳定运行环境

这套方案特别适合以下场景：

  • 嵌入式开发者的移动测试环境
  • 学习Linux服务器管理的入门平台
  • 轻量级Web服务的临时托管方案
  • 随时随地的开发演示环境

虽然移动设备的性能和网络环境存在一定限制，但这套方案已经过多款主流安卓设备测试，能够稳定运行常见的Web服务和容器化应用。

最后提醒：移动端服务器适合学习和测试用途，生产环境建议使用正规的云服务器。如果你觉得这篇文章对你有帮助，欢迎点赞、收藏、转发，你的支持是我持续分享的动力！

参考资源：

本文内容基于实际测试编写，如有问题欢迎评论区交流讨论。

相关推荐
小五传输1 分钟前
认准好用的跨网文件安全交换系统：安全传输与高效协作两全其美
大数据·运维·安全
Gofarlic_oms14 分钟前
从手动统计到自动化：企业AutoCAD许可管理进化史
大数据·运维·网络·人工智能·微服务·自动化
xiaoliuliu1234512 分钟前
xampp-linux-1.8.1.tar.gz 怎么安装？Linux下XAMPP离线安装完整步骤
linux·运维·服务器
叽里咕噜怪20 分钟前
Pod的详解与进阶
运维·容器·kubernetes
ONLYOFFICE28 分钟前
入门指南：远程运行 ONLYOFFICE 协作空间 MCP 服务器
运维·服务器·github·onlyoffice
行初心31 分钟前
uos基础 autostart 设置程序开机自启动
运维
Dovis(誓平步青云）35 分钟前
《Linux 核心 IO 模型深析（中篇）：探索Cmake与多路转接的高效实现poll》
linux·运维·服务器·数据库·csdn成长记录
韦东东39 分钟前
行业资讯日报自动化：从采集到 LLM 生成的全链路拆解（以政务网站为例）
运维·人工智能·自动化·大模型·llm·政务·行业资讯
tianyuanwo40 分钟前
TERM变量迷思：从Jenkins节点连接差异看终端仿真与构建系统的微妙关系
运维·ssh·jenkins·java web·term
热门推荐
01GitHub 镜像站点02安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）03Linux下V2Ray安装配置指南04Labelme从安装到标注：零基础完整指南05手把手教你通过Gemini3 pro 学生认证，白用一年，手慢无！06【踩坑笔记】50系显卡适配的 PyTorch 安装07jdk21下载、安装（Windows、Linux、macOS）08GitLab 零基础入门指南：从安装到项目管理全流程09Opencode CLI 安装成功,但是启动失败10UV安装并设置国内源