第一篇：宝塔面板教程

宝塔面板 WSL2 环境完全安装与升级指南

专为 Windows WSL2 Ubuntu 用户打造，解决网络问题，手把手教你安装、配置、升级宝塔面板

📌 前言

宝塔面板是 Linux 服务器上最流行的服务器管理面板之一，但在 WSL2（Windows Subsystem for Linux）环境中安装和升级时，经常会遇到网络连接超时的问题。本文将为你提供一套完整的解决方案，包括离线安装、镜像加速、常见问题处理等。

适用环境：Windows 10/11 + WSL2 + Ubuntu 22.04/24.04

一、WSL2 环境准备

1.1 安装 WSL2（如未安装）

在 Windows PowerShell（管理员）中执行：

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 重启电脑后执行
wsl --set-default-version 2

1.2 安装 Ubuntu 22.04

# 在 PowerShell 中执行
wsl --install -d Ubuntu-22.04

二、宝塔面板全新安装

2.1 更新系统

sudo apt update && sudo apt upgrade -y

2.2 使用国内镜像安装（推荐）

由于官方节点在 WSL2 环境下容易超时，建议使用阿里云镜像：

# 下载安装脚本
curl -sSO https://mirrors.aliyun.com/bt/install/install_panel.sh

# 执行安装
bash install_panel.sh

安装过程中会提示：

• 确认安装位置（默认 /www）
• 是否安装推荐软件（建议选择 yes）

2.3 安装完成后获取面板信息

# 查看面板登录信息
bt 14

输出示例：

外网面板地址: http://服务器IP:8888/xxxxx
内网面板地址: http://172.21.xxx.xxx:8888/xxxxx
username: xxxxxx
password: xxxxxx

2.4 访问面板

在 Windows 浏览器中访问内网地址（如 http://172.21.xxx.xxx:8888/xxxxx）

三、常见安装问题解决

问题1：curl 下载超时

错误信息：curl: (28) Connection timed out

解决方案：使用备用节点

# 使用移动节点
curl -sSO https://cmcc1-node.bt.cn/install/install_panel.sh
bash install_panel.sh

# 或使用阿里云镜像
curl -sSO https://mirrors.aliyun.com/bt/install/install_panel.sh
bash install_panel.sh

问题2：无法访问面板

解决方案：使用 WSL 内网 IP 访问

# 获取 WSL IP 地址
ip addr show eth0 | grep -oP '(?<=inet\s)\d+(\.\d+){3}'

# 使用该 IP + 端口访问
http://172.21.xxx.xxx:8888/xxxxx

四、宝塔面板离线升级

4.1 下载离线升级包

# 使用阿里云镜像下载
wget -O LinuxPanel-11.6.0.zip https://mirrors.aliyun.com/bt/install/update/LinuxPanel-11.6.0.zip

4.2 执行升级

# 停止面板
bt 2

# 解压升级包
cd /root
unzip -o LinuxPanel-*.zip

# 执行升级
cd panel
bash update.sh

# 重启面板
bt 1

# 查看升级结果
bt 14

4.3 一键升级命令

bt 2 && cd /root && unzip -o LinuxPanel-*.zip && cd panel && bash update.sh && bt 1 && bt 14

五、宝塔服务开机自启配置

5.1 创建自启脚本

sudo tee /etc/profile.d/bt-services.sh << 'EOF'
#!/bin/bash
# 宝塔服务开机自启
sleep 5
/etc/init.d/nginx start 2>/dev/null
/etc/init.d/mysqld start 2>/dev/null
# 根据你的 PHP 版本修改下面的数字
/etc/init.d/php-fpm-74 start 2>/dev/null
EOF

sudo chmod +x /etc/profile.d/bt-services.sh

5.2 查看已安装的 PHP 版本

ls /etc/init.d/ | grep php

根据输出修改脚本中的版本号（如 php-fpm-80、php-fpm-81）

六、宝塔面板常用命令

七、注意事项

1. WSL2 网络问题：建议使用内网 IP 访问面板，而非 localhost
2. 防火墙管理：WSL2 环境中宝塔面板的防火墙功能可能无法正常使用，建议直接使用 iptables 命令管理端口
3. 数据备份：升级前建议备份面板数据（/www/server/panel/data 和 /www/server/panel/config）
4. PHP 版本：安装软件时选择合适的 PHP 版本，建议使用 PHP 7.4 或 8.x

第二篇：Docker 教程

Docker WSL2 环境完全配置指南

从安装到加速，手把手教你配置国内可用的 Docker 环境

📌 前言

Docker 是当今最流行的容器化技术，但在国内网络环境下，Docker Hub 的访问速度极慢，甚至经常超时。本文将教你如何在 WSL2 Ubuntu 环境中完整安装 Docker，并配置镜像加速器，让拉取镜像变得飞快。

适用环境：Windows 10/11 + WSL2 + Ubuntu 22.04/24.04

一、Docker 安装

1.1 卸载旧版本（如有）

sudo apt-get remove -y docker docker-engine docker.io containerd runc
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

1.2 使用官方脚本安装（推荐）

# 下载安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh

# 执行安装
sudo sh get-docker.sh

1.3 配置用户权限（避免每次使用 sudo）

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER

# 退出并重新登录使权限生效
exit

重新进入 WSL 后验证：

docker --version

1.4 启动 Docker 服务

sudo service docker start

1.5 设置开机自启

# 添加到 .bashrc
echo 'sudo service docker start' >> ~/.bashrc

二、配置 Docker 镜像加速器

2.1 为什么需要镜像加速？

Docker Hub 位于国外，国内直接拉取镜像速度极慢（几 KB/s）或经常超时。配置国内镜像加速器后，速度可达几 MB/s 甚至几十 MB/s。

2.2 可用的公共镜像加速地址

2.3 配置镜像加速器

# 创建 Docker 配置目录
sudo mkdir -p /etc/docker

# 写入配置（使用多个镜像源，自动切换）
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF

# 重启 Docker 服务
sudo service docker restart

# 验证配置是否生效
docker info | grep -A 5 "Registry Mirrors"

2.4 配置阿里云专属加速器（推荐，更稳定）

1. 注册/登录阿里云（免费）：https://www.aliyun.com
2. 搜索"容器镜像服务" → 进入控制台
3. 左侧菜单点击"镜像加速器"
4. 复制你的专属加速地址（格式：https://xxxxx.mirror.aliyuncs.com）

# 配置阿里云专属加速器
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://你的ID.mirror.aliyuncs.com"]
}
EOF

sudo service docker restart

三、Docker 常用命令

3.1 镜像管理

3.2 容器管理

3.3 容器运行示例

# 运行 hello-world 测试
docker run hello-world

# 运行 nginx 并映射端口
docker run -d -p 80:80 --name my-nginx nginx:alpine

# 运行 Ubuntu 交互式容器
docker run -it ubuntu bash

四、docker-compose 使用

4.1 安装 docker-compose

Docker 安装后已自带 docker-compose-plugin，使用 docker compose 命令。

4.2 创建 docker-compose.yml 示例

version: '3'
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    restart: unless-stopped
  
  redis:
    image: redis:alpine
    ports:
      - "6379:6379"
    restart: unless-stopped

4.3 docker-compose 常用命令

五、常见问题解决

问题1：Cannot connect to Docker daemon

错误信息：Cannot connect to the Docker daemon at unix:///var/run/docker.sock

解决方案：

# 启动 Docker 服务
sudo service docker start

# 如果启动失败，手动启动
sudo dockerd > /dev/null 2>&1 &

问题2：dial tcp: i/o timeout（拉取镜像超时）

解决方案：

1. 检查镜像加速器配置是否正确

2. 测试网络连通性：

   curl -I https://docker.1ms.run

3. 重启 Docker：

   sudo service docker restart

问题3：permission denied（权限不足）

解决方案：

# 添加用户到 docker 组
sudo usermod -aG docker $USER

# 退出重新登录
exit

问题4：WSL2 中 Docker 服务重启后丢失

解决方案：配置开机自启

echo 'sudo service docker start' >> ~/.bashrc

六、实战：部署 yesplaymusic 音乐播放器

# 1. 拉取镜像
docker pull fogforest/yesplaymusic:latest

# 2. 运行容器（端口 14529）
docker run -d \
  --name yesplaymusic \
  -p 14529:14529 \
  --restart unless-stopped \
  fogforest/yesplaymusic:latest

# 3. 查看运行状态
docker ps

# 4. 访问服务
# 浏览器打开：http://localhost:14529

七、Docker 加速器配置对比

推荐配置：阿里云专属 + 1-2 个公共镜像源作为备用

八、总结

本文详细介绍了在 WSL2 Ubuntu 环境中：

• Docker 的完整安装流程
• 镜像加速器的配置方法
• 常用命令和实战案例

配置完成后，你的 Docker 拉取速度将大幅提升，从几 KB/s 提升到几十 MB/s，彻底告别超时问题。

📌 更多教程请关注我的博客

如有问题，欢迎在评论区留言交流！