# alpine

**Repository Path**: zhReimu/alpine

## Basic Information

- **Project Name**: alpine
- **Description**: alpine 的 wsl 导出的 tar.gz 包优化工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Alpine-WSL

基于 Alpine 官方 rootfs 打造的一键式 WSL Alpine 镜像构建工具。

## 项目简介

本项目旨在提供一个简易、开箱即用的 Alpine WSL 镜像构建方案。通过自动化下载官方 rootfs、注入初始化脚本并重新打包，简化了在 WSL 中使用 Alpine Linux 的流程。项目完全使用 Windows 自带的 `tar` 命令处理压缩包，无需额外依赖 7-Zip 等第三方工具。

## 项目结构

```text
alpine-wsl/
├── x-init.sh          # 初始化脚本
├── xmake.lua          # 构建配置
├── mirrors.txt        # alpine 的镜像仓库地址
├── .gitignore         # Git 忽略配置
└── LICENSE            # 项目许可证
```

## 环境要求

- Windows 10/11 (开启 WSL 功能)
- Windows 10/11 自带的 `tar` 命令 (bsdtar)
- [xmake](https://xmake.io/#/zh-cn/guide/installation) (用于构建和安装流程)

## 使用方法

使用 `xmake` 进行一键构建和安装：

```bash
# 1. 下载并构建 rootfs (默认版本)
xmake

# (可选) 指定 Alpine 版本进行构建
xmake f --alpine_version=3.24.1
xmake

# 2. 安装到 WSL
xmake install
```

安装完成后，进入 WSL 执行 `x-init`，等待执行完毕后退出 wsl。
随后重启子系统 `wsl --shutdown`，重新进入子系统即可正常使用。

### 其他常用命令

```bash
xmake uninstall   # 卸载 WSL 中的 alpine 实例
xmake export      # 导出当前 alpine 实例为 tar.gz 镜像
xmake clean       # 清理构建产生的 dist 目录
```

## Alpine APK 镜像配置

在执行 `setup-alpine` 时，可以将仓库镜像设置为国内源（如清华源）以提升下载速度。

通过设置环境变量指向本项目提供的 `mirrors.txt` 即可自动配置：

```bash
export MIRRORS_URL=https://gitee.com/zhReimu/alpine/raw/master/mirrors.txt
```

配置完成后，即可正常执行 `setup-alpine` 命令进行系统初始化。

## 许可证

本项目基于相关许可证发布，请查看 [LICENSE](LICENSE) 文件了解详情。