wsl_install_alpine

安装配置 WSL2 Alpine Linux 系统

补充说明

该教程提供从零开始完整安装配置 WSL2 Alpine Linux 系统的详细流程，涵盖环境准备、系统安装、基础配置、软件部署以及容器环境搭建，适合在 Windows 上使用轻量级 Alpine 子系统的场景。

Alpine Linux 以其极致轻量（基础镜像仅 5MB）、安全高效著称，特别适合快速启动、资源受限或容器化开发环境。

功能特点

• 完整流程：从环境检查到开发环境的完整步骤
• 轻量高效：Alpine 基础镜像极小，启动速度极快
• 常见问题：包含 WSL 常用命令和故障排查
• 优化配置：包含镜像加速、apk 包管理建议
• 多系统支持：适用于 Windows 10 2004+ 和 Windows 11

主要章节

注意事项

• 需要 Windows 10 2004 及以上版本或 Windows 11
• 需要在 BIOS 中启用虚拟化（Intel VT-x 或 AMD-V）
• 安装过程需要管理员权限
• Alpine 使用 apk 包管理器，非 apt/yum

环境准备

由于 Alpine Linux 不在 wsl --list -o 官方列表中，需采用手动下载导入的方式。

检查 Windows 版本

WSL2 需要 Windows 10 2004 及以上版本，或 Windows 11。

在 PowerShell 中执行：

winver

若版本低于要求，请先升级系统。

确认虚拟化已启用

以管理员身份打开 PowerShell，检测虚拟化功能状态：

systeminfo

在输出信息中查找以下字段：

Hyper-V 要求:                  是
虚拟机监控程序状态:              是

若显示"否"，需要在 BIOS/UEFI 中启用 Intel VT-x 或 AMD-V。

启用 WSL 和虚拟机平台

以管理员身份打开 PowerShell，执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启电脑

shutdown /r /f /t 0

安装 WSL2 内核更新包（首次使用需执行）

重启后下载并安装 WSL2 Linux 内核更新包：

curl.exe -L -o wsl_update_x64.msi https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
wsl_update_x64.msi

设置 WSL2 为默认版本

wsl --set-default-version 2

安装 Alpine

下载 Alpine WSL 包

以管理员身份打开 PowerShell，下载 Alpine 的 WSL 发行版包：

# 下载 Alpine WSL 包
Invoke-WebRequest -Uri "https://dl-cdn.alpinelinux.org/alpine/v3.20/releases/x86_64/alpine-minirootfs-3.20.3-x86_64.tar.gz" -OutFile "$env:TEMP\alpine.tar.gz"

创建 Alpine 目录并导入

# 创建存放 Alpine 的目录
mkdir C:\Users\Administrator\wsl\alpine

# 导入 Alpine
wsl --import alpine C:\Users\Administrator\wsl\alpine "$env:TEMP\alpine.tar.gz" --version 2

alpine 是实例名称，可自定义

查看安装结果

wsl -l -v

输出示例：

  NAME      STATE           VERSION
* alpine   Running         2

启动 Alpine

wsl.exe -d alpine

基础配置

更新 apk 并安装基础工具

首次进入系统后：

# 更新软件包索引
apk update

# 升级已安装的软件包
apk upgrade

# 安装基础工具
apk add curl wget git vim nano bash-completion sudo shadow

配置镜像加速（可选）

使用国内镜像源加速：

# 编辑 /etc/apk/repositories
sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories

# 更新索引
apk update

配置 shell 为 bash

Alpine 默认使用 ash，建议切换为 bash：

# 查看 bash 路径
which bash

# 切换默认 shell
chsh -s /bin/bash

# 退出重新进入即可生效
exit

配置时区

# 安装时区数据
apk add tzdata

# 设置为上海时区
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
echo "Asia/Shanghai" > /etc/timezone

# 验证
date

用户与权限配置

创建普通用户

# 创建用户（将 demo 替换为实际用户名）
adduser demo

# 设置密码（按提示输入）

添加到 sudo 组

Alpine 默认 sudo 配置需要 wheel 组：

# 将用户添加到 wheel 组
adduser demo wheel

# 编辑 sudo 配置
sed -i '/^# %wheel ALL=(ALL) ALL/s/^# //' /etc/sudoers

# 验证
su - demo
sudo whoami

输出 root 表示配置成功。

包管理常用命令

安装常用开发工具

# Node.js
apk add nodejs npm

# Python
apk add python3 py3-pip

# Go
apk add go

# Docker CLI（仅客户端）
apk add docker-cli docker-cli-compose

网络与文件访问

从 Windows 访问 Alpine 文件

在 PowerShell 中：

# 进入 Alpine 主目录
cd \\wsl$\alpine\root

# 查看根目录文件
dir \\wsl$\alpine

从 Alpine 访问 Windows 文件

ls /mnt/c
ls /mnt/d

常见问题

Alpine 不在 wsl -l -o 列表中

Alpine 非官方预装发行版，需手动下载 tar.gz 包并 wsl --import 导入。

apk 安装速度慢

换用国内镜像源：

sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories
apk update

无 systemd

Alpine 使用 OpenRC 替代 systemd，服务管理命令不同：

# 查看服务状态
rc-status

# 启动服务
rc-service <service> start

# 设置开机自启
rc-update add <service>

忘记 root 密码

在 PowerShell 中重置：

wsl -d alpine -u root passwd

验证安装结果

# 系统信息
cat /etc/os-release
uname -a

# 网络连通性
ping -c 3 google.com

# 包管理器状态
apk info | wc -l

# 磁盘使用情况
df -h

参考链接

• Alpine Linux 官方
• Alpine WSL 导入指南
• WSL 官方文档

相关命令

• wsl
• wsl_install_alpine 👈 当前所在位置