updotofficial/karma-web

Karam主网站Docker镜像（NextJS应用）

镜像概述

本Docker镜像用于部署和运行Karam主网站，基于NextJS框架构建的Web应用。通过Docker容器化封装，简化了Karam官方网站的部署流程，确保跨环境一致性和快速启动能力，适用于开发、测试及生产环境。

核心功能与特性

基于NextJS框架

• 支持服务端渲染（SSR）和静态站点生成（SSG），提升页面加载速度和SEO表现
• 内置API路由功能，可直接处理后端请求
• 自动代码分割、图像优化及性能优化，优化用户体验

Docker化优势

• 环境隔离：与主机系统解耦，避免依赖冲突
• 跨平台部署：支持在任何安装Docker的环境中运行（Linux、Windows、macOS）
• 版本控制：通过镜像标签管理不同版本，便于回滚和升级

内置优化

• 预配置的生产环境构建，包含代码压缩和资源优化
• 支持自定义环境变量，灵活适配不同部署场景

使用场景

• 生产环境部署：Karam官方网站的正式线上环境运行
• 开发环境快速搭建：开发者无需手动配置Node.js、NextJS等依赖，直接通过容器启动开发环境
• CI/CD流程集成：作为自动化部署流程的一部分，实现构建、测试、部署的全流程容器化
• 多环境一致性维护：确保开发、测试、生产环境的配置和依赖一致，减少"在我电脑上能运行"问题

使用方法

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 网络连接正常（用于拉取镜像）

基本使用（Docker Run）

通过以下命令快速启动容器：

bash
docker run -d \
  --name karam-website \
  -p 3000:3000 \
  karam/main-website:latest

参数说明：

• -d：后台运行容器
• --name karam-website：指定容器名称为karam-website
• -p 3000:3000：端口映射（主机端口:容器端口，默认容器内使用3000端口）
• karam/main-website:latest：镜像名称及标签（latest为最新稳定版）

自定义配置（环境变量）

可通过环境变量调整应用配置，常用变量如下：

示例（带环境变量的启动命令）：

bash
docker run -d \
  --name karam-website \
  -p 80:3000 \
  -e NODE_ENV=production \
  -e PORT=3000 \
  -e API_URL=https://api.karam-example.com \
  karam/main-website:latest

Docker Compose配置

推荐使用docker-compose.yml管理多容器应用或复杂配置，示例配置：

yaml
version: '3.8'

services:
  karam-website:
    image: karam/main-website:latest
    container_name: karam-website
    restart: always  # 容器退出时自动重启
    ports:
      - "80:3000"  # 映射主机80端口到容器3000端口
    environment:
      - NODE_ENV=production
      - API_URL=https://api.karam.com
      - NEXT_PUBLIC_SITE_URL=https://karam.com
    volumes:
      - ./logs:/app/logs  # 可选：挂载日志目录到主机（若应用配置了日志输出）
    networks:
      - karam-network  # 可选：加入自定义网络，与其他服务（如数据库）通信

networks:
  karam-network:
    driver: bridge

启动命令：

bash
docker-compose up -d

停止与更新

• 停止容器：docker stop karam-website
• 删除容器：docker rm karam-website
• 更新镜像：

  bash
  docker pull karam/main-website:latest  # 拉取最新镜像
  docker restart karam-website  # 重启容器使新镜像生效（需先停止旧容器）