circlepos/ruby

本地使用Docker镜像文档

镜像概述和主要用途

本Docker镜像专为本地环境设计，旨在简化本地开发、测试或个人项目的部署流程。无需复杂的服务器配置，即可快速搭建稳定的本地运行环境，适合个人开发者、学生或小型团队使用，满足本地场景下的应用运行需求。

核心功能和特性

• 轻量级设计：镜像体积优化，适合本地设备资源有限的环境，减少对本地系统资源的占用。
• 易于配置：简化的启动和配置流程，降低本地环境搭建门槛，无需深入掌握Docker复杂配置。
• 快速部署：一键启动，缩短本地环境准备时间，支持快速验证应用功能或测试场景。
• 兼容性良好：适配常见本地操作系统（Windows、macOS、Linux）及Docker Desktop环境。

使用场景和适用范围

• 本地开发环境：快速搭建与生产环境一致的本地开发环境，避免"本地能跑，线上报错"问题。
• 个人项目测试：验证个人项目功能、调试代码或演示效果，无需部署至远程服务器。
• 学习与实验：作为Docker学习工具，了解容器化部署流程，或用于临时运行学习用应用。
• 轻量应用运行：运行小型Web应用、工具类服务等轻量级应用，满足个人日常使用需求。

使用方法和配置说明

基本使用方法

通过docker run命令即可快速启动本地容器：

bash
docker run -d --name local-usage-app [镜像名称]:[标签]

参数说明

• -d：后台运行容器
• --name local-usage-app：指定容器名称（可自定义）
• [镜像名称]:[标签]：替换为实际的镜像名称和版本标签

端口映射（如需对外提供服务）

若应用需要本地访问，可通过-p参数映射端口：

bash
docker run -d -p 8080:80 --name local-usage-app [镜像名称]:[标签]

• 8080:80：将容器内80端口映射到本地8080端口，本地可通过http://localhost:8080访问

数据持久化（如需保存本地数据）

通过-v参数挂载本地目录，实现数据持久化：

bash
docker run -d -v /本地目录路径:/容器内目录路径 --name local-usage-app [镜像名称]:[标签]

• /本地目录路径：本地需持久化的目录（如~/local-data）
• /容器内目录路径：容器内数据存储路径（需根据镜像实际定义填写）

环境变量配置

可通过-e参数设置环境变量，调整应用行为（具体支持的环境变量需参考镜像详细说明）：

bash
docker run -d -e LOG_LEVEL=info -e PORT=80 --name local-usage-app [镜像名称]:[标签]

• LOG_LEVEL：日志级别（如debug、info、warn，默认info）
• PORT：应用运行端口（默认根据镜像配置，如80）

注意事项

1. 确保本地已安装Docker Desktop（Windows/macOS）或Docker Engine（Linux）
2. 首次使用需拉取镜像：docker pull docker.xuanyuan.run/[镜像名称]:[标签]
3. 本地资源有限时，建议限制容器资源使用（如--memory=2g --cpus=1）
4. 停止容器：docker stop local-usage-app；删除容器：docker rm local-usage-app