# WorkPod Alpine

轻量级 Docker 开发环境容器 — 基于 Alpine Linux 3.23，镜像仅 ~436MB。

## 核心特性

| 特性 | 说明 |
|------|------|
| **镜像大小** | ~436MB（Ubuntu 版的 1/6） |
| **基础镜像** | alpine:3.23 (~7MB) |
| **运行时内存** | 80-120MB 基线 + 应用 |
| **启动时间** | ~2.5 秒 |
| **Web 终端** | ttyd + tmux 会话管理 |
| **AI 工具** | Claude Code + coding-helper |

## 快速开始

```bash
# 构建基础镜像
docker build -t workpod-alpine:latest .

# 启动基础实例
docker compose up -d

# 访问
# Web:  http://localhost:7681       (用户 jc / 密码 1234567)
# SSH:  ssh root@localhost -p 2222  (密码 workpod123)
```

## 项目实例部署

```bash
# Flux 项目（含 JDK/Maven 挂载）
docker compose -f docker-compose.flux.yml up -d

# 备用编排
docker compose -f docker-compose-alpine.yml up -d
```

## 端口规划

| 实例 | SSH | Web 终端 | 用途 |
|------|-----|---------|------|
| workpod-alpine (基础) | 2222 | 7681 | 通用开发 |
| ws-flux-dev | 2201 | 7701 | Flux 项目 |

## 目录结构

```
workpod/
├── Dockerfile              # 基础镜像（多阶段构建）
├── Dockerfile.flux         # Flux 扩展镜像
├── entrypoint.sh           # 容器入口（PATH 自检 + 服务启动）
├── ttyd-session.sh         # tmux 会话管理
├── auth-proxy.js           # 认证代理（可选）
├── download-packages.sh    # 离线包下载
├── docker-compose*.yml     # 编排文件
├── dev-envs/               # 开发环境配置模板
├── instances/              # 实例编排（模板化部署）
├── config/                 # 配置文件
├── docs/                   # 文档
└── SPECS.md                # 技术规格（完整版）
```

## 技术规格

详见 [SPECS.md](./SPECS.md)