# WorkPod - 容器化开发环境

> 基于 Alpine 3.23 的轻量级开发容器，支持多项目隔离部署。

## 是什么

WorkPod 是一套 **Docker 容器化的全栈开发环境**，每个项目运行在独立容器中，通过 Web 终端（ttyd）或 SSH 访问。

## 核心特性

| 特性 | 说明 |
|------|------|
| 轻量镜像 | ~436MB（Alpine 多阶段构建） |
| 开箱即用 | Node.js 24 + Claude Code + ttyd + tmux |
| 工具外挂 | Rust/Go/Python 安装到 /root，自动检测 PATH |
| 项目隔离 | 每个项目独立容器、独立端口、独立网络 |
| 会话管理 | tmux session 支持 URL 参数 / 交互菜单 |

## 快速开始

```bash
# 1. 构建基础镜像
docker compose -f instances/base/docker-compose.yml build

# 2. 启动基础实例
docker compose -f instances/base/docker-compose.yml up -d

# 3. 打开 Web 终端
# http://localhost:7681 (用户: jc, 密码: 1234567)

# 或 SSH 连接
# ssh root@localhost -p 2222 (密码: workpod123)
```

## 目录结构

```
workpod/
├── Dockerfile              # 基础镜像构建
├── entrypoint.sh           # 统一入口脚本
├── ttyd-session.sh         # tmux 会话管理
├── instances/              # ★ 实例配置（每个项目一个目录）
│   ├── registry.yaml       #   全局实例注册表
│   ├── base/               #   基础实例
│   ├── flux/               #   Flux 项目实例
│   └── .template/          #   新建实例模板
├── docs/                   # 文档体系
└── data/                   # 运行时数据
```

## 文档索引

| 文档 | 位置 | 说明 |
|------|------|------|
| 实例管理指南 | `instances/README.md` | 端口规则、新建流程 |
| 实例注册表 | `instances/registry.yaml` | 所有实例的端口/状态 |
| 端口分配规则 | `docs/00-规范/端口分配规则.md` | 详细端口规划 |
| 实例创建流程 | `docs/00-规范/实例创建流程.md` | 步骤教程 |
| 架构设计 | `docs/01-架构/` | C4 图 + 组件关系 |
| 问题记录 | `docs/02-技术文档/ISSUES.md` | 历史问题与解决方案 |
| 部署指南 | `docs/03-运维/` | 本机 + 测试服部署 |
| 测试服实例 | `docs/03-运维/测试服实例.md` | 远程实例配置 |
| 审核报告 | `docs/04-审核/` | 安全/架构/Docker/Shell 审核 |

## 相关链接

- 基础镜像：`workpod-alpine:latest`（基于 alpine:3.23）
- AI 工具：Claude Code (@anthropic-ai/claude-code)
- Web 终端：ttyd (Alpine apk)
- 会话管理：tmux + ttyd-session.sh