# docker-node-canvas-test

**Repository Path**: Tianyu201809/docker-node-canvas-test

## Basic Information

- **Project Name**: docker-node-canvas-test
- **Description**: node-canvas环境
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docker Node Canvas 项目

基于 Koa 的 Node.js 项目，支持 node-canvas 和 PixiJS，可使用 Docker 部署。

## 功能特性

- ✅ Koa 框架
- ✅ node-canvas 支持（服务端 Canvas 渲染）
- ✅ PixiJS 支持（客户端图形渲染）
- ✅ Docker 容器化部署

## 快速开始

### 本地开发

1. 安装依赖：
```bash
npm install
```

2. 启动开发服务器：
```bash
npm run dev
```

3. 访问应用：
- 健康检查：http://localhost:3000/health
- Canvas 示例：http://localhost:3000/canvas
- PixiJS 示例：http://localhost:3000/pixi

### Docker 部署

#### 方式一：使用 Docker Compose（推荐）

```bash
docker-compose up -d
```

#### 方式二：使用 Docker 命令

1. 构建镜像：
```bash
docker build -t docker-node-canvas .
```

2. 运行容器：
```bash
docker run -d -p 3000:3000 --name docker-node-canvas docker-node-canvas
```

## API 端点

- `GET /health` - 健康检查
- `GET /canvas` - node-canvas 示例（返回 PNG 图片）
- `GET /pixi` - PixiJS 示例（返回 HTML 页面）
- `POST /api/generate-image` - 使用 node-canvas 生成自定义图片
  - 请求体：`{ "text": "Hello", "width": 400, "height": 300 }`
  - 返回：PNG 图片

## 技术栈

- **Koa** - Web 框架
- **node-canvas** - 服务端 Canvas API
- **PixiJS** - 2D WebGL 渲染引擎
- **Docker** - 容器化部署

## 注意事项

- node-canvas 需要系统级依赖（Cairo、Pango 等），Dockerfile 中已包含
- 确保 Docker 镜像有足够的权限访问系统库
- 生产环境建议使用环境变量配置端口等参数